¿Cómo conecto mi web o bot con la API?
El equipo de ScarabPay · Actualizado el 19 octubre 2026
Usa la API si quieres que los pedidos se paguen y se entreguen de forma automática. Tu servidor crea una factura, envía al cliente a la página de pago y recibe un webhook firmado cuando llega el pago.
1. Consigue tus claves
Abre tu proyecto y la pestaña Developers. Obtienes una clave live para pagos reales y una clave sandbox para pruebas.
Mantén tu clave en secretoLa clave solo se muestra una vez. Guárdala solo en tu servidor, nunca en una app móvil ni en una página pública. Si se filtra, toca Replace key.
2. Añade tu webhook
- Escribe la URL de tu web o del servidor de tu bot que recibirá los eventos y toca Save.
- Copia el secreto de firma y guárdalo en tu servidor.
- Toca Send test event y comprueba que tu servidor responde con el estado 200.
3. Crea facturas
Envía una solicitud para crear una factura con el importe y tu número de pedido, y redirige al cliente al enlace de pago que recibes. Cuando llegue el evento invoice.paid, entrega el pedido.
Direcciones fijas
Para recargas de saldo en bots puedes dar a cada cliente una dirección de depósito permanente. Cada depósito envía el evento deposit.received.
Tienes ejemplos completos en PHP, Node.js y Python en la documentación de la API.