Acessar minha contaAbrir uma conta
PUT/api/v2/pix/{e2eid}/devolucoes/{txid}

Solicitar

Scope: pix.refunds.write. O Pix precisa ser recebimento desta conta. Recusa se o valor já devolvido com sucesso mais este valor passar do original, ou se houver devolução em processamento.

Parâmetros

e2eidObrigatório
path
Tipo:string
txidObrigatório
path
Tipo:string

Autenticação e headers

Bearer do integrador Mundo Digital. Scope: pix.refunds.write.

HeaderObrigatórioDescrição
AuthorizationSimBearer {{access_token}}
AcceptSimapplication/json
Content-TypeSimapplication/json

Path

ParâmetroObrigatórioDescrição
e2eidSimEnd-to-end do Pix original recebido por esta conta
txidSimIdentificador desta devolução

Corpo

CampoObrigatórioDescrição
valorSimDecimal, ex.: 50.00
motivoNãoMotivo enviado ao arranjo
descricaoNãoInformação entre clientes

Erros comuns

CódigomessageCausa
400Pix não pertence à conta autenticada.e2eid de outra conta
400Valor da devolução maior que o valor original do PIXSoma das DEVOLVIDO mais este valor passa do original
400Existe devolução em processamento para esta transação.Já há EM_PROCESSAMENTO neste Pix

NAO_REALIZADO não entra na soma.

Notas

curl --request PUT \
  --url 'https://api-h.nuvende.com.br/api/v2/pix/E12345678901234567890123456789012/devolucoes/7978c0c97ea847e78e8849634473c1f1' \
  --header 'Content-Type: application/json' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer {{access_token}}' \
  --data '{
  "valor": 50.00,
  "motivo": "Devolucao solicitada pelo usuario"
}'