Create an Electronic Challan

POST/api/pay/v1/order/{order_id}/challan

Creates an e-challan for a given order. The challan contains virtual account details that customers can use for payment.

View as Markdown Open in ChatGPT Open in Claude Open in Perplexity

Requires Bearer token. Get token →

Path Parameters

Field	Details
`order_id` `string`required	Unique identifier of the order in the Pine Labs Online database.

Header Parameters

Field	Details
`Request-Timestamp` `string`date-time	ISO 8601 UTC timestamp of the request. Used for idempotency and audit.
`Request-ID` `string`	Use a global unique identifier [GUID] for the request. Constraints Minimum length: 1 characterMaximum length: 50 characters

Request Bodyrequired

Field	Details
`convenience_fee_breakdown` `object`5 nested fields	An object that contains the convenience fee breakdown details.

Response

Field	Details
`challan_id` `string`	Unique identifier of the challan.
`order_id` `string`	Unique identifier of the order.
`virtual_account_id` `string`	Unique customer account identifier.
`account_name` `string`	Account holder's name.
`account_ifsc` `string`	IFSC code of the account.
`account_bank_name` `string`	Name of the bank.
`account_bank_branch` `string`	Branch of the bank.
`challan_pdf_url` `string`	URL to download the challan PDF.
`amount_due` `integer`	Total amount due against the e-challan (in paisa).
`expiry_date` `string`	Date when the e-challan expires.
`created_date` `string`date-time	ISO 8601 UTC timestamp when the challan was created.

Status Codes

`200`	Challan created successfully.
`400`	The request was malformed or missing required fields.

Run

Request

curl --request POST \
  --url https://pluraluat.v2.pinepg.in/api/pay/v1/order/v1-250912053834-aa-a6T94l/challan \
  --header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  --header 'Content-Type: application/json' \
  --header 'Request-ID: a1b2c3d4-e5f6-7890-abcd-ef1234567890' \
  --header 'Request-Timestamp: 2024-10-01T10:30:00Z' \
  --data '{
  "convenience_fee_breakdown": {
    "fee_amount": {
      "value": 1000,
      "currency": "INR"
    },
    "tax_amount": {
      "value": 180,
      "currency": "INR"
    },
    "additional_fee_amount": {
      "value": 0,
      "currency": "INR"
    },
    "maximum_fee_amount": {
      "value": 99999999,
      "currency": "INR"
    },
    "applicable_fee_amount": {
      "value": 1180,
      "currency": "INR"
    }
  }
}'

Status:

{
  "challan_id": "v1-cha-250912053848-aa-xrldQX",
  "order_id": "v1-250912053834-aa-a6T94l",
  "virtual_account_id": "PINEMFGEPXDRCSOKYO7SUQS8",
  "account_name": "Amazon Group",
  "account_ifsc": "UTIB0005717",
  "account_bank_name": "Axis Bank",
  "account_bank_branch": "Axis Bank Branch, CRC Greater Noida West",
  "challan_pdf_url": "https://payins-service-dev.v2.pinepg.in/api/pay/v1/order/v1-250912053834-aa-a6T94l/challan/pdf",
  "amount_due": 1001180,
  "expiry_date": "2025-09-19",
  "created_date": "2025-09-12T05:38:48.260Z"
}