BBPS
  • BBPS
    • BBPS Agent Integration
      • Broad examples of bill payments
      • How a bill is presented
      • FETCH AND PAY
        • Bill fetch api
        • Bill Fetch by bill id api
        • Bill Fetch by client request id api
      • VALIDATE AND PAY
        • Bill validate api
        • Bill Validation response by client request id api
        • Bill validation response by bill id api
      • QUICK PAY
      • COMPLAINT RAISING
      • AGENT APPLICATION
      • BBPS Master Data API
        • List Billers API
        • Billers By ID API
        • Categories Master Data API
        • Contact Master Data API
        • Customer Parameters API
        • Customer Parameters API
        • Customer Parameters Groups API
        • Disposition API
        • Initiating Channel API
      • BBPS Agent API
        • Bill Fetch by bill id
        • Bill Fetch by Client Request ID API
        • Get all Plan categories
        • Get all Plans
        • Bill Validate API
        • Bill Validation response by Client Request ID API
        • Bill validation response by bill id
        • Bill Payment API
        • Transaction Status txnId API
        • Transaction Status ClientReqId API
        • Adding complaint by txnId
        • View Complaints by id
        • View All Complaints
        • Txn Status Check API (401)
        • View Complaints History by id
        • Close Complaint
        • Reopen Complaint
        • Complaint Status
      • Get all Plan categories
      • Get all Plans
    • BBPS Biller Integration
      • BBPS API Workflow
      • BBPS API List
        • BILL FETCH API
        • Bill Fetch Response Endpoint
        • BILL PAY API
          • BillPayment Response Endpoint
          • Payment Notification API
          • Payment Status API
        • BILL VALIDATE API
          • BillValidation Response Endpoint
        • STATUS 402 API
          • TxnStatusResponse Endpoint
      • Bill Fetch by bill id
Powered by GitBook
On this page

Was this helpful?

  1. BBPS
  2. BBPS Biller Integration
  3. BBPS API List

BILL PAY API

PreviousBill Fetch Response EndpointNextBillPayment Response Endpoint

Last updated 1 year ago

Was this helpful?

Bill Pay API is a request that will be sent to the biller portal which contains payment information that is sent from NPCI through the Biller Operating Unit

  • NPCI sends the Bill Payment Request to BOU.

  • BOU forwards the Bill Payment Request to Biller.

  • Biller sends the Bill Payment Request Acknowledgement to BOU, immediately upon receiving the request.

  • After Biller processes the request, the resulting Bill Payment Response is sent to BOU.

  • Once BOU receives the Bill Payment Response, a Bill Payment Response Acknowledgement is sent to Biller.

  • BOU forwards the Bill Payment Response to NPCI.

  • On receiving the Bill Payment Response, NPCI sends Bill Payment Status to BOU.

  • Once BOU receives the Status from NPCI, they send the corresponding notification to Biller.

Bill Pay API is a request that will be sent to the biller portal which contains payment information that is sent from NPCI through the Biller Operating Unit.

Request Parameters

The various parameters are explained below:

Parent Property/Element
Property/Element Name
Mandatory
Data Type
Description

[ROOT]

(No parent property / element)

refId

M

String

Unique identification assigned by the initiating BBPOU to unambiguously identify the transaction which is passed on, unchanged, throughout the entire end-to-end chain, binding the Fetch and Payment messages

txn

M

String

Transaction information, passed throughout the system, visible to all entities of the ecosystem

txnReferenceId

M

String

Transaction reference number used by the Customer for referring to a Payment transaction

ts

M

String

Transaction reference number used by the Customer for referring to a Payment transaction

type

M

String

Type of the message (Forward or Reversal Type)

billerId

M

String

Unique identification code allocated to the Biller.

customerParams

M

Array

Customer bill fetch related details

additionalInfo

M

Array

Additional information parameters sent by the Biller supporting fetch is copied in the payment request.

paymentMethod

M

Object

Payment methods opted by the Customer like quick pay, split pay, OFFUSpay and paymentmode.

amount

M

Object

Amount related details for the payment

amount.Amt

M

Object

Details of the bill payment amount made by the Customer

amount.SplitPayAmount

M

String

Amount paid through the second payment mode

amount.Tag

M

Array

Amount paid by the customer indicating different amount option combinations

tenantId

M

String

OU ID of the request originating BOU

Expected Acknowledgement Parameters

The various parameters are explained below:

Parent Property/Element
Property/Element Name
Mandatory
Mandatory
Description

[ROOT] (No parent property / element)

reason

M

String Min Length – 1, Max Length – 100

Reason of the Status

code

M

String Fixed Length 3

Response code for a request

status

M

String Min Length – 1, Max Length – 100

Status of given request

Json Formatted Request Example


    {
    "refId": "String", "txn": {
    "txnReferenceId": "String", "ts": "String",
    "type": "String",
    },
    "billerId:": "String", "customerParams": [
    {
    ],
    "additionalInfo": [
    {
    "name": "String",
    "value": "String"
    }
    ],
    "paymentMethod": { "quickPay": "String", "splitPay": "String", "offusPay": "String", "paymentMode": "String"
    },
    "amount": {
    "amt": {
    "amount": "String", "custConvFee": "String", "currency": "String"
    },
    "splitPayAmount": "String", "tags": [
    {
    "name": "String",
    "value": "String"
    }
    ]
    },
    "billerResponse": { "customerName": "String", "amount": "String",
    "dueDate": "String", "custConvFee": "String", "billDate": "String", "billNumber": "String", "billPeriod": "String", "tags": [
    {
    "name": "String",
    "value": "String"
    }
    ]
    },
    "tenantId" : "String"
    }

Json Formatted Response Example


    {
    "reason":"String",
    "code":"Integer", "status":"String"
    }