Acessar minha contaAbrir uma conta
POST/api/v2/baas/devolutions

Solicitar

Devolve um Pix recebido nesta conta. Encaminha ao DTPI. Scope: baas.pix-refunds.write. A soma das devoluções concluídas mais value não pode passar do valor original. Devolução em processamento no mesmo end-to-end é recusada.

Autenticação e headers

Requer Bearer token do login da conta e assinatura HMAC obrigatórios. Scope: baas.pix-refunds.write.

HeaderObrigatórioDescrição
AuthorizationSimBearer {{access_token}}
AcceptSimapplication/json
X-SignatureSimAssinatura HMAC
X-TimestampSimTimestamp da assinatura
X-NonceSimNonce único por requisição

Corpo

value em centavos.

CampoObrigatórioDescrição
end_to_end_idSimEnd-to-end do Pix recebido nesta conta
tx_idSimTxid do Pix original
valueSimCentavos, maior que zero
descriptionNãoAté 140 caracteres

A resposta traz a movimentação de saída em exit.

Erros comuns

CódigoCausa
400Pix fora do extrato desta conta, valor já devolvido ou devolução em processamento
422Corpo inválido

Notas

  • A conta do débito é a do claim account_uuid, não a conta primária do usuário.
  • Técnica: Devoluções Pix.
curl --request POST \
  --url 'https://api-h.nuvende.com.br/api/v2/baas/devolutions' \
  --header 'Content-Type: application/json' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer {{access_token}}' \
  --header 'X-Timestamp: {{timestamp}}' \
  --header 'X-Nonce: {{nonce}}' \
  --header 'X-Signature: {{signature}}' \
  --data '{
  "end_to_end_id": "E12345678901234567890123456789012",
  "tx_id": "7978c0c97ea847e78e8849634473c1f1",
  "value": 5000,
  "description": "Devolucao parcial"
}'