1. Devolução de Pagamento Pix
Api Expert
  • Documentos
    • Rakim Expert
    • Homologação
      • Processo de Homologação
    • Autenticação na API
    • Pagamentos
      • Introdução
      • Fingerprint
      • Criando um Pagamento
        • sales
      • Criando Pagamento com Split
        • sales/splits
      • Capturando um Pagamento Pré-Autorizado
        • capture
      • Cancelando um Pagamento
        • cancel
      • Consultando informações do Pagamento
        • consulta
      • Ativando um Split Tardio
        • Split tardio
      • Como Criar um Cofre de Cartão
        • vault
      • Inativar cofre de cartão
        • inativar vault
      • Listar os Cartões do Cofre
        • Lista vault
      • Consultando as Taxas da Transação
        • Consultar taxas
      • Listar Pagamentos
        • Listar pagamentos
      • Cartões de Teste
      • Códigos de Retorno
      • Casos de Uso
    • PIX
      • Introdução
      • Criar Cobrança Pix
        • Cobranca pix
      • Consultar Cobrança Pix
        • Cobranca pix
      • Devolução de Pagamento Pix
        • Devolução pix
          POST
    • Link de Pagamento
      • Introdução
      • Criar Link de Pagamento
        • Criar Link de Pagamento
      • Upload do Logo para Link de Pagamento
        • Upload logo
    • Recorrência
      • Introdução
      • Criar Recorrência
        • Criar Recorrência
      • Criar Link de Recorrência
        • Criar link
    • Estabelecimentos
      • Introdução
      • Criar Estabelecimento
        • Criar Estabelecimento
      • Upload de documentos
        • Upload de Documentos
      • Buscar Estabelecimento
        • Busca estabelecimento
      • Listar CNAE's
        • Listar CNAE's
      • Listar Bancos
        • Listar Bancos
      • Casos de Uso
    • Liquidações
      • Saque
        • Solicitar Saque
      • Saldo
        • Consultar Saldo
      • Extrato
        • Busca extrato
      • Extrato Analítico
        • Busca extrato
      • Extrato Futuro
        • Busca extrato
    • Antecipações
      • Introdução
      • Atualizar Antecipação Automática
        • Atualização Antecipação
      • Listar Antecipações Disponíveis
        • Listar Antecipações
      • Solicitar Antecipação
        • Solicitar Antecipação
    • Webhook's
      • Cadastrar Webhook
        • Cadastrar Webhook
      • Reenvio de Webhook de Pagamento
        • Reenvio de Webhook de Pagamento
      • Reenvio de Webhook de Estabelecimento
        • Reenvio de Webhook de Estabelecimento
      • Exemplo de Webhook
    • Status
      • Status de Pagamento
  1. Devolução de Pagamento Pix

Devolução pix

Amb. de Produção
https://api-expert.rakim.com.br
Amb. de Produção
https://api-expert.rakim.com.br
POST
https://api-expert.rakim.com.br
/payments/api/sales/pix/{paymentId}/returns

Parameters#

NomeTipoDescriçãoRequiredDefault
paymentIdstringIdentificador único do pagamento.Sim

ReturnPix#

NomeTipoDescriçãoObrigatoriedadeDefault
amountstringValor da cobrança em centavos, sem vírgula e ponto. (Max 9999999999). Exemplo: R$ 10,35 = 1035.Sim
returnReasonCodestringCódigo contendo o motivo de devolução. Valores possíveis:

MD06 - Devolução de pagamento instantâneo solicitado pelo usuário recebedor.

FR01 - Devolução de pagamento instantâneo motivada por fundada suspeita de fraude.

BE08 - Devolução de pagamento iniciada pelo participante do usuário recebedor.
Sim

Requisição

Parâmetros de Caminho

Parâmetros Header

Respostas

🟢200
application/json
Bodyapplication/json

🟠400
🟠422
🟠401
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api-expert.rakim.com.br/payments/api/sales/pix//returns' \
--header 'Authorization: Bearer <access_token>'
Response Response Example
200 - Sucesso
{
  "status": 4,
  "returnCode": "0",
  "returnMessage": "Sucesso",
  "paymentId": "0C12C9F1-AE8E-2E7B-1725-448EAFCD4FD1",
  "orderNumber": "304fb53a-379a-4e67-82c6-0a779410958d",
  "type": "pix",
  "amount": 1035,
  "releaseAt": "2022-05-23 12:59:05"
}
Modificado em 2026-02-26 14:57:05
Página anterior
Devolução de Pagamento Pix
Próxima página
Introdução
Built with