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 Bill Inquiry (REST) 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.

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 "AuthorizationGLOREMIT <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
UIDM5/50AlphanumericUsername for validation.
PWDM5/50AlphanumericPassword for validation, 3DES encrypted.
rspSignM32/50AlphanumericDigital signature of RSP.
(Please refer to Digital signature)
UIDBranchO1/16NumericRSP branch identifier.
If no branch ID, value as NULL.
transIDM6/16Alphanumeric 6 digits or more unique transaction ID from RSP.
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.
sFirstNameM1/100AlphanumericSender’s first name.
(max 100 characters)
sLastNameO1/100AlphanumericSender’s last name.
(max 100 characters)
sIdTypeO1/30NumericSender Identification Type.
(Please refer to Sender)
sIdNumO8/50AlphanumericSender Identification Number.
sIdExpiryO10/10StringSender ID Expiry Date.
Date 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
(Please refer to ISO 3166 Country Code)
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.
Accept ISO 3166-1 Alpha-2 ONLY
(Please refer to ISO 3166 Country Code)
bCurrencyM3/6AlphanumericBill Currency Code.
(Please refer to ISO 4217 Currency Code)
bAmountM1/16NumericTotal amount to pay for the bill.
bIssuerCodeM3/16AlphanumericBiller Issuer Code.
(Please refer to Service Spec)
bAccNumM1/18AlphanumericBill Account Number or any other unique account identifier as determined by biller.
bBillNumO1/50AlphanumericBill Number.
bAccNameM1/30AlphanumericBill AccountName.
bStatementDateO10/10AlphanumericStatement Date.
Date Format: MM/dd/YYYY
(if no information is available, enter default value as current date)
bDueDateO10/10AlphanumericStatement Due Date.
Date Format: MM/dd/YYYY
(if no information is available, enter default value as current date)
bBillTypeO1/50AlphanumericBill Type.
(Please refer to GloRemit API Code List)
bCustomInfo1O1/50AlphanumericBill Custom Information 1.
bCustomInfo2O1/50AlphanumericBill Custom Information 2.
bCustomInfo3O1/50AlphanumericBill Custom Information 3.
bCustomInfo4O1/50AlphanumericBill Custom Information 4.
bCustomInfo5O1/50AlphanumericBill Custom Information 5.
bCustomInfo6O1/50AlphanumericBill Custom Information 6.
bCustomInfo7O1/50AlphanumericBill Custom Information 7.
bCustomInfo8O1/50AlphanumericBill Custom Information 8.
bCustomInfo9O1/50AlphanumericBill Custom Information 9.
bCustomInfo10O1/50AlphanumericBill Custom Information 10.
sOriginCountry M2/2 Alphanumeric Origin Country of the transaction initiated.
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":"G0917311424999",
    "transID":"1211",
    "Description":"Transaction Pending",
    "LastBal":"88174269.73",
    "CurrRate":"11.19970000"
}
Parameter NameRequiredTypeRemark
TrxStatusMNumericTransaction status response code.
(Please refer to Transaction status)
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.

M= Mandatory, C= Conditional, O= Optional