Introduction

Use this API to get beneficiary account details.

Request

You need to authenticate your requests to access any endpoint in the SenGo API.

Request Parameters

Name
bankCode
Type
mandatory
Description
The code representing the bank to be used for the transaction. To find the bank code, please refer to the Bank Codes section.
Name
accountNumber
Type
mandatory
Description
The bank account number of the customer, which will be the receiver of the transaction.
Name
reference
Type
mandatory
Description
A unique reference number or identifier for the transaction. all transaction references should be unique.
Name
additionalInfo.callback
Type
mandatory
Description
The callback URL where notifications or updates related to the transaction will be sent.

You need to authenticate your Headers request to access any endpoint in the SenGo API, to see the authentication documentation please read the Authentication section.

Request Json

POST

{{HOST}}/account-inquiry

<?php
$curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => '{{HOST}}/account-inquiry',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => '',
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 0,
CURLOPT_FOLLOWLOCATION => true,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_POSTFIELDS =>'{
    "bankCode": "014",
    "accountNumber":"1234567890",
    "reference": "REF001",
    "additionalInfo": {
        "callback": "http://your-site-callback.com/notify"
    }
}',
CURLOPT_HTTPHEADER => array(
    'X-Client-Key: ',
    'X-Client-Token: ',
    'X-Signature: '
    ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

Response

Response Json

POST

{{HOST}}/account-inquiry

{
    "responseCode": 200,
    "responseMessage": "success",
    "responseData": {
        "id": "66e934f6-f5d6-4f1c-bb3d-450ec2873782",
        "merchantRef": "REFF012",
        "status": "success",
        "accountNumber": "1234567890",
        "accountName": "Sen Global Network",
        "bankCode": "014",
            "additionalInfo": {
            "callback": "http://your-site-callback.com/notify"
        }
    }
}

If you want to see the error code status, please read the Extras >> Error Code section.