Create Invoice Payment | Coperniq API

Record a manual payment against an invoice.

Request body

amount: Positive number in dollars
paymentDate: ISO 8601 datetime string
paymentMethod: One of CASH, ACH, CREDIT_CARD, KLARNA, AFFIRM, CHECK
notes (optional)
paymentReference (optional)

Record a manual payment against an invoice. **Request body** - `amount`: Positive number in **dollars** - `paymentDate`: ISO 8601 datetime string - `paymentMethod`: One of `CASH`, `ACH`, `CREDIT_CARD`, `KLARNA`, `AFFIRM`, `CHECK` - `notes` (optional) - `paymentReference` (optional)

Authentication

x-api-keystring

API Key authentication via header

Path parameters

invoiceIdintegerRequired

Invoice identifier

Request

This endpoint expects an object.

amountdoubleRequired

Payment amount in dollars

paymentMethodenumRequired

paymentDatestringRequiredformat: "date-time"

notesstringOptional

Optional notes about the payment

paymentReferencestring or nullOptional

Response

Payment created successfully

idinteger

Payment record identifier

amountdouble

Payment amount in dollars

statusstring

Payment status

paymentMethodstring

Payment method (e.g. CASH, ACH, CREDIT_CARD, CHECK)

invoiceNumberinteger or null

Payment display number (when present)

paymentDatestring or nullformat: "date-time"

When the payment was recorded (ISO 8601); null if absent from upstream

paymentReferencestring or null

notesstring or null

isExternalboolean or null

Whether the payment originated from an external processor (e.g. Stripe)

createdAtstring or nullformat: "date-time"

updatedAtstring or nullformat: "date-time"

createdByobject or null

Errors

400

Bad Request Error

401

Unauthorized Error

404

Not Found Error

1	const url = 'https://api.coperniq.io/v1/invoices/1/payments';
2	const options = {
3	method: 'POST',
4	headers: {'x-api-key': '<apiKey>', 'Content-Type': 'application/json'},
5	body: '{"amount":1.1,"paymentMethod":"CASH","paymentDate":"2024-01-15T09:30:00Z"}'
6	};
7
8	try {
9	const response = await fetch(url, options);
10	const data = await response.json();
11	console.log(data);
12	} catch (error) {
13	console.error(error);
14	}

1	{
2	"id": 1,
3	"amount": 1.1,
4	"status": "string",
5	"paymentMethod": "string",
6	"invoiceNumber": 1,
7	"paymentDate": "2024-01-15T09:30:00Z",
8	"paymentReference": "string",
9	"notes": "string",
10	"isExternal": true,
11	"createdAt": "2024-01-15T09:30:00Z",
12	"updatedAt": "2024-01-15T09:30:00Z",
13	"createdBy": {
14	"id": 1,
15	"firstName": "string",
16	"lastName": "string"
17	}
18	}