Autenticación
Una clave secreta identifica a tu negocio y al entorno de cada petición.
Obtén tu clave
En el dashboard, abre Desarrolladores → Claves API. Guarda la clave como BILLETE_API_KEY en las variables privadas de tu servidor.
| Prefijo | Entorno |
|---|---|
sk_test_ | Prueba, sin cobros reales |
sk_prod_ | Producción, con pagos reales |
Los recursos de prueba y producción están aislados. Para operar en producción, tu negocio debe completar su verificación y estar aprobado.
Haz una petición
curl https://api.billete.run/v1/customers \
-H "Authorization: Bearer $BILLETE_API_KEY" \
-H "Billete-Version: 2026-10-24"Toda petición dice con qué versión de la API está escrita en Billete-Version. Para enviar JSON, añade Content-Type: application/json. En las mutaciones, envía también una clave de idempotencia.
La clave se queda en tu servidor
No la incluyas en JavaScript público, URLs, capturas, registros ni repositorios. Para el navegador usa el cliente público del SDK.