curl -X POST https://carteira.nevermissapps.com/v1/refund \
-H "Authorization: Bearer SUA_API_KEY" \
-H "Content-Type: application/json" \
-d '{"txid": "ABC123XYZ"}'
const response = await fetch('https://carteira.nevermissapps.com/v1/refund', {
method: 'POST',
headers: {
'Authorization': 'Bearer SUA_API_KEY',
'Content-Type': 'application/json'
},
body: JSON.stringify({
txid: 'ABC123XYZ'
})
});
const refund = await response.json();
console.log(refund);
import requests
response = requests.post(
'https://carteira.nevermissapps.com/v1/refund',
headers={
'Authorization': 'Bearer SUA_API_KEY',
'Content-Type': 'application/json'
},
json={'txid': 'ABC123XYZ'}
)
refund = response.json()
print(refund)
<?php
$ch = curl_init('https://carteira.nevermissapps.com/v1/refund');
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
'Authorization: Bearer SUA_API_KEY',
'Content-Type: application/json'
]);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode([
'txid' => 'ABC123XYZ'
]));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$refund = curl_exec($ch);
curl_close($ch);
echo $refund;
?>
{
"success": true,
"message": "Reembolso processado com sucesso",
"refund": {
"txid": "ABC123XYZ",
"status": "refunded",
"refundedToCustomer": 49.90,
"deductedFromSeller": 46.90,
"platformFeeRetained": 3.00,
"previousBalance": 187.39,
"newBalance": 140.49,
"refundId": "rfd_9x8e8g1"
}
}
{
"success": false,
"message": "Saldo insuficiente. Você precisa de R$ 46.90 mas possui apenas R$ 30.00"
}
{
"success": false,
"message": "Esta transação já foi reembolsada"
}
{
"success": false,
"message": "Esta transação já possui um reembolso em processamento"
}
{
"success": false,
"message": "Esta transação possui uma contestação (MED) em análise. Não é possível processar o reembolso até que a contestação seja resolvida.",
"details": {
"medStatus": "pending",
"medAnalysisStatus": "pending",
"infractionId": "INF123456789",
"frozenAmount": 46.41
}
}
{
"success": false,
"message": "Transação não encontrada ou não pertence a este usuário"
}
API - Pagamentos
Reembolsar Pagamento
Reembolsa um pagamento aprovado, devolvendo o valor ao pagador
POST
/
v1
/
refund
curl -X POST https://carteira.nevermissapps.com/v1/refund \
-H "Authorization: Bearer SUA_API_KEY" \
-H "Content-Type: application/json" \
-d '{"txid": "ABC123XYZ"}'
const response = await fetch('https://carteira.nevermissapps.com/v1/refund', {
method: 'POST',
headers: {
'Authorization': 'Bearer SUA_API_KEY',
'Content-Type': 'application/json'
},
body: JSON.stringify({
txid: 'ABC123XYZ'
})
});
const refund = await response.json();
console.log(refund);
import requests
response = requests.post(
'https://carteira.nevermissapps.com/v1/refund',
headers={
'Authorization': 'Bearer SUA_API_KEY',
'Content-Type': 'application/json'
},
json={'txid': 'ABC123XYZ'}
)
refund = response.json()
print(refund)
<?php
$ch = curl_init('https://carteira.nevermissapps.com/v1/refund');
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
'Authorization: Bearer SUA_API_KEY',
'Content-Type: application/json'
]);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode([
'txid' => 'ABC123XYZ'
]));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$refund = curl_exec($ch);
curl_close($ch);
echo $refund;
?>
{
"success": true,
"message": "Reembolso processado com sucesso",
"refund": {
"txid": "ABC123XYZ",
"status": "refunded",
"refundedToCustomer": 49.90,
"deductedFromSeller": 46.90,
"platformFeeRetained": 3.00,
"previousBalance": 187.39,
"newBalance": 140.49,
"refundId": "rfd_9x8e8g1"
}
}
{
"success": false,
"message": "Saldo insuficiente. Você precisa de R$ 46.90 mas possui apenas R$ 30.00"
}
{
"success": false,
"message": "Esta transação já foi reembolsada"
}
{
"success": false,
"message": "Esta transação já possui um reembolso em processamento"
}
{
"success": false,
"message": "Esta transação possui uma contestação (MED) em análise. Não é possível processar o reembolso até que a contestação seja resolvida.",
"details": {
"medStatus": "pending",
"medAnalysisStatus": "pending",
"infractionId": "INF123456789",
"frozenAmount": 46.41
}
}
{
"success": false,
"message": "Transação não encontrada ou não pertence a este usuário"
}
Descrição
Solicita o reembolso de um pagamento aprovado. O reembolso é processado na mesma hora, devolvendo o valor ao cliente e deduzindo do seu saldo o valor líquido que você havia recebido. Se o pagamento possuía regras de split, os valores recebidos pelos destinatários do split também serão deduzidos de seus respectivos saldos.Operação irreversível: Após processar o reembolso, não é possível desfazê-lo.
Headers
string
required
Bearer token com sua API Key
string
required
Deve ser
application/jsonBody
string
required
ID da transação a ser reembolsada
Pré-requisitos
Transação deve ser do tipo payment
Transação deve ser do tipo payment
Apenas pagamentos podem ser reembolsados, não saques
Status deve ser approved
Status deve ser approved
Só é possível reembolsar pagamentos já confirmados
Saldo suficiente
Saldo suficiente
Você deve ter saldo suficiente para cobrir o valor líquido
Não pode ter sido reembolsado
Não pode ter sido reembolsado
Cada pagamento só pode ser reembolsado uma vez
Não pode estar com reembolso pendente
Não pode estar com reembolso pendente
Se já houver um reembolso em processamento (
refund_pending), aguarde a conclusãoNão pode ter MED ativo
Não pode ter MED ativo
Se a transação possuir uma contestação (MED) pendente ou aceita, não é possível reembolsar
Response
boolean
Indica se a operação foi bem-sucedida
string
Mensagem de confirmação
object
Detalhes do reembolso
Show properties
Show properties
string
ID da transação reembolsada
string
Status final do reembolso:
refundednumber
Valor total que foi devolvido ao cliente
number
Valor que foi deduzido do seu saldo
number
Valor que foi deduzido do destinatário do split (se houver)
number
Taxa da plataforma que foi retida
number
Seu saldo anterior à dedução
number
Seu novo saldo após a dedução
string
ID do reembolso no banco/provedor
curl -X POST https://carteira.nevermissapps.com/v1/refund \
-H "Authorization: Bearer SUA_API_KEY" \
-H "Content-Type: application/json" \
-d '{"txid": "ABC123XYZ"}'
const response = await fetch('https://carteira.nevermissapps.com/v1/refund', {
method: 'POST',
headers: {
'Authorization': 'Bearer SUA_API_KEY',
'Content-Type': 'application/json'
},
body: JSON.stringify({
txid: 'ABC123XYZ'
})
});
const refund = await response.json();
console.log(refund);
import requests
response = requests.post(
'https://carteira.nevermissapps.com/v1/refund',
headers={
'Authorization': 'Bearer SUA_API_KEY',
'Content-Type': 'application/json'
},
json={'txid': 'ABC123XYZ'}
)
refund = response.json()
print(refund)
<?php
$ch = curl_init('https://carteira.nevermissapps.com/v1/refund');
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
'Authorization: Bearer SUA_API_KEY',
'Content-Type: application/json'
]);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode([
'txid' => 'ABC123XYZ'
]));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$refund = curl_exec($ch);
curl_close($ch);
echo $refund;
?>
{
"success": true,
"message": "Reembolso processado com sucesso",
"refund": {
"txid": "ABC123XYZ",
"status": "refunded",
"refundedToCustomer": 49.90,
"deductedFromSeller": 46.90,
"platformFeeRetained": 3.00,
"previousBalance": 187.39,
"newBalance": 140.49,
"refundId": "rfd_9x8e8g1"
}
}
{
"success": false,
"message": "Saldo insuficiente. Você precisa de R$ 46.90 mas possui apenas R$ 30.00"
}
{
"success": false,
"message": "Esta transação já foi reembolsada"
}
{
"success": false,
"message": "Esta transação já possui um reembolso em processamento"
}
{
"success": false,
"message": "Esta transação possui uma contestação (MED) em análise. Não é possível processar o reembolso até que a contestação seja resolvida.",
"details": {
"medStatus": "pending",
"medAnalysisStatus": "pending",
"infractionId": "INF123456789",
"frozenAmount": 46.41
}
}
{
"success": false,
"message": "Transação não encontrada ou não pertence a este usuário"
}
Como Funciona
1
Solicitação enviada
O reembolso é solicitado e o status muda para
refund_pending2
Aguarda confirmação
O banco processa a devolução PIX ao pagador original
3
Cliente recebe o valor total
O sistema devolve R$ 49,90 (valor total incluindo a taxa) ao cliente
4
Dedução do seu saldo
Após confirmação, R$ 46,41 (valor líquido) é deduzido do seu saldo disponível
5
Status atualizado
O status da transação muda para
refundedProcessamento assíncrono: O tempo de processamento depende do banco e pode levar alguns minutos. Você pode acompanhar o status consultando a transação.
Erros Comuns
| Código | Causa | Solução |
|---|---|---|
| 400 | Saldo insuficiente | Certifique-se de ter saldo suficiente |
| 400 | Já foi reembolsado | Verifique o status da transação |
| 400 | Dados de pagamento não encontrados | Entre em contato com suporte |
| 404 | Transação não encontrada | Confirme o txid |
| 409 | MED ativo na transação | Aguarde resolução da contestação |
| 500 | Erro ao processar | Entre em contato com suporte |