Pular para o conteúdo principal
PATCH
Este endpoint permite que você reembolse integralmente uma transação Payin previamente autorizada. Requisitos para reembolso:
  • O valor do reembolso deve ser igual ao valor original do pagamento.
  • O reembolso deve ser enviado para o mesmo beneficiário e conta utilizados no pagamento original.

Autorizações

Authorization
string
header
obrigatório

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

Cabeçalhos

Authorization
string
obrigatório

Token de acesso Bearer para autenticação. Este token é obtido nos endpoints Obter token de acesso ou Renovar token de acesso.

Parâmetros de caminho

externalId
string
obrigatório

ID gerado por você para rastreabilidade da transação. Deve ser único e aceita apenas caracteres alfanuméricos e hífens (UUID4, por exemplo).

Pattern: [a-zA-Z0-9\- ]+
Exemplo:

"53025bf4-4c87-4b4f-8fea-b47004440f37"

Corpo

application/json
externalId
string
obrigatório

Um identificador único gerado pelo seu sistema para rastrear a transação (alfanumérico e com hífens). Recomendamos o uso do UUID4 para garantir a unicidade. Necessário apenas para Pix (Brasil) e reembolsos em dinheiro.

beneficiary
object
obrigatório

Objeto com detalhes sobre o beneficiário do reembolso. Necessário apenas para reembolsos via Pix (Brasil) e em dinheiro.

comment
string

Comentário ou observação com informações adicionais sobre a transação de reembolso.

Resposta

OK

externalId
string

Um identificador único gerado pelo seu sistema para rastrear a transação (alfanumérico e com hífens). Recomendamos o uso do UUID4 para garantir a unicidade.

internalId
string

Identificador de transação da Localpayment.

status
status · object

Status da operação.

Última modificação em 10 de novembro de 2026