Skip to main content
GET
/
api
/
v1
/
merchants
/
me
/
charges
/
{external_id}
curl https://crypto.cucu.ai/api/v1/merchants/me/charges/CHG-20260125-00042 \
  -H "X-API-Key: sk_live_xxxx"

{
  "charge_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "external_id": "CHG-20260125-00042",
  "provider": "cucu_pay",
  "amount": 50.00,
  "currency": "USDT",
  "status": "completed",
  "checkout_url": "https://crypto.cucu.ai/checkout/a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "expires_at": "2026-01-25T15:30:00Z",
  "metadata": {"user_id": "usr_abc123"},
  "created_at": "2026-01-25T15:15:00Z",
  "updated_at": "2026-01-25T15:22:45Z"
}
Retorna el estado actual de un cobro. Responde con el mismo schema que la creación, con status actualizado.

​
Headers

HeaderTipoReqDescripción
X-API-KeystringSíAPI Key del merchant

​
Path Params

ParámetroTipoDescripción
external_idstringEl external_id o charge_id recibido al crear el cobro.

​
Response

Mismo schema que Crear Cobro, con status reflejando el estado actual.
EstadoDescripción
createdCobro generado, esperando que el usuario inicie el pago.
pendingPago detectado en la red, esperando confirmaciones.
completedPago confirmado. Fondos recibidos.
expiredSuperó expiration_minutes sin ser pagado.
cancelledCancelado programáticamente.
failedPago detectado pero rechazado.
curl https://crypto.cucu.ai/api/v1/merchants/me/charges/CHG-20260125-00042 \
  -H "X-API-Key: sk_live_xxxx"

{
  "charge_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "external_id": "CHG-20260125-00042",
  "provider": "cucu_pay",
  "amount": 50.00,
  "currency": "USDT",
  "status": "completed",
  "checkout_url": "https://crypto.cucu.ai/checkout/a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "expires_at": "2026-01-25T15:30:00Z",
  "metadata": {"user_id": "usr_abc123"},
  "created_at": "2026-01-25T15:15:00Z",
  "updated_at": "2026-01-25T15:22:45Z"
}