Skip to main content
GET
/
bbps
/
biller
/
bill
/
status
/
{bbps_transaction_id}
Check Transaction Status
curl --request GET \
  --url https://sandbox.cashfree.com/bbps/biller/bill/status/{bbps_transaction_id} \
  --header 'Content-Type: <content-type>' \
  --header 'x-client-id: <x-client-id>' \
  --header 'x-client-secret: <x-client-secret>'
"{\n  \"bbps_transaction_id\": \"test40624\",\n  \"bill_payment_status\": \"SUCCESS\",\n  \"settlement_status\": \"SETTLED\",\n  \"settlement_utr\": \"DUMMYUTR\",\n  \"settlement_amount\": 1,\n  \"settlement_time\": \"2024-07-30 11:39:42\"\n}"

Headers

​
x-client-id
string
required

Client ID provided by Cashfree.

Example:

"your_client_id"

​
x-client-secret
string
required

Client secret key provided by Cashfree.

Example:

"your_client_secret"

​
Content-Type
string
required

The content type for the request should be application/json.

Example:

"application/json"

Path Parameters

​
bbps_transaction_id
string
required

Unique identifier for the transaction (BBPS transaction ID).

Example:

"test40624"

Response

200

​
bbps_transaction_id
string

Unique BBPS transaction ID for the request.

​
bill_payment_status
enum<string>

Current status of the transaction (e.g. SUCCESS, PENDING, FAILED).

Available options:
SUCCESS,
PENDING,
FAILED
​
settlement_status
string

Status of the settlement (SETTLED or null).

​
settlement_utr
string

Unique transaction reference number of the settlement.

​
settlement_amount
integer

Amount of the settlement.

​
settlement_time
string<date-time>

Time of the settlement.