# Capture Invoice

**Method:** `POST`

**Path:** `/api/pay/v1/orders/{orderId}/invoice`

**Category:** International Payments

**Authentication:** Required

## Description

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.


## Path Parameters

- `orderId` (`string`) **required** — The order ID for which the invoice is being uploaded. Must be a valid Cross Border Import order belonging to the merchant.

## Request Body

Content-Type: `application/json`

- `invoice_number` (`string`) **required** — The invoice number/identifier for the transaction.
- `invoice_date` (`string`) **required** — The date of the invoice in YYYY-MM-DD format (ISO 8601 date).
- `supplier_name` (`string`) — Name of the supplier/merchant on the invoice.

### Example Request

```json
{
  "invoice_number": "v1-260520225359-aa-LHy288-IN",
  "invoice_date": "2026-05-20",
  "supplier_name": "Acme Electronics Pvt Ltd"
}
```

## Responses

- `202` — Invoice created successfully.
- `400` — Validation error.
- `401` — 
- `422` — Order not eligible for invoice capture.
- `500` — 

---

Reference: https://localhost:3000/api/international-payments/capture-invoice