Purpose
This is the method where Partner required to host a status receiver URL on their server to receive the status callback from Tranglo GloRemit once the transaction is processed. Tranglo will post the final status of the transaction to Partner, the status according to the response code. (Please refer to Transaction status)
Tranglo GloRemit will send the transaction status from “Pending” to “In Process” or “Success” or “Failed” for all transaction that is processed by Tranglo GloRemit.
Tranglo will use HTTP POST to send the status callback to Partner. Please make sure the status receiver page is able to ready the posted parameters using HTTP POST method.
Upon successfully received the status callback from Tranglo, partner is required to acknowledge back by return HTTP 200. Tranglo will resend again the status callback after sometime when we not received the acknowledge HTTP 200 with maximum retry of 3 times.
GloRemit Status Callback: Post Parameter
Parameter Name | Required | Type | Min/Max Length | Remark |
checksum | M | String | 200/300 | For checksum security, please follow this format to generate checksum string: SHA-256 (secretKey + transId + GTN + from_balance + To_balance + date+ appKey) * follow the ordering (P.S. security key will provide to TRANGLO by another way, not document) |
app_key | M | String | 60 | (P.S. app key will provide to TRANGLO by another way, not document) |
Date | M | String | Format: dd-mm-yyyy HH:mm:ss It is the API calling datetime from Tranglo side. | |
from_balance | M | String | 1/100 | Pool Balance before transaction. |
to_balance | M | String | 1/100 | Pool Balance after transaction. |
trxStatus | M | String | 3 / 4 | Transaction status. (Please refer to Transaction status) |
transID | M | String | RSP Transaction ID. | |
GTN | M | String | Tranglo GloRemit Transaction ID. | |
GTNMA | O | String | Tranglo GloRemit Manual Adjustment Transaction ID. Will return value when there is an adjustment being posted. | |
txCreateDateTime | M | String | Format: dd-mm-yyyy HH:mm:ss It is the remittance record create date time from Tranglo side | |
txUpdateDateTime | M | String | Format: dd-mm-yyyy HH:mm:ss It is the remittance record update date time from Tranglo side. | |
Description | M | String | 1/100 | Transaction description or advice from Tranglo side. |
PayoutID | C | String | 1/100 | Payout ID from cash out supplier. |
PayoutPin | C | String | 1/100 | Payout PIN from cash out supplier. |
PayoutStatus | C | String | 1/100 | - Claimed - Inprocess - Outstanding - Cancelled |
PayoutStatusUpdateTime | C | String | 1/100 | Format: dd-mm-yyyy HH:mm:ss |
M= Mandatory, C= Conditional, O= Optional