Bill Payment

5 min

Introduction

The Bill Payment API is called after fetchBiller API fetches the amount and payment mode selected by the user.

Request

Production

curl --location --request POST 'https://api.signzy.app/api/v3/postpaidBillPay' \
--header 'Authorization: ...Auth...' \
--header 'Content-Type: application/json' \
--header 'Client-Id: <token>' \
--header 'Client-Secret: <token>' \
--data-raw '
 {
  "amount": "1125",
  "billerId": "KSEBL0000KER01",
  "billerName": "Kerala State Electricity Board Ltd. (KSEBL)",
  "category": "ELECTRICITY",
  "customerMobile": "962XXXX",
  "customerName": "RXXXX XX",
  "merchantTrxnRefId": "fp840h05ert82b43c79abbbote0he8drecz",
  "paramName": "Consumer Number",
  "paramValue": "11655490XXXXX",
  "paymentMode": "WALLET",
  "optional": "SFASF",
  "quickPay": "false",
  "remark": "test",
  "serviceName": "ELECTRICITY",
  "paymentInfo": " ",
  "splitPay": "false",
  "splitPayAmount": " "
 }
'

Key	Type	Parameter Description
amount	String	amount is given by fetchBillerApi
billerId	String	billerId is given by getBillerDetails Api.
billerName	String	billerName is given by fetchBiller Api.
category	String	category is given by getBillerList Api .
customerMobile	String	Pass Customer Mobile Number
customerName	String	Pass Customer Name
merchantTrxnRefId	String	fetchRefrenceId is given by fetchBiller Api with key name refId
paramName	String	paramName is given by fetchBiller Api.
paramValue	String	paramValue is customerMobile in Mobile Recharge Case.
PaymentMode	String	Pass WALLET or UPI
optional	String	String
quickPay	String	Pass false or true
remark	String	Pass Payment Note
serviceName	String	Pass category

Response

{
    "result": {
        "billerId": "JIOPREPAID",
        "amount": 10,
        "code": "0x0200",
        "billerReferenceNumber": "BR0008F1EZ9W",
        "description": "Success",
        "billDate": "2022-10-17",
        "paramName": "MobileNumber",
        "merchantTrxnRefId": "fp840h05ert82b43c79abbbote0he8drecz",
        "txnReferenceId": "1010100000268563",
        "trxn_id": "WDB1666000068663",
        "refId": "FIDYTaxjaNzGmBHqhPJJJqjYWdJ22901517",
        "paramValue": "7012235949",
        "status": "Success"
    }
}

Key	Type
billerId	String
amount	String
code	String
billerReferenceNumber	String
description	String
billDate	String
refId	String
paramName	String
merchantTrxnRefId	String
txnReferenceId	String
paramValue	String
trxn_id	String

POST https ://api.signzy.app/api/v3/postpaidBillPay

Error Codes

200	All response details are valid
40x	not found, bad request, conflict