Account Validation
This POST request is responsible for the validation of an account number. It ensures that the provided account details are active and reachable before initiating a transaction.
Note: A valid token is required for authentication as it expires after every hour. Refer to the Token Request section to generate a new token.
Mandatory Fields
- type:
1-mobileor2-bank. - systemTraceAuditNumber: Unique ID generated by the consumer.
- primaryAccountNumber: The account number to be validated.
- institutionCode: Mobile MCCMNC or Bank code.
- callBackUrl: Your webhook endpoint for notifications.
- callBackFormat: Either
JSONorXML.
Optional Parameters
- ccy: The currency the account is set in.
- countryCode: The country allowed for transactions (crucial for bank accounts).
Validation results are sent asynchronously to your configured callBackUrl in the format specified.
Data Definition
| Field Name | Data Type | Options |
|---|---|---|
| type | int | Mandatory |
| systemTraceAuditNumber | string | Mandatory |
| primaryAccountNumber | string | Mandatory |
| institutionCode | string | Mandatory |
| callBackUrl | string | Mandatory |
| callBackFormat | string | Mandatory |
| ccy | string | Optional |
| countryCode | string | Optional |
POST
/v1/account/validateValidate Account Number
Endpoint: https://sandbox-test.wapipay.com/v1/account/validate