// Developers

API REST estable.
SDKs por lenguaje.
Sandbox abierto.

Documentación clara, ejemplos reales por país y un sandbox con datos sintéticos para que tu equipo iterare sin riesgo desde el día uno.

Ver quickstart → Solicitar API key
// 01 — Quickstart

Crea tu primer cobro en 8 líneas.

checkout.js
node 20.11 · macOS arm64

    

  






  

    // 02 — API reference
    
Endpoints principales.


    

      

        
POST

        
/v1/checkout/sessions

        
Crea una sesión hosted o drop-in

      

      

        
GET

        
/v1/checkout/sessions/:id

        
Recupera el estado de la sesión

      

      

        
POST

        
/v1/payments

        
Carga directa (server-side, no hosted)

      

      

        
POST

        
/v1/payments/:id/refunds

        
Reembolsa total o parcial

      

      

        
POST

        
/v1/payouts

        
Envío push a cuenta o wallet del beneficiario

      

      

        
GET

        
/v1/methods?country=BR

        
Lista métodos disponibles por mercado

      

      

        
POST

        
/v1/customers

        
Crea un cliente con sus tokens vaulted

      

      

        
POST

        
/v1/subscriptions

        
Suscripción recurrente con mandato

      

      

        
POST

        
/v1/webhooks/endpoints

        
Registra un endpoint para recibir eventos

      

      

        
GET

        
/v1/balance

        
Saldo disponible por moneda

      

    


    

      OpenAPI 3.1 spec ↗
      Postman collection ↗
      Generadores cliente ↗
    

  






  

    // 03 — Características
    
Lo que esperarías de una API enterprise.


    

      

        

        
Idempotencia nativa

        
Header `Idempotency-Key` en todos los POST. Reintentos seguros sin duplicar cargos.

      

      

        

        
Webhooks firmados

        
HMAC-SHA256 con timestamp para mitigar replay. Reintento exponencial hasta 72 h.

      

      

        

        
Versionado por header

        
`Key2pay-Version: 2025-09-01`. Sin breaking changes en 24 meses garantizado.

      

      

        

        
Rate limit generoso

        
500 req/s en sandbox, ajustable por SLA en producción. Backoff con header `Retry-After`.

      

      

        

        
Status page público

        
status.key2pay.com con histograma por endpoint, subscripción por componente.

      

      

        

        
Datos sintéticos

        
Sandbox con 30 K clientes ficticios y BINs reales por país. Test cards documentadas.