Documentación para desarrolladores
Integra cobros, payins, transferencias, verificación y webhooks de Clobepay desde tu servidor. Cada guía existe en español y en inglés.
Primeros pasos
- Inicio rápidoDe la llave de prueba a tu primer link de pago y su webhook, en cinco pasos.
- EntornosPruebas (sk_test_) y producción (sk_live_): datos, URL base y reglas de cada uno.
- Llaves de API y autenticaciónLlaves secretas por comercio (MID) en Authorization: Bearer, scopes, rotación y revocación.
- IdempotenciaReintenta sin duplicar cobros ni transferencias con la cabecera Idempotency-Key.
- ErroresForma de las respuestas de error, códigos estables y qué reintentar.
Integración
- Links de pagoCrea un cobro con página de pago alojada. Nace pending y se confirma solo cuando su payin queda settled.
- Payins y depósitosToda entrada de dinero es un payin: estados, regla pending → settled y cuenta de depósito por MID.
- TransferenciasCotiza y solicita retiros a beneficiarios y billeteras; aprobación y doble firma.
- KYC y KYB por APIVerifica al comercio por API: persona física (KYC) o moral (KYB), documentos y prueba de vida.
- WebhooksAvisos firmados (Clobepay-Signature) con reintentos, rotación de secreto y reenvío.
Recursos
Referencia de la API
Rutas HTTP, parámetros, respuestas, errores y ejemplos en cURL, Node.js y Python listos para usar en tu entorno.