Saltar al contenido principal
GET
/
charge
/
{chargeId}
curl -X GET "https://api.gates2b.com/charge/{chargeId}" \
  -H "Authorization: Bearer {su-token}"

{
  "id": "chr_abc123",
  "grossAmount": "10.50",
  "currency": "BRL",
  "status": "PENDING",
  "description": "Cobro de prueba",
  "externalReference": "pedido-123",
  "createdAt": "2026-01-15T14:00:00.000Z"
}

Documentation Index

Fetch the complete documentation index at: https://docs.gates2b.com/llms.txt

Use this file to discover all available pages before exploring further.

​
Authorization
string
requerido
Token de autenticación en formato Bearer.
​
chargeId
string
requerido
ID del cobro.

​
Response

​
id
string
ID único del cobro.
​
grossAmount
string
Monto bruto del cobro.
​
currency
string
Moneda del cobro.
​
status
string
Estado actual del cobro (PENDING, PAID, EXPIRED, CANCELED).
​
description
string
Descripción del cobro.
​
externalReference
string
Referencia externa.
​
createdAt
string
Fecha de creación (ISO 8601).
curl -X GET "https://api.gates2b.com/charge/{chargeId}" \
  -H "Authorization: Bearer {su-token}"

{
  "id": "chr_abc123",
  "grossAmount": "10.50",
  "currency": "BRL",
  "status": "PENDING",
  "description": "Cobro de prueba",
  "externalReference": "pedido-123",
  "createdAt": "2026-01-15T14:00:00.000Z"
}

​
Otras consultas disponibles

​
Listar Cobros

GET /charge/list?page=1&limit=10 Retorna la lista paginada de cobros del usuario autenticado.
ParámetroTipoDescripción
pagenumberNúmero de página (por defecto: 1)
limitnumberRegistros por página (por defecto: 10)

​
Buscar por Referencia Externa

GET /charge?externalReference=pedido-123 Busca un cobro por la referencia externa de su sistema.
ParámetroTipoDescripción
externalReferencestringReferencia externa usada en la creación

​
Listar Intentos de un Cobro

GET /charge/{chargeId}/attempts Retorna todos los intentos de pago asociados a un cobro. Cada intento contiene:
CampoTipoDescripción
idstringID del intento
chargeIdstringID del cobro
paymentMethodstringMétodo usado (PIX, CREDIT_CARD, INTERNATIONAL)
statusstringEstado del intento
checkoutMetaobjectMetadatos del gateway

​
Buscar Intento Específico

GET /charge/attempts/{attemptId} Retorna los detalles de un intento específico, incluyendo estado del gateway y checkoutMeta.