Pine LabsDOCS
Create Account

Capture Invoice

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

Captures invoice metadata for a cross-border order.

After a successful payment, the merchant must submit the invoice information for the transaction to proceed with cross-border settlement. This is applicable for both B2B and B2C cross-border orders.

Note: This API creates the invoice metadata (number, date, supplier). The actual file upload is done separately via the Upload Invoice File API.

View as MarkdownOpen in ChatGPTOpen in ClaudeOpen in Perplexity
Requires Bearer token. Get token →

Path Parameters

NameTypeDescription
orderId
stringrequired

The order ID for which the invoice is being uploaded. Must be a valid Cross Border Import order belonging to the merchant.

Request Body

NameTypeDescription
invoice_number
stringrequired

The invoice number/identifier for the transaction.

invoice_date
stringrequired

The date of the invoice in YYYY-MM-DD format (ISO 8601 date).

supplier_name
string

Name of the supplier/merchant on the invoice.

Status Codes

202Invoice created successfully.
400Validation error.
401Authentication failed — missing, expired, or invalid Bearer token.
422Order not eligible for invoice capture.
500An unexpected error occurred on the server.
Request
curl -X POST "https://api.pluralpay.in/api/pay/v1/orders/{orderId}/invoice" \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "invoice_number": "v1-260520225359-aa-LHy288-IN",
  "invoice_date": "2026-05-20"
}'

Run this request

orderId
202 Accepted
{
  "invoice_id": "inv-260520225359-ab-XyZ123",
  "order_id": "v1-260520225359-aa-LHy288",
  "invoice_number": "v1-260520225359-aa-LHy288-IN",
  "invoice_date": "2026-05-20",
  "supplier_name": null,
  "status": "INVOICE_CAPTURED"
}