Virtual Private Network
The first network connectivity preference would be using VPN. Please ensure your VPN firewall support the following protocol.
Fixed IP Address
The second connectivity method is via Partner’s fixed IP address to be approved inside GloRemit network firewall. Partner should also obtain a Client Authentication SSL certificate to properly identify the identity of the Partner source IP. Partner is required to prepare the following during network connectivity test.
- Partner Fixed IP Address: <To be notified by Partner>
- Client Authentication Certificate in Base64 DER Encoded files
- Client Authentication CA Certificate in Base64 DER Encoded files
Digital Signature
The second connectivity method is via Partner’s Partner MUST use digital signature to connect to GloRemit API. Digital signature schemes can be used for Partner authentication and non-repudiation. RSP partner who wants to send a message computes a digital signature of this remittance message and then sends this digital signature together with the message to GloRemit API.
Tranglo implements MD5 message digest hashing algorithm for digital signature. Tranglo shall issue partner a key for message digest.
Establishment of Digital Signature
The message sender shall do the following
- The required message component value is concatenated into 1 string.
- Add the key issued by Tranglo at the end of the string.
- Hash the concatenated message component with MD5 algorithm.
- The results of the above step shall form the Signature value in the rspSign parameters in all GloRemit SOAP method or REST API [Authorization] header.
Required Message Component
The following message components concatenated for hashing to form digital signature. Please concatenate the value of the parameters as listed below.
Parameter Name | Value |
Get_Validation Method | Request UID transID sIDNumb AccType bAccNum bIssuerCode |
Do_Transfer Method Request | Request UIDtran sIDtrxValue (Format: #.## - 2 decimal points without commas) sCurr sIDNum sFirstName sLastName bCurrency bIDNum bFirstName bLastNum bAccType bAccNum bIssuerCode |
Get_Forex Method | Request UID currFrom currTo |
Get_TransferStatus Method | Request UID GTN TransID (if any) |
Do_BillInquiry Method | Request UID transID sIDNum bAccNum bIssuerCode |
Do_BillPayment Method | Request UIDtran sIDtrxValue (Format: #.## - 2 decimal points without commas) sCurr sIDNum sFirstName sLastName bCurrency bAccNum bIssuerCode |
Do_ChangeName | UID Transid bFirstName bLastName |
Get_ChangeNameStatus | UID changeid |
Do_Cancellation | UID GTN transID |
Get_CancellationStatus | UID Cancellationid |
Get_PayoutCode | UID countrycode requestid |