Outbound: Invoice status change

post

https://api-bnpl-wl.sandbox.open-co.tech/x-outbound-webhook-invoice-status

Direction: Outbound (BNPL WL → Partner). This is NOT a callable API endpoint — it documents the payload we send to your configured webhook_url.

Sent to your webhook_url when an invoice changes status after a payment is processed. A single payment may cause multiple invoices to change status; one event is dispatched per affected invoice.

Headers sent:

Header	Description
`Content-Type`	`application/json`
`X-Webhook-Signature`	base64url ECDSA signature of the body (verify with our public key)

Your endpoint must:

Return HTTP 2xx within 10 seconds
Be idempotent (you may receive the same event more than once)

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

webhook_type

string

enum

Allowed:

person_id

uuid

Internal person identifier associated with this invoice

invoice_id

uuid

status

string

enum

New invoice status

Show Details

OPEN	Invoice is open and accepting payments within the billing period
PAID	Invoice has been fully paid
CLOSED	Billing period closed — no new charges accepted; payment is due
OVERDUE_GRACE	Invoice is past due date; normal BNPL limit applies; no fines or interest yet
OVERDUE_PENALTY	Invoice is past due date beyond the grace period; BNPL limit zeroed; fines and interest are being applied
CANCELLED	Invoice has been cancelled

Allowed:

reference_month

string

Billing month this invoice belongs to

due_date

date

Invoice due date

total_amount

double

Total invoice amount

paid_amount

double

Amount already paid

remaining_amount

double

Remaining amount due

changed_at

date-time

Timestamp of the status change

x_webhook_signature

string

Base64url ECDSA-P521-SHA256 signature of the request body. Identical to the X-Webhook-Signature header — included in the body as a convenience for partners whose infrastructure strips custom headers.

Response

200

Your endpoint should return HTTP 2xx to acknowledge receipt

Language

Credentials

Bearer

JWT

URL

Loading…

Response

Click Try It! to start a request and see the response here!