PT EN

Imputações de pagamentos

URL base: $BUSINESS_API

O objecto

idstring · obrigatório
tenant_idstring · obrigatório
payment_idstring · obrigatório
invoice_idstring · obrigatório
invoice_numberstring · opcional

The invoice's display number

invoice_statusstring · opcional

The invoice's current status, read when the response is written; omitted when the invoice cannot be read

amount_centsinteger (int64) · obrigatório
currencystring · obrigatório
account_idstring · opcional
account_numberstring · opcional
account_holder_namestring · opcional
customer_idstring · opcional
customer_namestring · opcional
created_atstring (date-time) · obrigatório
reversed_atstring (date-time) · opcional
O objecto
{
  "id": "pay_2F9MkvJqchhA2HP0mRBY6Lry6lf",
  "tenant_id": "ten_2ugFXIC316WXzGu1HGal90AxTA6",
  "payment_id": "pay_2eUBfC8BJA6JLIoHrQwtN0GL1mW",
  "invoice_id": "inv_2jnourvAGxXMMd5IyFbwc1LqUX1",
  "invoice_number": "INV-2026-000142",
  "invoice_status": "invoice status",
  "amount_cents": 125000,
  "currency": "MZN",
  "account_id": "act_2JFioNDgIfvkgflk8RtcqhBaARP",
  "account_number": "ACC-2026-000142",
  "account_holder_name": "Ana Matsinhe",
  "customer_id": "cus_2UuXtOGTHWKlvkoF5so5Joi3Hck",
  "customer_name": "Ana Matsinhe",
  "created_at": "2026-11-19T09:30:00Z",
  "reversed_at": "2026-11-19T09:30:00Z"
}

Listar imputações de pagamentos

Registos

GET /payment-allocations

Each allocation carries the target invoice's number and current status (invoice_status), read in one batched lookup per response, so clients can filter allocations by invoice state without paging the invoice list.

Parâmetros

limitinteger · consulta · opcional

Maximum resources to return (default 20, maximum 100).

afterstring · consulta · opcional

Opaque cursor returned by the previous page.

payment_idstring · consulta · opcional

Optional payment ID; when set, only the allocations of that payment are returned.

invoice_idstring · consulta · opcional

Optional invoice ID; when set, only the allocations applied to that invoice are returned.

Devolve

200 Payment allocations in the authenticated utility tenant

Mostrar atributos
dataarray of PaymentAllocation · obrigatório
Mostrar atributos filhos
idstring · obrigatório
tenant_idstring · obrigatório
payment_idstring · obrigatório
invoice_idstring · obrigatório
invoice_numberstring · opcional

The invoice's display number

invoice_statusstring · opcional

The invoice's current status, read when the response is written; omitted when the invoice cannot be read

amount_centsinteger (int64) · obrigatório
currencystring · obrigatório
account_idstring · opcional
account_numberstring · opcional
account_holder_namestring · opcional
customer_idstring · opcional
customer_namestring · opcional
created_atstring (date-time) · obrigatório
reversed_atstring (date-time) · opcional
has_moreboolean · obrigatório
next_cursorstring · opcional

Permissões payments:read · Funções: admin, analyst, billing_clerk, customer_service, finance, owner, viewer

curl -X GET "$BUSINESS_API/payment-allocations" \
  -H "Authorization: Bearer sk_test_..."
Resposta 200
{
  "data": [
    {
      "id": "pay_2F9MkvJqchhA2HP0mRBY6Lry6lf",
      "tenant_id": "ten_2ugFXIC316WXzGu1HGal90AxTA6",
      "payment_id": "pay_2eUBfC8BJA6JLIoHrQwtN0GL1mW",
      "invoice_id": "inv_2jnourvAGxXMMd5IyFbwc1LqUX1",
      "invoice_number": "INV-2026-000142",
      "invoice_status": "invoice status",
      "amount_cents": 125000,
      "currency": "MZN",
      "account_id": "act_2JFioNDgIfvkgflk8RtcqhBaARP",
      "account_number": "ACC-2026-000142",
      "account_holder_name": "Ana Matsinhe",
      "customer_id": "cus_2UuXtOGTHWKlvkoF5so5Joi3Hck",
      "customer_name": "Ana Matsinhe",
      "created_at": "2026-11-19T09:30:00Z",
      "reversed_at": "2026-11-19T09:30:00Z"
    }
  ],
  "has_more": true,
  "next_cursor": "next cursor"
}