Skip to main content
POST
/
bbps
/
cou
/
v1
/
billers
/
response
/
bill-payment
Bill Payment Response (Polling)
curl --request POST \
  --url https://sandbox.cashfree.com/bbps/cou/v1/billers/response/bill-payment \
  --header 'Content-Type: application/json' \
  --header 'x-client-id: <api-key>' \
  --header 'x-client-secret: <api-key>' \
  --data '
{
  "bill_fetch_ref_id": "REF20240501ABC123",
  "transaction_ref_id": "TXN20240501XYZ789"
}
'
{
  "status": "success",
  "message": "Payment is still being processed",
  "data": {
    "status": "processing",
    "response": {
      "bill_payment_response": {
        "head": {
          "bill_fetch_ref_id": "REF20240501ABC123"
        },
        "reason": {
          "response_code": "PENDING",
          "response_reason": "Processing"
        },
        "txn": {
          "transaction_ref_id": "TXN20240501XYZ789"
        }
      }
    }
  }
}

Documentation Index

Fetch the complete documentation index at: https://www.cashfree.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
x-client-id
string
header
required

Your unique client identifier issued by Cashfree. You can find this in your Merchant Dashboard.

​
x-client-secret
string
header
required

Your unique client secret issued by Cashfree. Keep this confidential and never expose it in client-side code. You can find this in your Merchant Dashboard.

Body

application/json

Request parameters to poll a bill payment request.

​
bill_fetch_ref_id
string
required

Ref ID from the Bill Payment Request API (data.bill_fetch_ref_id).

Example:

"REF20240501ABC123"

​
transaction_ref_id
string
required

Transaction ref ID from the Bill Payment Request API (data.transaction_ref_id).

Example:

"TXN20240501XYZ789"

Response

Success response for polling a bill payment request.

​
status
string

API call status. This is always "success".

Example:

"success"

​
message
string
Example:

"Payment successful"

​
data
object