List every merchant’s invoices in the organization
The buyer’s org-wide receivables roll-up, newest first. Each row carries its merchant_id. Requires the org-scoped org:merchants:read permission, checked on the organization resource in the authorization provider (tokens carry no permissions).
Authorization
oauth2 Create a client with POST /v1/oauth/clients, then exchange its credentials for an access token. AUTHORIZATION_CODE clients act on behalf of a signed-in user and always use PKCE; CLIENT_CREDENTIALS clients act as themselves. A client may only be granted scopes its creator already holds — read the grantable list from GET /v1/oauth/clients/scopes.
In: header
Query Parameters
Page size from 1 to 100. Defaults to 20.
^\d+$Opaque cursor for the next page, taken from links.next. Mutually exclusive with before.
Opaque cursor for the previous page, taken from links.prev. Mutually exclusive with after.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/v1/financing/invoices"{ "data": [ { "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "document_id": "b792e8ae-2cb4-4209-85b9-32be4c2fcdd6", "attached_document_ids": [ "2daa2194-1f27-4d7b-a37c-8fc5cf0db85c" ], "deductions": [ { "id": "string", "kind": "VAT", "label": "string", "basis": "BASIS_POINTS", "basis_points": 0 } ], "vat": { "basis": "RATE", "rate_basis_points": 1, "paid": true }, "rejection_reason": "DUPLICATE_INVOICE", "rejection_note": "string", "rejected_by": "string", "rejected_at": "2019-08-24T14:15:22Z", "amount_minor_units": 250000, "currency": "KES", "details": { "property1": null, "property2": null }, "due_date": "2019-08-24", "issued_date": "2019-08-24", "status": "PENDING", "created_at": "2019-08-24T14:15:22Z", "merchant_id": "string" } ], "links": { "next": "string", "prev": "string" }}{ "code": "INVALID_PARAMS", "description": "user_id must be a UUID", "identifier": "string", "invalid_params": [ { "path": "user_id", "reason": "must be a UUID", "sub_code": "string" } ]}{ "code": "INVALID_PARAMS", "description": "user_id must be a UUID", "identifier": "string", "invalid_params": [ { "path": "user_id", "reason": "must be a UUID", "sub_code": "string" } ]}{ "code": "INVALID_PARAMS", "description": "user_id must be a UUID", "identifier": "string", "invalid_params": [ { "path": "user_id", "reason": "must be a UUID", "sub_code": "string" } ]}{ "code": "INVALID_PARAMS", "description": "user_id must be a UUID", "identifier": "string", "invalid_params": [ { "path": "user_id", "reason": "must be a UUID", "sub_code": "string" } ]}{ "code": "INVALID_PARAMS", "description": "user_id must be a UUID", "identifier": "string", "invalid_params": [ { "path": "user_id", "reason": "must be a UUID", "sub_code": "string" } ]}Accept a refinance offer POST
Closes the refinanced loan and opens the replacement loan in one step. A repeated request returns the completed offer. Returns 404 `REFINANCING_NOT_FOUND` for an offer of another user, an offer for another loan, or an offer that no reviewer approved. Returns 409 `REFINANCING_NOT_ALLOWED` when the offer expired or the loan changed after the offer. Returns the same error when a manual block is on the borrower or on the loan.
Create a supplier merchant in sales-app POST
Deprecated: use POST /v1/merchants with business_name, email and phone_number. Creates public.merchants with a database-generated id. Requires org:merchants:write on the caller’s organization. Organization scope comes only from the bearer token. Reuse idempotency_key with identical details to recover the same id after a timeout or a downstream failure. A changed payload returns 409. Core must mirror the returned id before payout registration and invitation; this operation does not create a Core merchant or a WorkOS grant.