geowallet
  1. Transaction Query
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
        GET
    • Transaction Status Webhook
  • Business Transaction API
    • Business to Business (B2B)
      • Transaction
    • Business to Person (B2P)
      • Transaction
    • 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. Transaction Query

Transaction Query

Developing
GET
api/v1/transactions/{transactionReference}

Request

Path Params

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 GET 'http://prod-cn.your-api-server.comapi/v1/transactions/'

Responses

🟢200Success
application/json
Body

Example
{
    "amount": "45000.50",
    "currency": "NGN",
    "type": "p2p",
    "descriptionText": "Monthly family support",
    "requestDate": "2026-03-02T17:50:12.000Z",
    "transactionReference": "GSWIFT_FR_NG_260302175012",
    "provider": "23490",
    "debitParty": [
        {
            "key": "msisdn",
            "value": "+33612345678"
        }
    ],
    "creditParty": [
        {
            "key": "msisdn",
            "value": "+2348012345678"
        }
    ],
    "transactionStatus": "ACKNOWLEDGED",
    "status": "PENDING",
    "creditingOrganisationTransactionReference": "",
    "senderKyc": {
        "nationality": "FR",
        "dateOfBirth": "1988-04-12",
        "countryOfBirth": "FR",
        "gender": "M",
        "idDocument": [
            {
                "idType": "passport",
                "idNumber": "15FRA89012",
                "issueDate": "2018-07-15",
                "expiryDate": "2028-07-14",
                "issuerCountry": "FR"
            }
        ],
        "postalAddress": {
            "addressLine1": "15 Rue de Rivoli",
            "addressLine2": "",
            "addressLine3": "4th Floor",
            "city": "Paris",
            "stateProvince": "Île-de-France",
            "postalCode": "75004",
            "country": "FR",
            "cityOfBirth": "Lyon"
        },
        "subjectName": {
            "title": "Mr.",
            "firstName": "Luc",
            "middleName": "Antoine",
            "lastName": "Dubois",
            "fullName": "Luc Antoine Dubois"
        }
    },
    "recipientKyc": {
        "nationality": "NG",
        "dateOfBirth": "1990-11-23",
        "emailAddress": "recipient.ng@example.com",
        "countryOfBirth": "NG",
        "idDocument": [
            {
                "idType": "nin",
                "idNumber": "12345678901",
                "issueDate": "2020-01-10",
                "expiryDate": "2030-01-10",
                "issuerCountry": "NG"
            }
        ],
        "postalAddress": {
            "addressLine1": "24 Broad Street",
            "addressLine2": "Lagos Island",
            "addressLine3": "",
            "city": "Lagos",
            "stateProvince": "Lagos",
            "postalCode": "101231",
            "country": "NG",
            "cityOfBirth": "Abuja"
        },
        "subjectName": {
            "title": "Mr.",
            "firstName": "Chidi",
            "middleName": "Oluwaseun",
            "lastName": "Adeyemi",
            "fullName": "Chidi Oluwaseun Adeyemi"
        }
    },
    "internationalTransferInformation": {
        "quoteId": "GSQT260302175012FRNG",
        "receivingCountry": "NG",
        "remittancePurpose": "Family Support",
        "sourceOfFunds": "Employment Income",
        "relationshipSender": "Friend"
    }
}
Modified at 2026-03-12 10:41:51
Previous
Transaction Query
Next
Transaction Status Webhook
Built with