Pular para o conteúdo principal
PUT
Mark a Transaction as Paid Externally
Marque uma transação pix ou voucher como paga fora da Pagou, por exemplo quando o comprador pagou por transferência depois que a cobrança expirou. Use na URL o UUID retornado como id da transação e autentique com a API key da sua empresa. A transação vai para paid_externally pelo valor integral, e a Pagou executa o mesmo fluxo de entrega de uma venda paga: o webhook transaction.paid (com status: "paid_externally"), o e-mail de confirmação ao comprador e as integrações de tracking.
Nenhum dinheiro passa pela Pagou nessa venda: ela não gera saldo, liquidação nem taxa da venda, e não pode ser reembolsada nem desfeita. Serviços que sua empresa habilitou, como o e-mail de confirmação ao comprador, seguem cobrados normalmente. Sua integração precisa liberar pedidos em paid_externally além de paid.

Quais transações podem ser marcadas

  • Método de pagamento pix ou voucher.
  • Status pending ou expired, sem pagamento anterior.
Transações de cartão, canceladas, pagas ou reembolsadas retornam 422. Quando a cobrança ainda está aberta, a Pagou também tenta cancelá-la; a marcação acontece mesmo que o cancelamento não seja concluído.

Campos da requisição

Idempotência

Chamar de novo para uma transação já marcada devolve o estado atual com 200, sem nenhum outro efeito: nem segundo webhook, nem segundo e-mail. O reason e o external_reference da nova chamada são ignorados; valem os da primeira marcação.

Se o comprador também pagar pela Pagou

Se a cobrança original for paga depois da marcação, a transação vai para paid e o dinheiro segue o fluxo normal, com a taxa. Nenhum segundo transaction.paid é enviado, para o pedido não ser liberado duas vezes. Devolver esse pagamento ao comprador segue o fluxo normal de reembolso.

Erros

Exemplo

A resposta traz a transação no mesmo formato de Consultar transação, com status: "paid_externally".

Autorizações

Authorization
string
header
obrigatório

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Parâmetros de caminho

id
string<uuid>
obrigatório
Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$

Corpo

application/json
reason
string
obrigatório

Why the sale is being marked as paid outside the platform. Required.

Required string length: 1 - 500
Exemplo:

"Pago por transferência bancária"

external_reference
string | null

Your own reference for the outside payment, such as a bank transfer id.

Required string length: 1 - 255
Exemplo:

"TED-2026-10-27-0042"

Resposta

Success

success
boolean
obrigatório
requestId
string
obrigatório
data
object
obrigatório