Estornar Fatura
PUT
https://api.tryplopay.com/invoices
invoice.refund| CAMPO | TIPO | OBRIGATORIO | DESCRIÇÃO | VALORES |
|---|---|---|---|---|
| id | INT | SIM | NOSSO ID DA FATURA | |
| amount | DOUBLE(10,2) | NÃO | VALOR DO ESTORNO. VÁLIDO APENAS PARA PIX | 12.30 |
| reason | STRING | SIM | MOTIVO | CONFORME TABELA ABAIXO |
TABELA DE RAZÕES PARA ESTORNO (campo reason)
| VALOR | TIPO | DESCRIÇÃO |
|---|---|---|
| DESA_COMER | CARTÃO | Desacordo Comercial |
| VEND_OPTOU | CARTÃO | Decisão do Vendedor |
| CBK_FORCE | CARTÃO | Reembolso por Chargeback |
| RA_CC | CARTÃO | Reembolso por Reclame Aqui |
| BE08 | PIX | Devolução por Erro do PSP ou Gateway |
| FR01 | PIX | Devolução por MED/Fraude |
| MD06 | PIX | Devolução Normal |
| SL02 | PIX | Devolução Por Desacordo |
| FRAUD | PIX | FRAUDE |
| RFB_VALIDATION | PIX | IRREGULARIDADE NO CADASTRO |
| USER_REQUESTED | PIX | Solicitação feita pelo usuário. |
| ACCOUNT_CLOSURE | PIX | Conta encerrada. |
| RA_PIX | PIX | Reembolso por Reclame Aqui |
Requisição
Parâmetros Bodyapplication/json
Respostas
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request PUT 'https://api.tryplopay.com/invoices' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
"payment": {
"id": 123456789,
"amount": 10.50,
"reason": "MD06"
}
}'Response Response Example
200 - 200 - Sucesso
{
"date": "2025-09-16 20:32:34",
"success": true,
"error": false,
"type": "refund",
"api": {
"by": "TRYPLOPAY.com",
"version": "3.0.2",
"updated": "2025-05-06"
},
"__seconds": 2.3541719913482666,
"refund": {
"currency": "BRL",
"id": "ef02e54c-d205-410e-975d-69f4756acde8",
"details": {
"amount": 5,
"original": {
"ete": "990cd7b9-7246-43f4-95d9-2cdf1e25f087"
},
"ete": "E004169682025091622341iBpf5CXSCT",
"id": "D13935893202509162332b7rDBZCpZ6x",
"reason": "MD06",
"description": null
}
}
}