Transfer: Perform Transfer

Partners use this method to initiate and confirm the fund transfer operation via GloRemit. The method is non-reversible and committed in real-time. Whenever applicable, Partners should use Get Validation (REST) to check and confirm the validity of a Beneficiary account before using this method to ensure highest success rate.

Perform Transfer (REST) would always return “968-Transaction Pending” if the transaction is accepted. Partners are required to call Get Transaction Status (REST) to retrieve the final status of the sent transaction. Normally it will take a few seconds to process and finalize a transaction’s status.

Definition:

POST v1/payments/transfers


Sample request:

curl -v -X POST http://staging-gloremit.tranglo.com:2014/v1/payments/transfers \
-H "Content-Typeapplication/json" \
-H "AuthorizationGLOREMIT <UID>:<PWD>:<rspSign>" \
-d '{ "UIDBranch":"", "transID":"1206", "sFirstName":"Kai", "sLastName":"Yen", "sIdType":1, "sIdNum":"710320-71-5379", "sIdExpiry":"2017-09-06", "sContactNum":"1", "sOccupation":"1", "sFundSource":"1", "sBirthDate":"1971-03-20 00:00:00.000", "sEmail":"sEmail@gmail.com", "sAddress":"1", "sCity":"1", "sPostCode":"1", "sCountry":"MY", "sCurrency":"MYR", "bCountry":"PH", "bCurrency":"PHP", "trxValue":200, "bFirstName":"Oppo", "bLastName":"Frank", "bAccType":5, "bIssuerCode":"CPCL", "BankProvince":"1", "BankCity":"1", "BankBranchName":"1", "BankBranchCode":"1", "bAccNum":"123", "bIdType":1, "bIdNum":"1231111111111", "bContactNum":"0146854044", "Relationship":"MUM", "bAddress":"1", "bCity":"1", "bPostCode":"1", "bEmail":"haha@gmail.com", "bProvinceCode":"1", "bRegencyCode":"1", "bPayoutID":"", "bPayoutPIN":"", "bPurposeCode":"1000", "bNationality":"MY", "bBirthdate":"1982-09-06", "sOriginCountry":"MY" }'

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)
UIDBranchO1/16NumericRSP branch identifier.
If no branch ID, value as NULL.
transIDM6/64Alphanumeric6 digits or more unique transaction ID from RSP.
If the same transID were used, the system will validate against the transaction details.
* The new request with DIFFERENT transaction details will be rejected with error duplicate transID, else system will respond the same as per first request.
sFirstNameM1/100AlphanumericSender's First Name.
sLastNameM1/100AlphanumericSender's Last Name.
sIdTypeM1/30NumericSender Identification Type.
(Please refer to Sender)
sIdNumM8/50AlphanumericSender Identification Number.
sIdExpiryC10/10StringSender ID Expiry Date.
Date Format:
  MM/DD/YYYY
  DD/MM/YYYY
  D/M/YYYY
  M/D/YYYY
  YYYY/M/D
  YYYY/MM/DD
sContactNumO8/30NumericSender Contact Number.
Please specify in Country code + MSISDN format.

For e.g. Indonesia = 628123456789.
sOccupationO1/50AlphanumericSender Occupation.
sFundSourceM1/50AlphanumericSender’s source of fund.
(Please refer to Sender)
sBirthDateM10/10AlphanumericSender’s Birth date.
Date Format:
  MM/DD/YYYY
  DD/MM/YYYY
  D/M/YYYY
  M/D/YYYY
  YYYY/M/D
  YYYY/MM/DD
sEmailO1/50AlphanumericSender email address.
sAddressO2/50AlphanumericSender’s Full Address.
sCityO2/30AlphanumericSender’s resident city.
sPostCodeO1/50NumericSender’s address postcode.
sCountryM2/5AlphanumericSender’s Country.
(Country value serves as identity purpose only. It has no impact on Sender or Beneficiary currency used.)
Accept ISO 3166-1 Alpha-2 or Alpha-3 ONLY
(Please refer to ISO 3166 Country Code)
sCurrencyM3/6AlphanumericRSP Currency Code as per RSP GSVA Wallet.
Do not send as Sender currency.

