Recharge Status

Query the current status of a previously initiated recharge transaction using the partner order ID (order_id).

Endpoint: /v1/recharge/status
Method: GET
Authentication: Required (Basic Auth via Header or Query Parameter)

Query Parameters

Parameter	Type	Required	Description
`order_id`	string	Yes	The unique order ID (`p_order_id`) you supplied when creating the transaction.
`authorization`	string	Optional	Can be used to authenticate the request if the `Authorization` header is not present (e.g. `Basic <base64_credentials>`).

URL Example

GET https://api.originbills.in/v1/recharge/status?order_id=PARTNER_TXN_998877

Response Scenarios

1. Success Status (200 OK)

Returned when the recharge transaction has completed successfully.

{
  "success": true,
  "status": "success",
  "orderId": "PARTNER_TXN_998877",
  "operatorRefId": "REF1234567890",
  "message": "Recharge completed successfully",
  "data": {
    "number": "1234567890",
    "amount": 100,
    "operator_id": "1",
    "operator_name": "Jio Mobile",
    "debit_amount": "97.50",
    "opening_bal": "15450.75",
    "closing_bal": "15353.25",
    "order_id": "7662d558-86d1-4d37-8e68-07e052445b23",
    "partner_order_id": "PARTNER_TXN_998877",
    "operator_ref_id": "REF1234567890",
    "commission_amount": "2.50",
    "timestamp": "2026-07-10 18:43:47"
  }
}

2. Pending Status (200 OK)

Returned when the recharge is still in progress with the provider.

{
  "success": true,
  "status": "pending",
  "orderId": "PARTNER_TXN_998877",
  "message": "Recharge is pending processing",
  "data": {
    "number": "9876543210",
    "amount": 100,
    "operator_id": "1",
    "operator_name": "Jio Mobile",
    "debit_amount": "97.50",
    "opening_bal": "15450.75",
    "closing_bal": "15350.75",
    "order_id": "7662d558-86d1-4d37-8e68-07e052445b23",
    "partner_order_id": "PARTNER_TXN_998877",
    "operator_ref_id": null,
    "commission_amount": "2.50",
    "timestamp": "2026-07-10 18:43:47"
  }
}

3. Failed Status (400 Bad Request)

Returned when the recharge transaction has failed. Funds will be refunded back into the customer’s wallet.

{
  "success": false,
  "status": "failed",
  "orderId": "PARTNER_TXN_998877",
  "message": "Recharge failed",
  "data": {
    "number": "9876543210",
    "amount": 100,
    "operator_id": "43",
    "operator_name": "Jio",
    "debit_amount": "97.50",
    "opening_bal": "15450.75",
    "closing_bal": "15450.75",
    "order_id": "7662d558-86d1-4d37-8e68-07e052445b23",
    "partner_order_id": "PARTNER_TXN_998877",
    "operator_ref_id": null,
    "commission_amount": "2.50",
    "timestamp": "2026-07-10 18:43:47"
  }
}

Response Fields Reference

Field	Type	Description
`success`	boolean	Overall transaction outcome flag.
`status`	string	Current transaction status (`success`, `pending`, or `failed`).
`orderId`	string	The partner order ID (`p_order_id`) queried.
`operatorRefId`	string \| null	Reference ID returned by the telecom operator (null if pending or failed).
`data.number`	string	The mobile number target for the recharge.
`data.amount`	float	The original recharge amount.
`data.operator_name`	string	Name of the mobile operator/biller.
`data.debit_amount`	string	Net amount debited from your wallet (`amount - commission_amount`).
`data.opening_bal`	string	Wallet balance before the transaction occurred.
`data.closing_bal`	string	Wallet balance after status resolution (fully refunded if failed).
`data.commission_amount`	string	Commission earned from the recharge.
`data.timestamp`	string	Date and time when the transaction was created (IST).

Validation Errors

Missing Order ID (400 Bad Request)

{
  "error": "order_id query parameter is required"
}

Transaction Not Found (404 Not Found)

{
  "error": "Transaction not found"
}

Getting Started

Balance API

Recharge API

BBPS API

Query Parameters

URL Example

Response Scenarios

1. Success Status (200 OK)

2. Pending Status (200 OK)

3. Failed Status (400 Bad Request)

Response Fields Reference

Validation Errors

Missing Order ID (400 Bad Request)

Transaction Not Found (404 Not Found)

​Query Parameters

​URL Example

​Response Scenarios

​1. Success Status (200 OK)

​2. Pending Status (200 OK)

​3. Failed Status (400 Bad Request)

​Response Fields Reference

​Validation Errors

​Missing Order ID (400 Bad Request)

​Transaction Not Found (404 Not Found)

Query Parameters

URL Example

Response Scenarios

1. Success Status (200 OK)

2. Pending Status (200 OK)

3. Failed Status (400 Bad Request)

Response Fields Reference

Validation Errors

Missing Order ID (400 Bad Request)

Transaction Not Found (404 Not Found)