Pix ProcessamentoPix Processamento Docs
Endpoints da APIEstornos

Estornar um Pix

PortuguêsEnglish中文
POST
/refund/{transactionId}

Autorização

BearerAuth
AutorizaçãoBearer <token>

Em: header

Parâmetros de path

transactionId*string

ID da transação a estornar.

Corpo da requisição

application/json

Definições TypeScript

Use o tipo request body no TypeScript.

Corpo da resposta

application/json

application/json

curl --request POST \  --url 'https://api.exemplo.processamento.com/v1/refund/PIX2025081418333632CYKN8M' \  --header 'Authorization: Bearer $PIX_TOKEN' \  --header 'Content-Type: application/json' \  --data '{  "amount": 30.5,  "description": "Estorno solicitado pelo cliente",  "clientReference": "refund-2026-0001"}'
{
  "id": "PIX20250810120000ABCD12",
  "status": "COMPLETED",
  "amount": 100,
  "type": "DEPOSIT",
  "method": "PIX",
  "qrCodeText": null,
  "qrCodeBase64": null,
  "qrCodeUrl": null,
  "generatedName": "Fulano de Tal",
  "generatedDocument": "12345678901",
  "generatedEmail": null,
  "payerName": "Fulano de Tal",
  "payerDocument": "12345678901",
  "payerInstitutionIspb": "12345678",
  "payerInstitutionName": "Banco X",
  "payerAccountNumber": null,
  "serviceFeeCharged": 1.5,
  "withdrawPixKey": null,
  "withdrawPixType": null,
  "receiverName": "Loja Exemplo",
  "receiverDocument": "11222333000181",
  "receiverInstitutionIspb": "00000000",
  "receiverInstitutionName": "Pix Processamento",
  "receiverAccountNumber": "513579",
  "endToEndId": "E12345678202508101200abcdef01",
  "clientReference": "pedido-42",
  "refundEndToEndId": null,
  "refundAmount": 30.5,
  "refundStatus": "PENDING",
  "refundReason": "CUSTOMER_REQUEST",
  "refundDescription": "Devolução parcial",
  "refundedAt": null,
  "cancellationReason": null,
  "paidAt": "2025-08-10T12:00:00.000Z",
  "createdAt": "2025-08-10T11:59:00.000Z",
  "updatedAt": "2026-08-11T09:00:00.000Z"
}
{
  "statusCode": 400,
  "error": "Bad Request",
  "message": "Validation failed",
  "requestId": "cmbz0f8qk0001js04hp3e2n0f",
  "errorCode": "PZA100",
  "retryAfterSeconds": 30,
  "details": [
    {
      "field": "string",
      "message": "string"
    }
  ]
}

Estornos

Devolver um Pix recebido, no valor cheio ou em parte. O estorno nasce pendente e a conclusão chega por webhook.

Transferência interna

Move saldo entre duas contas Pix Processamento sem passar pelo Pix tradicional. Liquidação instantânea, identificação por accountNumber. Ideal para repasses matriz/filial, marketplaces e payouts entre clientes Pix Processamento.