Get Invoice Status

GET/api/pay/v1/orders/{orderId}/invoice

Retrieves the current invoice details and status for a given order. Use this API to check the invoice status after creating an invoice (metadata capture) and/or uploading the invoice file.

Status progression:

INVOICE_CAPTURED → after Create Invoice (Step 1)
INVOICE_UPLOADED → after Upload File (Step 2)
INVOICE_REJECTED → if rejected by bank/payment partner

This API is specific to cross-border orders where invoice documentation is required for compliance.

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

Requires Bearer token. Get token →

Path Parameters

Name	Type	Description
`orderId`	`string`required	Order ID returned from Create Order API.

Response

Name	Type	Description
`invoiceId`	`string`	Unique invoice identifier.
`orderId`	`string`	Order ID associated with this invoice.
`invoiceNumber`	`string`	Invoice number provided during invoice creation.
`invoiceDate`	`string`	Invoice date in YYYY-MM-DD format.
`supplierName`	`string`	Supplier name (if provided during invoice creation).
`status`	`INVOICE_CAPTURED \| INVOICE_UPLOADED \| INVOICE_REJECTED`	Current invoice status. `INVOICE_CAPTUREDINVOICE_UPLOADEDINVOICE_REJECTED`
`createdAt`	`string`	ISO 8601 timestamp of invoice creation.
`updatedAt`	`string`	ISO 8601 timestamp of last status update.

Status Codes

`200`	Invoice status retrieved successfully.
`400`	Validation error.
`401`
`404`	Invoice or order not found.
`500`

Request

curl --request GET \
  --url https://pluraluat.v2.pinepg.in/api/pay/v1/orders/%7BorderId%7D/invoice \
  --header 'Authorization: Bearer YOUR_ACCESS_TOKEN'

Run this request

Bearer token

Path parameters

orderId

200 OK

{
  "invoiceId": "inv-260520225359-ab-XyZ123",
  "orderId": "v1-260520225359-aa-LHy288",
  "invoiceNumber": "v1-260520225359-aa-LHy288-IN",
  "invoiceDate": "2026-05-20",
  "supplierName": null,
  "status": "INVOICE_UPLOADED",
  "createdAt": "2026-05-20T22:53:59.000Z",
  "updatedAt": "2026-05-20T23:01:15.000Z"
}