PT EN

Meios de pagamento

URL base: $BUSINESS_API

O objecto

codestring · obrigatório

Method code sent when recording the payment.

labelstring · opcional

The utility's own name for the channel (the operator's label, or a neutral sample label in a test account), when a channel of this type has one; never derived from the code.

channelstring · opcional

Collection channel type the method comes from.

sourcestring · obrigatório

um de channel, connector

requires_referenceboolean · obrigatório
requires_phoneboolean · obrigatório
requires_shiftboolean · obrigatório

Cash taken at a counter; recorded from the cash desk during an open shift.

counterboolean · opcional

Taken at a counter (cash or a card terminal); the cash desk offers these.

connectorstring · opcional

Whether a live connector of the utility can complete the method now, or only lists it. Absent when no connector offers it.

um de operational, declared

availableboolean · obrigatório
unavailable_reasonstring · opcional

um de channel_disabled, connector_unavailable, payments_inactive

O objecto
{
  "code": "COD-2026-000142",
  "label": "label",
  "channel": "channel",
  "source": "channel",
  "requires_reference": true,
  "requires_phone": true,
  "requires_shift": true,
  "counter": true,
  "connector": "operational",
  "available": true,
  "unavailable_reason": "channel_disabled"
}

Listar meios de pagamento

Registos

GET /payment-methods

Derived from the utility's configured collection channels (mobile money, bank transfer, the cash counter) and from the methods its payment connectors declare; nothing is listed that the utility did not configure. Clients word each method from its code. Readable with payments:read, payments:write or business:prepaid:vend.

Devolve

200 Methods for the authenticated utility tenant, in configuration order

Mostrar atributos
payments_activeboolean · obrigatório

False while the payments capability is not active; every method is then unavailable.

dataarray of object · obrigatório
Mostrar atributos filhos
codestring · obrigatório

Method code sent when recording the payment.

labelstring · opcional

The utility's own name for the channel (the operator's label, or a neutral sample label in a test account), when a channel of this type has one; never derived from the code.

channelstring · opcional

Collection channel type the method comes from.

sourcestring · obrigatório

um de channel, connector

requires_referenceboolean · obrigatório
requires_phoneboolean · obrigatório
requires_shiftboolean · obrigatório

Cash taken at a counter; recorded from the cash desk during an open shift.

counterboolean · opcional

Taken at a counter (cash or a card terminal); the cash desk offers these.

connectorstring · opcional

Whether a live connector of the utility can complete the method now, or only lists it. Absent when no connector offers it.

um de operational, declared

availableboolean · obrigatório
unavailable_reasonstring · opcional

um de channel_disabled, connector_unavailable, payments_inactive

Erros 401 · 403

Permissões business:prepaid:vend · Funções: admin, billing_clerk, finance, owner

curl -X GET "$BUSINESS_API/payment-methods" \
  -H "Authorization: Bearer sk_test_..."
Resposta 200
{
  "payments_active": true,
  "data": [
    {
      "code": "COD-2026-000142",
      "label": "label",
      "channel": "channel",
      "source": "channel",
      "requires_reference": true,
      "requires_phone": true,
      "requires_shift": true,
      "counter": true,
      "connector": "operational",
      "available": true,
      "unavailable_reason": "channel_disabled"
    }
  ]
}