Gates2b

Listar pagamentos em cripto

Lista os pagamentos criados pelo endpoint de cripto, com paginação e filtros por status, data e valor.

GET
/invoices/payment-gateway

Authorization

apiKey
headerAuthorizationBearer <token>

Chave de API gerada no painel: Authorization: Bearer <chave>.

Query Parameters

page?integer

Página, a partir de 1.

Intervalo1 <= value
Padrão1
quantityPerPage?integer

Itens por página.

Intervalo1 <= value
Padrão10
orderBy?string

Campo e direção separados por ponto: createdAt.DESC, amount.total.ASC. Padrão: createdAt.DESC.

status?string

Filtra pelo status do pagamento (transaction.status).

Valores aceitos"WAITING_PAYMENT""REVIEW_REQUIRED""PAYMENT_RECEIVED""PAYMENT_PARTIAL""PAYMENT_EXPIRED""PAYMENT_FAILED""CREATION_FAILED""REFUND_REQUESTED""REFUND_COMPLETED""WITHDRAWAL_IN_PROGRESS""WITHDRAWAL_IN_PROCESSING""WITHDRAWAL_COMPLETED""WITHDRAWAL_FAILED"
type?string

Filtra pelo tipo do registro. Pagamentos recebidos são PAYMENT.

start_date?string

Data inicial (AAAA-MM-DD), considerada a partir de 00:00 no horário de Brasília. Só filtra quando end_date também é enviado.

Formatodate
end_date?string

Data final (AAAA-MM-DD), incluída até 23:59:59 no horário de Brasília. Só filtra quando start_date também é enviado.

Formatodate
amount?integer

Valor exato em centavos da moeda fiduciária (50000 = 500,00).

Intervalo0 <= value
currency?string

Filtra pela moeda fiduciária ou pela moeda cripto do pagamento.

Response Body

Página de pagamentos.

application/json
  1. response
items?array<>
actualPage?integer

Página atual.

pagesQuantity?integer

Total de páginas.

total?integer

Total de registros com os filtros aplicados.

Example Request
curl -X GET 'https://api.gates2b.com/invoices/payment-gateway'
Example Response
{  "items": [    {      "id": "68d2fa97b30181b2d2f13600",      "type": "PAYMENT",      "amount": {        "total": 500,        "final": 88.5,        "currency": "BRL",        "pay_currency": "USDTBSC",        "fiat_currency": "BRL",        "dollar": {          "base": 91.24,          "effective": 88.5        }      },      "transaction": {        "id": "d615bb9b-e935-47c4-ac19-ad046e4b5f1a",        "gatewayId": "6043353044",        "status": "WAITING_PAYMENT",        "extra": {          "image": "iVBORw0KGgoAAAANSUhEUgAA...",          "text": "0x1CEfB8730786f34af8B10dC4e5B8028F79a63abd?amount=91.24"        },        "externalReference": "pedido-0005",        "fees": {          "value": 15        }      },      "client": {        "name": "Maria da Silva",        "email": "cliente@example.com"      },      "options": {        "redirectUrl": null      },      "expireAt": "2026-10-23T14:00:00.000Z",      "createdAt": "2026-10-22T14:00:00.000Z",      "updatedAt": "2026-10-22T14:00:00.000Z"    }  ],  "actualPage": 1,  "pagesQuantity": 1,  "total": 1}

Regras

  • Lista os pagamentos criados por Criar pagamento em cripto. Para cobranças de /charge em cripto, use as consultas de cobrança.
  • O filtro de data só vale com start_date e end_date juntos, e considera dias inteiros no horário de Brasília.
  • amount no filtro é em centavos (50000 = 500,00); no corpo da resposta, os valores são números em unidades da moeda.
  • A resposta pode levar até 45 segundos para refletir um pagamento novo ou uma mudança de status.

Nesta página