(Please refer to ISO 4217 Currency Code)
bCountryM2/5AlphanumericBeneficiary’s Country.
(Country value serves as identity purpose only. It has no impact on Sender or Beneficiary currency used.)
Accept ISO 3166-1 Alpha-2 ONLY
(Please refer to ISO 3166 Country Code)
bCurrencyM3/6AlphanumericBeneficiary’s Currency Code.
(Please refer to ISO 4217 Currency Code)
CurrTokenO16/25AlphanumericFor Future Use.
sAmountO1/16NumericSender Amount from RSP based on sCurrency.
trxValueM1/16NumericTotal Amount.
Please specify the total amount to send denominated in bCurrency.
bFirstNameM1/100AlphanumericBeneficiary's first name.
* If Credit to China Bank Account, FirstName is Given name. Best practice, if name is in Chinese, put all characters in bFirstName field and leave bLastName empty. If the name submitted in Roman Character (E.G. English), system will send a SMS to the beneficiary to enter the name according to the bank system.
bLastNameM1/100AlphanumericBeneficiary's last name.
* If Credit to China Bank Account, LastName is the Sur name Best practice, if name is in Chinese, put all characters in bFirstName field and leave bLastName empty. If the name submitted in Roman Character (E.G. English), system will send a SMS to the beneficiary to enter the name according to the bank system.
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)
BankProvinceO1/100AlphanumericBank located province.
BankCityO1/100AlphanumericBank located city.
* Reserve for future purpose
BankBranchNameO1/100AlphanumericReserve for future purpose.
BankBranchCodeC1/100AlphanumericBank Branch Code or IFSC code.
* If and only if Credit to Australia, Bangladesh, India and Japan Bank Account
(Please refer to GloRemit API Code List)
bAccNumM1/45AlphanumericBeneficiary Account Number or any other unique account identifier as determined by Beneficiary issuer Optional when bAccType = 5 (Cash Pickup).
bIdTypeC1/30AlphanumericBeneficiary Identification Type.
(Please refer to Beneficiary)
bIdNumC1/30AlphanumericBeneficiary Identification Number.
bContactNumC1/50NumericBeneficiary’s contact number.
Please specify in Country code + MSISDN format.

For e.g. Indonesia = 628123456789 Tranglo will send SMS for bAccType=5
RelationshipM1/30AlphanumericBeneficiary and Sender Relationship.
bAddressC1/50AlphanumericBeneficiary’s Full Address.
Required if bAccType=9.
bCityO1/50AlphanumericBeneficiary’s resident city.
bPostCodeO1/50NumericBeneficiary address postcode.
bEmailO1/50AlphanumericBeneficiary’s email address.
bProvinceCodeC1/50AlphanumericBeneficiary’s province code.
Required for PT POS Cash Pickup Transactions and Australia Account Channel Transaction.
bRegencyCodeC1/50AlphanumericBeneficiary’s regency city code.
Required for PT POS Cash Pickup Transactions and Australia Account Channel Transaction.
bPayoutIDC1/16AlphanumericBeneficiary’s payout ID or cash pick up code.
To submit the earlier Get_Payoutcode result
bPayoutPINC1/30AlphanumericBeneficiary’s payout PIN or cash pick up password.
To submit the earlier Get_Payoutcode result.
FR_KeyO32AlphanumericKey/Token for Reserved Forex.
bPurposeCodeMN/ANumericPurpose of the Transaction.
(Please refer to Sender)
bNationalityO2/5AlphanumericBeneficiary's Nationality.
Accept ISO 3166-1 Alpha-2 or Alpha-3 ONLY
Please refer to ISO 3166 Country Code)
bBirthDateO8/10AlphanumericBeneficiary's Birth Date.
Date Format:
  MM/DD/YYYY
  DD/MM/YYYY
  D/M/YYYY
  M/D/YYYY
  YYYY/M/D
  YYYY/MM/DD
sOriginCountryO2/2AlphanumericOrigin country of the transaction initiated.
Accept ISO 3166-1 Alpha-2 or Alpha-3 ONLY
(Please refer to ISO 3166 Country Code)

Response Description

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

Sample Response:

{
    "TrxStatus":"968",
    "GTN":"G3317310424632",
    "transID":"1207",
    "Description":"Transaction Pending",
    "LastBal":"88196588.82",
    "CurrRate":11.1997
}
Paramater NameRequiredTypeRemark
TrxStatusMNumericTransaction status response code.
(Please refer to Transaction status)
GTNMAlphanumericTransaction GTN number. (14characters)
transIDMAlphanumericUnique Transaction ID from RSP.
PayoutPINOAlphanumericPayout PIN from cash out supplier.
DescriptionMAlphanumericTransaction description or advice.
LastBalMNumericThe latest balance of RSP e-wallet.
CurrRateMNumericThe transaction currency rate.

M= Mandatory, C= Conditional, O= Optional