Do_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 to check and confirm the validity of a Beneficiary account before using this method to ensure highest success rate.
Do_Transfer would always return “968-Transaction Pending” if the transaction is accepted. Partners are required to call Get_TrxStatus (please refer to section 2.4) to retrieve the final status of the sent transaction. Normally it will take a few seconds to process and finalize a transaction’s status.
Request Description
| Parameter | Required | Min/Max Length | Type | Remark |
| rspSign | M | 32/50 | Alphanumeric | Digital signature of RSP |
| UID | M | 5/50 | Alphanumeric | Username for validation. |
| PWD | M | 5/50 | Alphanumeric | Password for validation |
| 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. |
| sFirstName | M | 1/100 | Alphanumeric | Sender's First Name |
| sLastName | M | 1/100 | Alphanumeric | Sender's Last Name |
| sIdType | M | 1/30 | Numeric | Sender Identification Type. Please refer to Section 3.3 |
| 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. (Please refer to Section 2.7 for exception note) |
| sOccupation | O | 1/50 | Alphanumeric | Sender Occupation |
| sFundSource | M | 1/50 | Alphanumeric | Sender’s source of fund. Refer to the list at 3.10 |
| 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 | O | 2/50 | Alphanumeric | Sender’s Address. (Simplify Address is acceptable Eg. 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 Nationality. Accept ISO 3166-1 Alpha-2 or Alpha-3 ONLY |
| sCurrency | M | 3/6 | Alphanumeric | RSP Currency Code as per RSP GSVA Wallet. Do not send as Sender currencyPlease 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 |
| bCurrency | M | 3/6 | Alphanumeric | Beneficiary’s Currency Code. Please refer to ISO 4217 Currency Code |
| FR Key | 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. Please refer to Section 2.7 for exception note |
| 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 | C | 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 Section 3.1) |
| bIssuerCode | M | 3/16 | Alphanumeric | Beneficiary Account Issuer Code, such as banks, e-wallet operator or mobile operators. (Please refer to Section 3.2) |
| 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 AccountPlease refer to external document “GloRemit API Code List x.xlsx |
| 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 Section 3.4) |
| 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 | Numeric | Beneficiary and Sender Relationship. |
| bAddress | C | 1/50 | Alphanumeric | Beneficiary’s addressRequired 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 codeRequired for PT POS Cash Pickup Transactions (Please refer to Section 3.6) |
| bRegencyCode | C | 1/50 | Alphanumeric | Beneficiary’s regency city codeRequired for PT POS Cash Pickup Transaction (Please refer to Section 3.7) |
| bPayoutID | C | 1/16 | Alphanumeric | Beneficiary’s payout ID or cash pick up codeTo submit the earlier Get_Payoutcode result |
| bPayoutPIN | C | 1/30 | Alphanumeric | Beneficiary’s payout PIN or cash pick up passwordTo submit the earlier Get_Payoutcode result |
| bPurposeCode | M | 1/5 | Numeric | Purpose of the Transaction (Please refer to section 3.9) |
| bNationality | O | 2/5 | Alphanumeric | Beneficiary's Nationality Accept ISO 3166-1 Alpha-2 or Alpha-3 ON |
| 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 | O | 2/2 | Alphanumeric | Origin Country of the transaction initiated Accept ISO 3166-1 Alpha-2 or Alpha-3 ONLY |
Response Description
GloRemit server will return a XML format with response code and GTN transaction number when RSP request is accepted.
1 <?xml version="1.0" encoding="utf-8"?> 2 <string xmlns="http://tempuri.org/"> 3 <TrxStatus>Status</TrxStatus> 4 <GTN>Code</GTN> 5 <transID>Transaction ID</transID> 6 <PayoutPIN>Payout Pin</PayoutPIN> 7 <Description>Description</Description> 8 <LastBal>Balance Value</LastBal> 9 <CurrRate>Currency Rate</CurrRate> 10 </string>
| Parameter Name | Required | Type | Remark |
| TrxStatus | M | Numeric | Transaction status response code. Please see Section 3.5 for full description |
| 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 |
M= Mandatory, C= Conditional, O= Optional