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.

Bangladesh, China, Indonesia, Pakistan, Turkey and Vietnam are available for validation. Please refer to Validation Available Country for full list.

Definition:

GET 
/v1/payments/validation?transID={transID}&sIdType={sIdType}&sIdNum={sIdNum}&sFirstName={sFirstName}&sLastName={sLastName}&bFirstName={bFirstName}&bLastName={bLastName}&bCountry={bCountry}&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=000000&sFirstName=Test1&sLastName=Ting2&bFirstName=Amiran&
bLastName=Abdullah&bCountry=ID&bAccType=1&bIssuerCode=002&bAccNum=376800000000888&trxValue=100"\
-H "AuthorizationGLOREMIT <UID>:<PWD>:<rspSign>"

Request description

Parameter NameRequiredMin/Max LengthTypeRemark
UIDM5/50AlphanumericUsername for validation.
PWDM5/50AlphanumericPassword for validation, 3DES encrypted.
rspSignM32/50AlphanumericDigital signature of RSP.
(Please refer to Digital signature)
transIDM6/16Alphanumeric6 digits or more unique transaction ID from RSP.
sIdTypeM1/30NumericSender Identification Type.
(Please refer to Sender)
sIdNumM8/16AlphanumericSender Identification Number.
sFirstNameM1/100AlphanumericSender's First Name.
(max 100 characters)
sLastNameM1/100AlphanumericSender's Last Name.
(max 100 characters)
bFirstNameM1/100AlphanumericBeneficiary First Name.
bLastNameM1/100AlphanumericBeneficiary Last Name.
bCountryM2/5AlphanumericBeneficiary’s country code.
Beneficiary’s country code will determine the default currency.
Accept ISO 3166-1 Alpha-2 ONLY
(Please refer to ISO 3166 Country Code)
bAccTypeM1/30NumericBeneficiary Account Type.
(Please refer to Beneficiary)
bIssuerCodeM3/16AlphanumericBeneficiary Account Issuer Code, such as banks, e-wallet operator or mobile operators.
(Please refer to Service Spec)
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.

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 refer to Transaction status)
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