Validation: Get Validation

Partner use this method to do pre-check the validity of a Beneficiary account number. GloRemit will attempt to match the Beneficiary name with Account Issuer (such as Banks or Mobile Operator E-wallet) and Account Number. This validation shall ensure the minimal transaction rejection and failure rate due to wrong information or barred accounts. Some country may not support for bank account validity.

As of 1st July 2014, only Indonesia Credit to Bank Account supports validation

Definition:

GET /v1/payments/validation?transID={transID}&sIdType={sIdType}&sIdNum={sIdNum}&sFirstName={sFirstN ame}&sLastName={sLastName}&bFirstName={bFirstName}&bLastName={bLastName}&bCountry={bCount ry}&bAccType={bAccType}&bIssuerCode={bIssuerCode}&bAccNum={bAccNum}&trxValue={trxValue}

Sample Request:

curl -v "http://staging-gloremit.tranglo.com:2014/v1/payments/validation?transID=GV1&sIdType= 1&sIdNum=&sFirstName=AA&sL astName=&bFirstName=Amiran&bLastName=Abdullah &bCountry=ID&bAccType=1&bIssuerCode= 002&bAccNum=376800000000888&trxValue=100" \
-H "Authorization: GLOREMIT <UID>:<PWD> :<rspSign>"

Request Description

Parameter NameRequiredMin/Max LengthTypeRemark
rspSignM32/50AlphanumericDigital signature of RSP, see Section 4 for more info.
UIDM5/50AlphanumericUsername for validation.
PWDM5/50AlphanumericPassword for validation, 3DES encrypted.
transIDM6/16Alphanumeric6 digits or more unique transaction ID from RSP.
sIdTypeM1/30NumericSender Identification Type. Please refer to Section 3 for full list.
sIdNumM8/16AlphanumericSender Identification Number
sFirstNameM1/50AlphanumericSender's First Name(max 50 characters)
sLastNameM1/50AlphanumericSender's Last Name(max 50 characters)
bFirstNameM1/50AlphanumericBeneficiary First Name
bLastNameM1/50AlphanumericBeneficiary Last Name
bCountryM2/5AlphanumericBeneficiary’s country code. Please refer to ISO 3166 Country Code.Country code will determine the default currency
bAccTypeM1/30NumericBeneficiary Account Type. Please refer to Section 3.
bIssuerCodeM3/16AlphanumericBeneficiary Account Issuer Code, such as banks, e-wallet operator or mobile operators. Please refer to Appendix 1.
bAccNumM1/18AlphanumericBeneficiary Issuer Account Number or any other unique account identifier as determined by issuer.
trxValueM1/16NumericTotal Amount is sent according to Beneficiary currency. It can be specified with any amount. Please refer to Section 2.7 for exception note.

Response Description

GloRemit server will return a JSON format with response code when RSP request is accepted.

Sample Response:

{"ValidateStatus":"000",
"transID":"GV1",
"BeneficiaryName": "AMIRAN ABDULLAH",
"Description":"Transaction is Successful"}
Parameter NameRequiredTypeRemark
ValidateStatusMNumericTransaction request status response code. Please see Section 3.5 for full records.
transIDMAlphanumericUnique Transaction ID from RSP.
DescriptionMAlphanumericTransaction description or advice
BeneficiaryNameMAlphanumericThe account holder name (Beneficiary) as returned by account issuer.

M= Mandatory, C= Conditional, O= Optional