Get_PaymentValidation

Corporate Customers can use this method to perform payment validations to ensure payment inputs are securely verified.

Definition

POST/api/payments/payment-validation

Sample Request

curl -X POST
-H "Authorization: BEARER "
-d '{
"Reference_ID": "RT123123123213",
"Account_ID": 214580100000278,
"Payout_Information": {
"Payout_Country": "PH",
"Payout_Currency": "PHP",
"Payout_Amount": 1000.00,
"Purpose_Code": 1,
"Trxn_Type": 1,
"Fund_Source": 2,
"FR_Key": "FR_KEY_FOR_FUTURE_USE",
"Remark": "Payment for services"
},
"Beneficiary": {
"Beneficiary_Type": "I",
"Full_Name": "Jane Smith",
"Nationality": "PH",
"Birth_Date": "02/02/1992",
"Identification":
{
"ID_Type": 3,
"ID_No": "ID987654321"
},
"Relationship": 1,
"Bank_Details": {
"Issuer_Code": "520",
"Account_Type": 1,
"Account_Number": "012345678901",
"Bank_City": "Manila",
"Bank_Province": "NCR",
"Bank_Postcode": "1000",
"Bank_Branch_Name": "Main Branch",
"Bank_Branch_Code": "AFBQMYKL"
},
"Address": {
"Address": "456 Another St",
"Province": "NCR",
"Regency": "Manila",
"City": "Manila",
"Postcode": "1000"
},
"Contact_Person": {
"Contact_No": "639123456789",
"Email": "jane.smith@domain.com"
}
}
}

Request Description

Parameter Name	Required	Min/Max Length	Type	Remark
Authorization	M	Bearer <jwt-token>	String	Bearer <jwt-token> • The JWT token used for authentication must be passed in the Authorization header prefixed with Bearer.
Reference_ID	M	6/48	String	Unique TB Corporate Customers reference ID.
Account_ID	M	15/15	Numeric	TB Corporate Customer's Account ID/ Wallet Account ID.
Payout_Country	M	2/2	Char	Accept ISO 3166-1 Alpha-2 ONLY
Payout_Currency	M	3/3	Char	Accept ISO 4217
Payout_Amount	M	1/16	Numeric	Payout's Total Amount.
Purpose_Code	M	5/15	String	Purpose of the transaction.
Trxn_Type	M	1/2	Numeric	Transaction Type/Transaction Channel.
Fund_Source	M	1/2	Numeric	Sender's source of fund.
Remark	O	1/100	String	Payment Remark.
FR_Key	O	32/32	String	FR key for future use.
Beneficiary_Type	M	1/1	Numeric	Either (2) Corporate or (1) Individual.
Full_Name	M	6/200	String
Nationality	M	2/2	Char	Beneficiary's Nationality. - Accept ISO 3166-1 Alpha-2 ONLY
Birth_Date	O	8/8	Date (DD/MM/YYYY)	Beneficiary's Birth date.
ID_Type	M	1/1	Numeric	Beneficiary's Identification Type.
ID_No	C	8/50	String	Beneficiary's Identification Number.
Relationship	M	1/2	Numeric	Beneficiary Relationship.
Issuer_Code	M	3/16	String	Beneficiary Account's Issuer Code.
Account_Type	O	1/1	Numeric	Beneficiary's bank account type. (1) - Saving (2) - Checking (3) - Current (4) - Others
Account_Number	O	1/30	String	Beneficiary's account number.
Bank_City	O	1/50	String	Beneficiary's bank city.
Bank_Province	O	1/50	String	Beneficiary's bank province.
Bank_Postcode	O	1/10	String	Beneficiary's bank postcode.
Bank_Branch_Name	O	1/100	String	Beneficiary's bank branch name.
Bank_Branch_Code	O	1/50	String	Beneficiary's bank branch code.
Address	O	2/50	String	Beneficiary's full address.
Province	O	1/50	String	Beneficiary's address province.
Regency	O	1/50	String	Beneficiary's address regency city.
City	O	2/30	String	Beneficiary's resident city.
Postcode	O	1/50	String	Beneficiary's address postcode.
Contact_No	O	8/30	Numeric	Beneficiary's contact number.
Email	O	5/50	String	Beneficiary's email address.

Sample Response:

HTTP 200 OK
{
"Payment_ID": "B1252600000001",
"Reference_ID": "RT123123123213",
"Payment_Status": {
"Status": "ACCEPTED",
"Status_Code": 965,
"Sub_Status_Desc": ""
},
"LastBal": 1000.00,
"CurrRate": 1.05
}

Response Description

Parameter	Data Type	Required	Description
Payment_ID	String	M	Payment ID generated by Tranglo.
Reference_ID	String	M	Unique Reference ID from Corporate Customer.
Status	String	M	Transaction Status.
Status_Code	Numeric	M	Transaction Status Code.
Sub_Status_Desc	String	M	Description of transaction status. * Note: For a FAILED status, the system will return all the reasons for the transaction failure.
LastBal	Numeric	M	The latest balance of Corporate Customer wallet.
CurrRate	Numeric	M	The transaction currency rate.

M = Mandatory, C = Conditional, O = Optional