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.

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.
401
422Order not eligible for invoice capture.
500
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
New chat
Responses are generated using AI and may contain mistakes.
Hi! I'm Pine, your AI developer assistant. Ask me anything about Pine Labs APIs, integrations, or troubleshooting.

Tip: you can create a new chat with ⌘ + E