Skip to main content
POST
Crea un cargo (débito) a una tarjeta del cliente autenticado. Se envía una solicitud de aprobación al cliente vía WhatsApp. El cargo se ejecuta cuando el cliente aprueba, o expira automáticamente en 5 minutos. Usa GET /customers/session/charges/ para consultar el estado del cargo mientras esperas la aprobación.
Solo se permite un cargo pendiente por tarjeta. Si ya existe un cargo en estado created, el endpoint retornará error 422.

Headers

string
required
Token de idempotencia único (UUID) para evitar cargos duplicados. Obligatorio en este endpoint.
string
required
Bearer token de tu empresa.
string
required
Token de sesión del cliente obtenido en /customers/login/verify.

Body

string
required
ID de la tarjeta del cliente. Debe pertenecer al cliente autenticado y coincidir con el modo (test/live).
integer
required
Monto del cargo en centavos. Mínimo: 100 (equivale a $1 COP).
string
required
Moneda del cargo. Valores válidos: COP, USD.
string
required
Descripción del cargo. Máximo 255 caracteres.

Flujo de aprobación