Skip to main content
POST
Record invoice payment

Authorizations

Authorization
string
header
required

API key authentication via Bearer token

Headers

idempotency-key
string
required

Key that makes this request safe to retry. Reuse the same value when retrying a request that may already have succeeded — the original response is replayed with an Idempotency-Replay: true header. Use a new value for a new operation.

Required string length: 1 - 255
Example:

"9f8c2b1a-4d3e-4a6b-8c1d-2e3f4a5b6c7d"

Path Parameters

id
string<uuid>
required

Invoice UUID

Example:

"123e4567-e89b-12d3-a456-426614174000"

Body

application/json
amountCents
integer
required
Required range: x <= 9007199254740991
paidAt
string<date-time>

Timestamp when the payment was received. Timestamps more than five minutes in the future are rejected.

Example:

"2026-08-30T12:00:00.000Z"

note
string | null

Response

Invoice payment recorded successfully

data
object
required
meta
object
Last modified on August 30, 2026