Verificar Status de Pagamento

curl -X GET https://carteira.nevermissapps.com/v1/payment/status/ABC123XYZ \
  -H "Authorization: Bearer SUA_API_KEY"

const txid = 'ABC123XYZ';
const response = await fetch(
  `https://carteira.nevermissapps.com/v1/payment/status/${txid}`,
  {
    headers: {
      'Authorization': 'Bearer SUA_API_KEY'
    }
  }
);

const status = await response.json();
console.log(status);

import requests

txid = 'ABC123XYZ'
response = requests.get(
    f'https://carteira.nevermissapps.com/v1/payment/status/{txid}',
    headers={'Authorization': 'Bearer SUA_API_KEY'}
)

status = response.json()
print(status)

<?php
$txid = 'ABC123XYZ';
$ch = curl_init("https://carteira.nevermissapps.com/v1/payment/status/$txid");

curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer SUA_API_KEY'
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$status = curl_exec($ch);
curl_close($ch);

echo $status;
?>

{
  "success": true,
  "transaction": {
    "txid": "1764641755676ISFZE1WWY39PAOYQS6Z6",
    "amount": 49.90,
    "netAmount": 46.41,
    "fee": 3.49,
    "status": "pending",
    "type": "link",
    "createdAt": "2025-12-02T02:15:55.790Z",
    "updatedAt": "2025-12-02T02:15:55.790Z"
  }
}

{
  "success": true,
  "transaction": {
    "txid": "1764641755676ISFZE1WWY39PAOYQS6Z6",
    "amount": 49.90,
    "netAmount": 46.41,
    "fee": 3.49,
    "status": "approved",
    "type": "link",
    "createdAt": "2025-12-02T02:15:55.790Z",
    "updatedAt": "2025-12-02T02:17:05.297Z",
    "payer": {
      "name": "João Silva",
      "document": "***.456.789-**",
      "bank": {
        "name": "Nubank",
        "code": "260"
      },
      "accountType": "checking"
    }
  }
}

{
  "error": "Not Found",
  "message": "Transaction not found"
}

GET

payment

status

{txid}

curl -X GET https://carteira.nevermissapps.com/v1/payment/status/ABC123XYZ \
  -H "Authorization: Bearer SUA_API_KEY"

const txid = 'ABC123XYZ';
const response = await fetch(
  `https://carteira.nevermissapps.com/v1/payment/status/${txid}`,
  {
    headers: {
      'Authorization': 'Bearer SUA_API_KEY'
    }
  }
);

const status = await response.json();
console.log(status);

import requests

txid = 'ABC123XYZ'
response = requests.get(
    f'https://carteira.nevermissapps.com/v1/payment/status/{txid}',
    headers={'Authorization': 'Bearer SUA_API_KEY'}
)

status = response.json()
print(status)

<?php
$txid = 'ABC123XYZ';
$ch = curl_init("https://carteira.nevermissapps.com/v1/payment/status/$txid");

curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer SUA_API_KEY'
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$status = curl_exec($ch);
curl_close($ch);

echo $status;
?>

{
  "success": true,
  "transaction": {
    "txid": "1764641755676ISFZE1WWY39PAOYQS6Z6",
    "amount": 49.90,
    "netAmount": 46.41,
    "fee": 3.49,
    "status": "pending",
    "type": "link",
    "createdAt": "2025-12-02T02:15:55.790Z",
    "updatedAt": "2025-12-02T02:15:55.790Z"
  }
}

{
  "success": true,
  "transaction": {
    "txid": "1764641755676ISFZE1WWY39PAOYQS6Z6",
    "amount": 49.90,
    "netAmount": 46.41,
    "fee": 3.49,
    "status": "approved",
    "type": "link",
    "createdAt": "2025-12-02T02:15:55.790Z",
    "updatedAt": "2025-12-02T02:17:05.297Z",
    "payer": {
      "name": "João Silva",
      "document": "***.456.789-**",
      "bank": {
        "name": "Nubank",
        "code": "260"
      },
      "accountType": "checking"
    }
  }
}

{
  "error": "Not Found",
  "message": "Transaction not found"
}

Descrição

Consulta o status de um pagamento específico pelo ID da transação (txid).

Path Parameters

string

required

ID da transação obtido ao criar o pagamento

Headers

string

required

Bearer token com sua API Key

Response

boolean

Indica se a operação foi bem-sucedida

object

Detalhes da transação

Show properties

string

ID da transação

number

Valor total

number

