Get Cross-Border 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

Field	Details
`orderId` `string`required	Order ID returned from Create Order API.

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

Response

Field	Details
`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`nullable	Supplier name (if provided during invoice creation).
`status` `string`	Current invoice status. Allowed values: `INVOICE_CAPTUREDINVOICE_UPLOADEDINVOICE_REJECTED`
`createdAt` `string`date-time	ISO 8601 timestamp of invoice creation.
`updatedAt` `string`date-time	ISO 8601 timestamp of last status update.

Status Codes

`200`	Invoice status retrieved successfully.
`400`	Validation error.
`401`	Authentication failed — missing, expired, or invalid Bearer token.
`404`	Invoice or order not found.
`500`	An unexpected error occurred on the server.

Run

Request

curl --request GET \
  --url https://pluraluat.v2.pinepg.in/api/pay/v1/orders/v1-260520225359-aa-LHy288/invoice \
  --header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  --header 'Request-ID: a1b2c3d4-e5f6-7890-abcd-ef1234567890' \
  --header 'Request-Timestamp: 2024-10-01T10:30:00Z'

Status:

{
  "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"
}