Pay a transaction by ID.
A movimentação é procurada DENTRO da empresa do header x-company-id: id de outra empresa responde 404. Compra no cartão de crédito não é paga individualmente (422) — quem se paga é a fatura. idempotency_key (opcional, até 64 caracteres) torna o pedido repetível: mesma chave e mesmo payload devolvem 200 com o pagamento existente e replayed=true, sem novo pagamento; mesma chave com payload diferente responde 409 idempotency_payload_mismatch. Sem chave, um payload idêntico em até 10 s também é tratado como repetição. payment_method deve ser um de: dinheiro ou pix, cartão de débito, cartão de crédito, transferência bancária, boleto, outros. O saldo movimentado é o da conta do pagamento (bank_account_id), que precisa ser da empresa e estar ativa.
Authorizations
Token da sessão no cabeçalho Authorization, no formato Bearer (mesmo esquema ApiKeyAuth do contrato).
Headers
company uuid
Path Parameters
Transaction ID
Body
Payment data
PaymentDate é DateOnly (não time.Time): aceita "AAAA-MM-DD" (Swagger) e RFC3339 (frontend web) — ver date_only.go.
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.
64