Get_AccountValidation

Corporate Customers uses this method to do pre-check the validity of a Beneficiary account number. Tranglo Business will attempt to match the Beneficiary name with Account Issuer (such as Banks and Account Number). This validation shall ensure the minimal transaction rejection and failure rate due to wrong information or barred accounts.
Validation available for Indonesia (Bank), Pakistan (Bank), Vietnam (Bank), Cambodia (Bank), Nepal (Bank & Real Time), Nigeria (Bank), Turkey (Bank). Some country may not support for bank account validation.

Definition

POST/api/payments/validation

Sample Request

curl -X POST \
-H "Authorization: Bearer <JWT-token>"\
-d '{
"Reference_ID": "VT1231231231213",
"Sender_Information":{
"Full_Name":"Joe Sanders"
},
"Beneficiary": {
"Full_Name": "Jane Smith",
"Account_No": "1234567890123456"
},
"Payout_Information": {
"Payout_Country": "MY",
"Payout_Currency": "MYR",
"Trxn_Type": "1",
"Issuer_Code": "6000001"
}
}'

Request Description

Parameter Name	Required	Min/Max Length	Type	Remark
Authorization	M	Bearer <jwt-token>	String
Reference_ID	M	6/16	String	Unique Corporate Customer's reference ID for Do_Validation purpose.
Full_Name	O	6/200	String	Beneficiary's Full Name.
Account_No	O	1/30	String	Beneficiary's Account Number.
Payout_Country	M	2/2	Char	Accepts ISO 3166-1 Alpha-2 ONLY.
Payout_Currency	O	3/3	Char	Accepts ISO 4217.
Trxn_Type	M	1/2	Numeric
Issuer_Code	M	3/16	String	Beneficiary Account's Issuer Code.

Tranglo Business server will return a JSON format with response code when Sales Partner request is accepted.

Sample Response

{
"Reference_ID": "VT123123123213",
"Validation_Status": {
"Status": "COMPLETED",
"Status_Code": "970",
"Sub_Status_Desc": "Validation Successful"
},
"Beneficiary": {
"Full_Name": "Jane Smith",
"Account_No": "1234567890123456"
}
}

Response Description

Parameter	Data Type	Required	Description
Authorization	M	String	Unique Corporate Customer's reference ID for Do_Validation purpose.
Status	M	String	Transaction Status.
Status Code	M	String	Transaction Status Code.
Sub Status Desc	M	String	Description of transaction status.
Full_Name	M	String	Beneficiary's Full Name.
Account_No	O	String	Beneficiary's Account Number.

M = Mandatory, C = Conditional, O = Optional