Bills: Bill Payment

Partners use this method to initiate and confirm the bill payment operation via GloRemit. The method is non-reversible and committed in real-time. Whenever applicable, Partners should use Do_BillInquiry (See section 2.9) to retrieve bill information before using this method to ensure highest success rate. As different billers may have additional information requirements, Partners may have to send additional information in the form of CustomInfo, please refer to Appendix 2 for complete list.

Definition:

POST v1/payments/bills

Sample Request:

curl -v -X POST http://staging-gloremit.tranglo.com:2014/v1/payments/bills \
-H "Content-Type: application/json" \
-H "Authorization: GLOREMIT <UID>:<PWD> :<rspSign>" \
-d '{
      "UIDBranch": "",
      "transID": "1210",
      "sFirstName": "Kai",
      "sLastName": "Yen",
      "sIdType": 1,
      "sIdNum": "710320-71-5379",
      "sIdExpiry": "",
      "sContactNum": "",
      "sEmail": "",
      "sCountry": "MY",
      "sCurrency": "MYR",
      "bCountry": "PH",
      "bCurrency": "PHP",
      "bAmount": "100",
      "bIssuerCode": "61101",
      "bAccNum": "123",
      "bBillNum": "",
      "bAccName": "",
      "bStatementDate": "",
      "bDueDate": "",
      "bBillType": "",
      "bCustomInfo1": "",
      "bCustomInfo2": "",
      "bCustomInfo3": "",
      "bCustomInfo4": "",
      "bCustomInfo5": "",
      "bCustomInfo6": "",
      "bCustomInfo7": "",
      "bCustomInfo8": "",
      "bCustomInfo9": "",
      "bCustomInfo10": ""
}'

Request Description

Parameter NameRequiredMin/Max LengthTypeRemark
rspSignM32/50AlphanumericDigital signature of RSP
UIDM5/50AlphanumericUsername for validation
PWDM5/50AlphanumericPassword for validation
UIDBranchO1/16NumericRSP branch identifier. If no branch ID, value as NULL
transIDM6/16Alphanumeric6 digits or more unique transaction ID from RSP on 7 day basis. Duplicated ID within 7 calendar days (GMT +8 timezone) will be declined.
sFirstNameM1/100AlphanumericSender’s first name
sLastNameM1/100AlphanumericSender’s last name
sIdTypeO1/30NumericSender Identification Type.(Please refer to Section 3.3)
sIdNumO8/50AlphanumericSender Identification Number.
sIdExpiryO10/10StringSender ID Expiry DateDate Format:MM/dd/YYYY
sContactNumO8/30NumericSender Contact Number. Please specify in Country code + MSISDN format. For e.g. Indonesia = 628123456789.
sEmailO1/50AlphanumericSender email address.
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
sCurrencyM3/6AlphanumericRSP Currency Code as per RSP GSVA Wallet. Do not send as Sender currency Please refer to ISO 4217 Currency Code.
bCountryM2/5AlphanumericBiller’s Country.
bCurrencyM3/6AlphanumericBill Currency Code. Please refer to ISO 4217 Currency Code.
bAmountM1/16NumericTotal amount to pay for the bill.Please refer to Section 2.7 for exception note
bIssuerCodeM3/16AlphanumericBiller Issuer Code(Please refer to Appendix 2)
bAccNumM1/18AlphanumericBill Account Number or any other unique account identifier as determined by biller
bBillNumO1/50AlphanumericBill Number
bAccNameM1/30AlphanumericBill AccountName
bStatementDateO10/10AlphanumericStatement DateDate Format: MM/dd/YYYY (if no information is available, enter default value as current date)
bDueDateO10/10AlphanumericStatement Due DateDate Format: MM/dd/YYYY (if no information is available, enter default value as current date)
bBillTypeO1/50AlphanumericBill Type(Please refer to Appendix 2)
bCustomInfo1O1/50AlphanumericBill Custom Information 1(Please refer to Appendix 2)
bCustomInfo2O1/50AlphanumericBill Custom Information 2(Please refer to Appendix 2)
bCustomInfo3O1/50AlphanumericBill Custom Information 3(Please refer to Appendix 2)
bCustomInfo4O1/50AlphanumericBill Custom Information 4(Please refer to Appendix 2)
bCustomInfo5O1/50AlphanumericBill Custom Information 5(Please refer to Appendix 2)
bCustomInfo6O1/50AlphanumericBill Custom Information 6(Please refer to Appendix 2)
bCustomInfo7O1/50AlphanumericBill Custom Information 7(Please refer to Appendix 2)
bCustomInfo8O1/50AlphanumericBill Custom Information 8(Please refer to Appendix 2)
bCustomInfo9O1/50AlphanumericBill Custom Information 9(Please refer to Appendix 2)
bCustomInfo10O1/50AlphanumericBill Custom Information 10(Please refer to Appendix 2)

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":"G0917311424999",
    "transID":"1211",
    "Description":"Transaction Pending",
    "LastBal":"88174269.73",
    "CurrRate":"11.19970000"
}
Parameter NameRequiredTypeRemark
TrxStatusMNumericTransaction status response code. Please see Section 3.5 for full description
GTNMAlphanumericTransaction GTN number (14 digit)
transIDMAlphanumericUnique Transaction ID from RSP
DescriptionMAlphanumericTransaction description or advice
LastBalMNumericThe latest balance of RSP e-wallet
CurrRateMNumericThe transaction currency rate