Solicitar Reembolso

Solicita a devolucao total ou parcial de um Pix recebido.

A devolucao utiliza a mensagem PACS.004 do SPI (Sistema de Pagamentos Instantaneos). Os codigos de motivo aceitos sao: MD06 (solicitacao do cliente) e SL02 (Pix Saque ou parcela de troco).

Devolucoes devem ser solicitadas em ate 90 dias apos a liquidacao original. O valor total de todas as devolucoes de um Pix nao pode exceder o valor original da transacao.

PUT/pix/{e2eid}/devolucao/{id}

Solicita a devolucao de um Pix recebido identificado pelo endToEndId. O id e um identificador unico definido por voce para esta devolucao.

Base URL: https://api.pix.basspago.com.br

Headers

Header	Valor	Descricao
`Content-Type`	application/json	Tipo do conteudo da requisicao
`Authorization`	Bearer {access_token}	Token de acesso obtido via OAuth2

Parametros de Rota

Nome	Tipo	Descricao
`e2eid`	string	Identificador end-to-end do Pix recebido (retornado no webhook ou consulta)
`id`	string	Identificador unico da devolucao definido por voce (deve ser unico por e2eid)

Parametros do Body

Nome	Tipo	Obrigatorio	Descricao
`valor`	string	Obrigatorio	Valor da devolucao em BRL (ex: "10.00"). Pode ser parcial.
`natureza`	string	Opcional	Natureza da devolucao. ORIGINAL (padrao, codigo PACS.004 MD06 — devolucao padrao) ou RETIRADA (codigo PACS.004 SL02 — Pix Saque ou troco)
`descricao`	string	Opcional	Descricao ou motivo da devolucao

Exemplo de Request

{
  "valor": "10.00",
  "natureza": "ORIGINAL",
  "descricao": "Devolucao solicitada pelo cliente"
}

Exemplo de Response

{
  "id": "devolucao123",
  "rtrId": "D12345678202501151030abcdef123456",
  "valor": "10.00",
  "horario": {
    "solicitacao": "2025-01-15T11: 00: 00.000Z"
  },
  "status": "EM_PROCESSAMENTO",
  "natureza": "ORIGINAL",
  "descricao": "Devolucao solicitada pelo cliente"
}

Exemplos de Codigo

curl -X PUT https://api.pix.basspago.com.br/pix/E12345678202501151030abcdef123456/devolucao/devolucao123 \
  --cert ./client.crt \
  --key ./client.key \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer {access_token}" \
  -d '{
    "valor": "10.00",
    "natureza": "ORIGINAL",
    "descricao": "Devolucao solicitada pelo cliente"
  }'