HUhub2
IRT

Validate a recipient account

Changed on

Validates a recipient mobile/bank account against the last-mile partner before a transaction is created. No transaction is created and no float is touched. Behind ENABLE_FX_ENGINE flag.

post/irt/v1/validate/account

Request

  • The document declares no server URL.
  • Auth
    none declared. Required headers: ApiKey, MerchantId, Environment

Headers

ApiKeystring required

Your api key. To create a key, please get into our dashboard. If you don't have access to it, please reach the Support team.

MerchantIdstring required

Your merchant ID. This information is available in our dashboard. If you don't have access to it, please reach the Support team.

Environment'live' | 'sandbox' required

Allow you to choose between the sandbox mode to perform some tests or the live mode for real world transactions.

Request body

providerstring required

Mobile money provider or bank identifier. Must be valid for the requested corridor.

corridorstring required

Corridor code. Determines which last-mile partner adapter handles the check and which rail (mobile/bank) is expected.

Example request

{
  "provider": "orange_money",
  "corridor": "XOF_MOBILE_SENEGAL",
  "sender": {
    "firstName": "Aminata",
    "lastName": "Traoré"
  },
  "recipient": {
    "firstName": "Moussa",
    "lastName": "Konaté",
    "mobile": "+221771234567"
  }
}

Response

status'account_valid' | 'account_not_found' | 'account_unknown' | 'timeout' required

Account status.

providerstring required

Provider that was checked. Echoed back from the request.

corridorstring required

Corridor that was checked. Echoed back from the request.

mobilestring

Mobile number checked, masked to the last 4 digits. Present for a mobile-money corridor.

accountNumberstring

Bank account number checked, masked to the last 4 digits. Present for a bank-transfer corridor.

validatedAtstring required

UTC timestamp of the validation check.

advisorystring required

Always present. Validation is advisory only — a valid result does not guarantee payout success.

Example response

{
  "status": "account_valid",
  "provider": "orange_money",
  "corridor": "XOF_MOBILE_SENEGAL",
  "mobile": "+********4567",
  "accountNumber": "******7890",
  "accountHolder": {
    "firstName": "Moussa",
    "lastName": "Konaté",
    "nameMatch": "match"
  },
  "validatedAt": "2026-08-05T13:00:00.000Z",
  "advisory": "Validation is advisory only. A valid result does not guarantee payout success."
}

Changes