Pular para o conteúdo principal
POST
/
transactions
/
{id}
/
refund
Solicitar reembolso de transação
curl --request POST \
  --url https://api.pague.dev/v1/transactions/{id}/refund \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <x-api-key>' \
  --data '
{
  "reason": "Cliente solicitou cancelamento"
}
'
{
  "originalTransactionId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "pspProvider": "<string>",
  "pspRefundTransactionId": "<string>",
  "status": "PENDING"
}

Documentation Index

Fetch the complete documentation index at: https://docs.pague.dev/llms.txt

Use this file to discover all available pages before exploring further.

Cabeçalhos

​
X-API-Key
string
obrigatório

Chave de API de integração (pd_live_* para produção, pd_test_* para sandbox)

Parâmetros de caminho

​
id
string<uuid>
obrigatório

ID da transação de pagamento a ser reembolsada

Corpo

application/json
​
reason
string

Motivo do reembolso (opcional, máximo 255 caracteres)

Maximum string length: 255
Exemplo:

"Cliente solicitou cancelamento"

Resposta

Reembolso solicitado com sucesso. Status PENDING até a confirmação via webhook.

​
originalTransactionId
string<uuid>
obrigatório

ID da transação original que está sendo reembolsada

​
pspProvider
string
obrigatório

Provedor PSP que processou o reembolso

​
pspRefundTransactionId
string
obrigatório

ID da transação de reembolso no PSP

​
status
enum<string>
obrigatório

Status retornado pelo PSP. PENDING significa que o reembolso foi aceito mas ainda não foi confirmado — a confirmação chega via webhook refund_completed.

Opções disponíveis:
PENDING,
CONFIRMED,
ERROR
Exemplo:

"PENDING"