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-Type: application/json" \
-H "Authorization: GLOREMIT <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 Name | Required | Min/Max Length | Type | Remark |
UID | M | 5/50 | Alphanumeric | Username for validation. |
PWD | M | 5/50 | Alphanumeric | Password for validation, 3DES encrypted. |
rspSign | M | 32/50 | Alphanumeric | Digital signature of RSP. (Please refer to Digital signature) |
UIDBranch | O | 1/16 | Numeric | RSP branch identifier. If no branch ID, value as NULL. |
transID | M | 6/64 | Alphanumeric | 6 digits or more unique transaction ID from RSP on 7 day basis. Duplicated ID within the last 7 calendar days (GMT +8 timezone) will be declined. 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. |
sFirstName | M | 1/100 | Alphanumeric | Sender's First Name. |
sLastName | O | 1/100 | Alphanumeric | Sender's Last Name. |
sIdType | M | 1/30 | Numeric | Sender Identification Type. (Please refer to Sender) |
sIdNum | M | 8/50 | Alphanumeric | Sender Identification Number. |
sIdExpiry | C | 10/10 | String | Sender ID Expiry Date. Date Format: MM/DD/YYYY DD/MM/YYYY D/M/YYYY M/D/YYYY YYYY/M/D YYYY/MM/DD |
sContactNum | O | 8/30 | Numeric | Sender Contact Number. Please specify in Country code + MSISDN format. For e.g. Indonesia = 628123456789. |
sOccupation | O | 1/50 | Alphanumeric | Sender Occupation. |
sFundSource | M | 1/50 | Alphanumeric | Sender’s source of fund. (Please refer to Sender) |
sBirthDate | M | 10/10 | Alphanumeric | Sender’s Birth date. Date Format: MM/DD/YYYY DD/MM/YYYY D/M/YYYY M/D/YYYY YYYY/M/D YYYY/MM/DD |
sEmail | O | 1/50 | Alphanumeric | Sender email address. |
sAddress | M | 2/50 | Alphanumeric | Sender’s Full Address. (Simplified address is acceptable, e.g. Hotel Name, City, Country) |
sCity | O | 2/30 | Alphanumeric | Sender’s resident city. |
sPostCode | O | 1/50 | Numeric | Sender’s address postcode. |
sCountry | M | 2/5 | Alphanumeric | Sender’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) |
sCurrency | M | 3/6 | Alphanumeric | RSP Currency Code as per RSP GSVA Wallet. Do not send as Sender currency. (Please refer to ISO 4217 Currency Code) |
bCountry | M | 2/5 | Alphanumeric | Beneficiary’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) |
bCurrency | M | 3/6 | Alphanumeric | Beneficiary’s Currency Code. (Please refer to ISO 4217 Currency Code) |
CurrToken | O | 16/25 | Alphanumeric | For Future Use. |
sAmount | O | 1/16 | Numeric | Sender Amount from RSP based on sCurrency. |
trxValue | M | 1/16 | Numeric | Total Amount. Please specify the total amount to send denominated in bCurrency. |
bFirstName | M | 1/100 | Alphanumeric | Beneficiary'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. |
bLastName | O | 1/100 | Alphanumeric | Beneficiary'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. |
bAccType | M | 1/30 | Numeric | Beneficiary Account Type. (Please refer to Beneficiary) |
bIssuerCode | M | 3/16 | Alphanumeric | Beneficiary Account Issuer Code. * such as banks, e-wallet operator or mobile operators. (Please refer to Service Spec) |
BankProvince | O | 1/100 | Alphanumeric | Bank located province. |
BankCity | O | 1/100 | Alphanumeric | Bank located city. * Reserve for future purpose |
BankBranchName | O | 1/100 | Alphanumeric | Reserve for future purpose. |
BankBranchCode | C | 1/100 | Alphanumeric | Bank 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) |
bAccNum | M | 1/45 | Alphanumeric | Beneficiary Account Number or any other unique account identifier as determined by Beneficiary issuer Optional when bAccType = 5 (Cash Pickup). |
bIdType | C | 1/30 | Alphanumeric | Beneficiary Identification Type. (Please refer to Beneficiary) |
bIdNum | C | 1/30 | Alphanumeric | Beneficiary Identification Number. |
bContactNum | C | 1/50 | Numeric | Beneficiary’s contact number. Please specify in Country code + MSISDN format. For e.g. Indonesia = 628123456789 Tranglo will send SMS for bAccType=5 |
Relationship | M | 1/30 | Alphanumeric | Beneficiary and Sender Relationship. |
bAddress | C | 1/50 | Alphanumeric | Beneficiary’s Full Address. Required if bAccType=9. |
bCity | O | 1/50 | Alphanumeric | Beneficiary’s resident city. |
bPostCode | O | 1/50 | Numeric | Beneficiary address postcode. |
bEmail | O | 1/50 | Alphanumeric | Beneficiary’s email address. |
bProvinceCode | C | 1/50 | Alphanumeric | Beneficiary’s province code. Required for PT POS Cash Pickup Transactions and Australia Account Channel Transaction. |
bRegencyCode | C | 1/50 | Alphanumeric | Beneficiary’s regency city code. Required for PT POS Cash Pickup Transactions and Australia Account Channel Transaction. |
bPayoutID | C | 1/16 | Alphanumeric | Beneficiary’s payout ID or cash pick up code. To submit the earlier Get_Payoutcode result |
bPayoutPIN | C | 1/30 | Alphanumeric | Beneficiary’s payout PIN or cash pick up password. To submit the earlier Get_Payoutcode result. |
FR_Key | O | 32 | Alphanumeric | Key/Token for Reserved Forex. |
bPurposeCode | M | N/A | Numeric | Purpose of the Transaction. (Please refer to Sender) |
bNationality | O | 2/5 | Alphanumeric | Beneficiary's Nationality. Accept ISO 3166-1 Alpha-2 ONLY Please refer to ISO 3166 Country Code) |
bBirthDate | O | 8/10 | Alphanumeric | Beneficiary's Birth Date. Date Format: MM/DD/YYYY DD/MM/YYYY D/M/YYYY M/D/YYYY YYYY/M/D YYYY/MM/DD |
sOriginCountry | M | 2/2 | Alphanumeric | Origin country of fund. 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 Name | Required | Type | Remark |
TrxStatus | M | Numeric | Transaction status response code. (Please refer to Transaction status) |
GTN | M | Alphanumeric | Transaction GTN number. (14characters) |
transID | M | Alphanumeric | Unique Transaction ID from RSP. |
PayoutPIN | O | Alphanumeric | Payout PIN from cash out supplier. |
Description | M | Alphanumeric | Transaction description or advice. |
LastBal | M | Numeric | The latest balance of RSP e-wallet. |
CurrRate | M | Numeric | The transaction currency rate. |
Status_Type | O | Alphanumeric | Status Type. Possible Values: • Approved • Cancelled • Failed • Pending • Rejected • Suspected |
M= Mandatory, C= Conditional, O= Optional