Fund Transfer Status

Reconcile any prior payout. Run this for every transfer you initiate — the synchronous response from Fund Transfer might not reach you due to network issues, and you should always have a second source of truth.

POST https://{pg_api_url}/v3/fundtransferstatus
Content-Type: application/x-www-form-urlencoded

Request parameters

api_keystring (36)required

merchant_reference_numberstring (30)required

The unique ref you sent on Fund Transfer.

hashstring (255)required

Response

Found:

{
  "data": {
    "status": "SUCCESS",
    "merchant_reference_number": "PAY-124",
    "transaction_id": "NEFT3057381244",
    "beneficiary_name": "John Doe",
    "error_message": null
  }
}

Field	Description
status	One of the values listed in Disbursement statuses.
merchant_reference_number	Echo of your reference.
transaction_id	Bank-side UTR. null while the payout is still PROCESSING.
beneficiary_name	Account-holder name as registered with the beneficiary bank. Returned for verification once the bank resolves the account. null early in the flow.
error_message	Populated on FAILED/FAILURE/RETURNED_FROM_BENEFICIARY with the bank's reason; null otherwise.

Not found:

{
  "error": {
    "code": 1028,
    "message": "Transaction not found"
  }
}

See Disbursement statuses for all values of status and what each means.

tip

The transaction_id returned here is the bank-side reference. Use it to identify the payout on your bank statement during reconciliation.