geowallet
  1. Business to Person (B2P)
geowallet
  • Overview
  • Authentication
  • APIs
    • Ledger Balance
      • Get Balance of all ledgers
      • Get Balance for a single currency
    • Create a Quotation
      • quotations
    • Create a Transaction
      • Transaction
    • Transaction Query
      • Transaction Query
    • Transaction Status Webhook
  • Business Transaction API
    • Business to Business (B2B)
      • Transaction
    • Business to Person (B2P)
      • Transaction
        POST
    • B2P to mobile wallet
      • Transaction
    • Person to Business (P2B)
      • Transaction
    • Request parameter list
  • Response Codes & Messages
    • Generic Response
    • Beneficiary Validation Responses
    • Quote Response
    • Remit Response
  • Purpose, Source of Funds, and Relationship
    • P2P Purpose for Transaction
    • P2P Source of Funds
    • P2P Relationship
    • Person to Business
    • Business to Person
    • Business to Business
  • Country Specific Parameters list
  • Country Specific Recipient Documents
  • GeoSwift Verify (GSV)
  • About Us
  1. Business to Person (B2P)

Transaction

Developing
POST
/api/v1/transactions

Request

Body Params application/jsonRequired

Example
{
    "currency": "NGN",
    "type": "b2p",
    "requestDate": "2026-03-02T18:25:45.000Z",
    "amount": "87500.00",
    "descriptionText": "Reimbursement for client meeting travel expenses",
    "transactionReference": "GSWIFT_B2P_US_NG_260302182545",
    "sendingAmount": "95.20",
    "payinCcyCode": "USD",
    "provider": "23490",
    "paymentMode": "Bank account",
    "authenticationPartnerCode": "AUTH88201",
    "paymentOption": "Account Credit",
    "sendingPartnerCode": "SP20260302US_CORP",
    "receivingPartnerCode": "RP20260302NG_RETAIL",
    "debitParty": [
        {
            "key": "msisdn",
            "value": "+12125557890"
        }
    ],
    "creditParty": [
        {
            "key": "bankaccountno",
            "value": "0012345678"
        },
        {
            "key": "sortcode",
            "value": "FBNINGLA"
        },
        {
            "key": "organisationid",
            "value": "First Bank of Nigeria"
        },
        {
            "key": "banksubcode",
            "value": "011"
        },
        {
            "key": "bankBranchName",
            "value": "Ikeja Branch"
        },
        {
            "key": "accountName",
            "value": "Adebayo Chukwuma"
        },
        {
            "key": "accountIBAN",
            "value": ""
        },
        {
            "key": "accountAdditionalNo1",
            "value": "FBN/NG/0012345678/LAGOS"
        }
    ],
    "senderKyc": {},
    "recipientKyc": {
        "primaryContactCountryCode": "NG",
        "primaryContactNo": "2348034567890",
        "primaryContactNoType": "personal",
        "emailAddress": "adebayo.chukwuma@example.com",
        "subjectName": {
            "firstName": "Adebayo",
            "lastName": "Chukwuma",
            "fullName": "Adebayo Chukwuma"
        }
    },
    "internationalTransferInformation": {
        "quoteId": "GSQT260302182545USB2P",
        "receivingCountry": "NG",
        "remittancePurpose": "Business Travel",
        "sourceOfFunds": "Business Income",
        "relationshipSender": "Employer"
    },
    "business": {
        "senderKyc": {
            "businessName": "Nexa Global Consulting LLC",
            "businessAddress1": "350 Fifth Avenue, Floor 42",
            "businessAddressCity": "New York",
            "businessAddressCountryCode": "US",
            "businessPrimaryContactCountryCode": "US",
            "businessPrimaryContactNo": "12125557890",
            "businessDescription": "Management & Strategy Consulting",
            "businessCountryCode": "US",
            "businessRegistrationType": "LLC",
            "businessRegistrationNumber": "NYC-LLC-987654321",
            "businessRegistrationIssueDate": "2019-08-15",
            "businessIDValidThru": "2039-08-15"
        },
        "recepientKyc": {}
    }
}

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'http://prod-cn.your-api-server.com/api/v1/transactions' \
--header 'Content-Type: application/json' \
--data-raw '{
    "currency": "NGN",
    "type": "b2p",
    "requestDate": "2026-03-02T18:25:45.000Z",
    "amount": "87500.00",
    "descriptionText": "Reimbursement for client meeting travel expenses",
    "transactionReference": "GSWIFT_B2P_US_NG_260302182545",
    "sendingAmount": "95.20",
    "payinCcyCode": "USD",
    "provider": "23490",
    "paymentMode": "Bank account",
    "authenticationPartnerCode": "AUTH88201",
    "paymentOption": "Account Credit",
    "sendingPartnerCode": "SP20260302US_CORP",
    "receivingPartnerCode": "RP20260302NG_RETAIL",
    "debitParty": [
        {
            "key": "msisdn",
            "value": "+12125557890"
        }
    ],
    "creditParty": [
        {
            "key": "bankaccountno",
            "value": "0012345678"
        },
        {
            "key": "sortcode",
            "value": "FBNINGLA"
        },
        {
            "key": "organisationid",
            "value": "First Bank of Nigeria"
        },
        {
            "key": "banksubcode",
            "value": "011"
        },
        {
            "key": "bankBranchName",
            "value": "Ikeja Branch"
        },
        {
            "key": "accountName",
            "value": "Adebayo Chukwuma"
        },
        {
            "key": "accountIBAN",
            "value": ""
        },
        {
            "key": "accountAdditionalNo1",
            "value": "FBN/NG/0012345678/LAGOS"
        }
    ],
    "senderKyc": {},
    "recipientKyc": {
        "primaryContactCountryCode": "NG",
        "primaryContactNo": "2348034567890",
        "primaryContactNoType": "personal",
        "emailAddress": "adebayo.chukwuma@example.com",
        "subjectName": {
            "firstName": "Adebayo",
            "lastName": "Chukwuma",
            "fullName": "Adebayo Chukwuma"
        }
    },
    "internationalTransferInformation": {
        "quoteId": "GSQT260302182545USB2P",
        "receivingCountry": "NG",
        "remittancePurpose": "Business Travel",
        "sourceOfFunds": "Business Income",
        "relationshipSender": "Employer"
    },
    "business": {
        "senderKyc": {
            "businessName": "Nexa Global Consulting LLC",
            "businessAddress1": "350 Fifth Avenue, Floor 42",
            "businessAddressCity": "New York",
            "businessAddressCountryCode": "US",
            "businessPrimaryContactCountryCode": "US",
            "businessPrimaryContactNo": "12125557890",
            "businessDescription": "Management & Strategy Consulting",
            "businessCountryCode": "US",
            "businessRegistrationType": "LLC",
            "businessRegistrationNumber": "NYC-LLC-987654321",
            "businessRegistrationIssueDate": "2019-08-15",
            "businessIDValidThru": "2039-08-15"
        },
        "recepientKyc": {}
    }
}'

Responses

🟢200Success
application/json
Body

Example
{}
Modified at 2026-03-12 10:41:51
Previous
Transaction
Next
B2P to mobile wallet
Built with