Skip to main content
POST
Pay a transaction by ID.

Authorizations

Authorization
string
header
required

Token da sessão no cabeçalho Authorization, no formato Bearer (mesmo esquema ApiKeyAuth do contrato).

Headers

x-company-id
string
required

company uuid

Path Parameters

id
string
required

Transaction ID

Body

application/json

Payment data

amount
number
required
bank_account_id
string
required
payment_date
string<date>
required

PaymentDate é DateOnly (não time.Time): aceita "AAAA-MM-DD" (Swagger) e RFC3339 (frontend web) — ver date_only.go.

payment_method
string
required
idempotency_key
string

IdempotencyKey (opcional, ≤ 64) torna o /pay repetível sem duplicar o pagamento (RN10, CA16): mesma chave e mesmo payload devolvem o pagamento existente; mesma chave com payload diferente é 409. Escopo: o lançamento. Sem chave, a proteção é a janela de 10 s do repositório.

Maximum string length: 64

Response

OK

message
string
payment_id
string
replayed
boolean