Introducción
Una API para operar todos tus PSPs. Estados, montos y errores normalizados.
Cauril es una capa de orquestación y operación de pagos. Integrás una sola API y operás múltiples proveedores de pago (Stripe, Mercado Pago, dLocal y más) desde una sola consola, con estados, webhooks y datos normalizados.
Qué te da
El mismo request crea un pago en Stripe o en Mercado Pago. Cambiar de proveedor no cambia tu código.
Una sola máquina de estados (succeeded, processing, failed…) para todos los PSPs. Nunca ves estados crudos.
Cada operación mutante lleva una Idempotency-Key. Reintentar jamás cobra dos veces.
Eventos salientes firmados, con reintentos y backoff. Verificás la firma y listo.
Conceptos
- Payment: un cobro. Tiene un
statusnormalizado, montos en unidad mínima (centavos) y el PSP que lo procesó. - Refund: un reembolso total o parcial de un payment.
- Checkout session: un cobro embebido en tu sitio. El drop-in cobra en el browser y vos nunca tocás datos de tarjeta.
- Provider connection: una cuenta de PSP conectada (credenciales cifradas at-rest, nunca devueltas).
- Webhook endpoint: una URL tuya suscrita a eventos; cada entrega va firmada.
- Event: el feed normalizado (
payment.succeeded,refund.succeeded…), accesible por API y por webhook.
Modos test y live
Cada API key es de modo test (sk_test_…) o live (sk_live_…). El modo lo determina la key, no la URL. Empezá en test contra el sandbox de tu PSP y pasá a live cuando estés listo.