curl https://crypto.cucu.ai/api/v1/merchants/me/charges/CHG-20260125-00042 \
-H "X-API-Key: sk_live_xxxx"
const response = await fetch(
'https://crypto.cucu.ai/api/v1/merchants/me/charges/CHG-20260125-00042',
{ headers: { 'X-API-Key': 'sk_live_xxxx' } }
);
const data = await response.json();
import requests
response = requests.get(
'https://crypto.cucu.ai/api/v1/merchants/me/charges/CHG-20260125-00042',
headers={'X-API-Key': 'sk_live_xxxx'}
)
print(response.json())
{
"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"
}
{
"detail": "charge not found"
}
Endpoints
GET /charges/{id} — Consultar Cobro
Retorna el estado actual de un cobro.
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"
const response = await fetch(
'https://crypto.cucu.ai/api/v1/merchants/me/charges/CHG-20260125-00042',
{ headers: { 'X-API-Key': 'sk_live_xxxx' } }
);
const data = await response.json();
import requests
response = requests.get(
'https://crypto.cucu.ai/api/v1/merchants/me/charges/CHG-20260125-00042',
headers={'X-API-Key': 'sk_live_xxxx'}
)
print(response.json())
{
"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"
}
{
"detail": "charge not found"
}
Retorna el estado actual de un cobro. Responde con el mismo schema que la creación, con
status actualizado.
Headers
| Header | Tipo | Req | Descripción |
|---|---|---|---|
X-API-Key | string | Sí | API Key del merchant |
Path Params
| Parámetro | Tipo | Descripción |
|---|---|---|
external_id | string | El external_id o charge_id recibido al crear el cobro. |
Response
Mismo schema que Crear Cobro, constatus reflejando el estado actual.
| Estado | Descripción |
|---|---|
created | Cobro generado, esperando que el usuario inicie el pago. |
pending | Pago detectado en la red, esperando confirmaciones. |
completed | Pago confirmado. Fondos recibidos. |
expired | Superó expiration_minutes sin ser pagado. |
cancelled | Cancelado programáticamente. |
failed | Pago detectado pero rechazado. |
curl https://crypto.cucu.ai/api/v1/merchants/me/charges/CHG-20260125-00042 \
-H "X-API-Key: sk_live_xxxx"
const response = await fetch(
'https://crypto.cucu.ai/api/v1/merchants/me/charges/CHG-20260125-00042',
{ headers: { 'X-API-Key': 'sk_live_xxxx' } }
);
const data = await response.json();
import requests
response = requests.get(
'https://crypto.cucu.ai/api/v1/merchants/me/charges/CHG-20260125-00042',
headers={'X-API-Key': 'sk_live_xxxx'}
)
print(response.json())
{
"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"
}
{
"detail": "charge not found"
}
⌘I