Valor líquido recebido

number

Taxa cobrada

string

Status: pending, approved, expired, cancelled, refund_pending, refunded

string

Tipo da transação: link

string

Data de criação (formato ISO 8601)

string

Data da última atualização (formato ISO 8601)

object

Informações do pagador (apenas para status approved)

Show properties

string

Nome do pagador

string

CPF/CNPJ parcialmente mascarado

object

Informações do banco

Show properties

string

Nome do banco

string

Código do banco

string

Tipo de conta (ex: checking, savings)

curl -X GET https://carteira.nevermissapps.com/v1/payment/status/ABC123XYZ \
  -H "Authorization: Bearer SUA_API_KEY"

const txid = 'ABC123XYZ';
const response = await fetch(
  `https://carteira.nevermissapps.com/v1/payment/status/${txid}`,
  {
    headers: {
      'Authorization': 'Bearer SUA_API_KEY'
    }
  }
);

const status = await response.json();
console.log(status);

import requests

txid = 'ABC123XYZ'
response = requests.get(
    f'https://carteira.nevermissapps.com/v1/payment/status/{txid}',
    headers={'Authorization': 'Bearer SUA_API_KEY'}
)

status = response.json()
print(status)

<?php
$txid = 'ABC123XYZ';
$ch = curl_init("https://carteira.nevermissapps.com/v1/payment/status/$txid");

curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer SUA_API_KEY'
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$status = curl_exec($ch);
curl_close($ch);

echo $status;
?>

{
  "success": true,
  "transaction": {
    "txid": "1764641755676ISFZE1WWY39PAOYQS6Z6",
    "amount": 49.90,
    "netAmount": 46.41,
    "fee": 3.49,
    "status": "pending",
    "type": "link",
    "createdAt": "2025-12-02T02:15:55.790Z",
    "updatedAt": "2025-12-02T02:15:55.790Z"
  }
}

{
  "success": true,
  "transaction": {
    "txid": "1764641755676ISFZE1WWY39PAOYQS6Z6",
    "amount": 49.90,
    "netAmount": 46.41,
    "fee": 3.49,
    "status": "approved",
    "type": "link",
    "createdAt": "2025-12-02T02:15:55.790Z",
    "updatedAt": "2025-12-02T02:17:05.297Z",
    "payer": {
      "name": "João Silva",
      "document": "***.456.789-**",
      "bank": {
        "name": "Nubank",
        "code": "260"
      },
      "accountType": "checking"
    }
  }
}

{
  "error": "Not Found",
  "message": "Transaction not found"
}

Status Possíveis

Status	Descrição
`pending`	Aguardando pagamento do cliente
`approved`	Pagamento confirmado e valor creditado em sua conta
`expired`	Cobrança expirou sem pagamento (após 24 horas)
`cancelled`	Pagamento cancelado manualmente via API
`refund_pending`	Reembolso solicitado, aguardando confirmação
`refunded`	Pagamento reembolsado ao cliente

Use Webhooks: Em vez de fazer polling constante, configure um webhook para receber notificações automáticas quando o pagamento for aprovado. Veja Webhooks.

Exemplo de Polling

Se não estiver usando webhooks, você pode fazer polling para verificar o status:

async function waitForPayment(txid, maxAttempts = 60) {
  for (let i = 0; i < maxAttempts; i++) {
    const response = await fetch(
      `https://carteira.nevermissapps.com/v1/payment/status/${txid}`,
      { headers: { 'Authorization': `Bearer ${API_KEY}` } }
    );
    
    const { transaction } = await response.json();
    
    if (transaction.status === 'approved') {
      console.log('Pagamento aprovado!');
      return transaction;
    }
    
    // Aguarda 5 segundos antes de tentar novamente
    await new Promise(resolve => setTimeout(resolve, 5000));
  }
  
  throw new Error('Timeout aguardando pagamento');
}

Respeite o Rate Limit: Não faça polling muito frequente. Recomendamos intervalos de pelo menos 5 segundos entre verificações.

Começando

Conceitos

API - Introdução

API - Pagamentos

API - Saldo e Saques

API - Transações

API - Relatórios

API - MEDs (Contestações)

API - Split

Verificar Status de Pagamento

Descrição

Path Parameters

Headers

Response

Status Possíveis

Exemplo de Polling

​Descrição

​Path Parameters

​Headers

​Response

​Status Possíveis

​Exemplo de Polling

Descrição

Path Parameters

Headers

Response

Status Possíveis

Exemplo de Polling