El enlace de pago resuelve muchas ventas, pero llega un momento en que el negocio necesita más: cobrar directamente en la web, en la app o desde el ERP, sin copiar ni pegar nada. Ahí entra la API de pagos.
Qué es una API de pagos
Una API (interfaz de programación de aplicaciones) es el canal de comunicación entre tu sistema y la plataforma de pagos. Con ella, tu software crea cobros, sigue su estado y recibe confirmaciones de forma automática, mediante peticiones HTTP con datos en JSON.
Cómo funciona la integración, paso a paso
- Crea la cuenta y genera las claves: en el panel de Sila Pay, el menú API Key genera tu api-key y tu secret-key, que se envían en el header de cada petición.
- Crea el cobro: tu sistema envía un POST a https://api.silapay.pro/v1/transactions con el importe, los datos del cliente y el medio de pago (pix, creditCard o billet).
- Muestra el pago al cliente: en Pix, la respuesta incluye el código copia y pega; en boleto, el cobro se emite con el vencimiento que definiste; en tarjeta, recibes el resultado de la transacción.
- Recibe la confirmación: indica una postbackUrl y tu sistema recibirá un aviso por webhook cuando cambie el estado del pago.
Pix, tarjeta y boleto: qué cambia en cada uno
- Pix: el cobro se crea con estado pendiente y un código copia y pega; la confirmación llega por webhook en cuanto se identifica el pago.
- Tarjeta de crédito: admite pagos a plazos, indicando el número de cuotas en la petición, y puede llevar al cliente a una página de éxito (successUrl).
- Boleto: defines el vencimiento y puedes enviar una referencia propia (externalReference) para vincular el cobro al pedido.
Ventajas de integrar por API
- Tú controlas la experiencia: decides dónde y cómo ve el cliente el cobro.
- Menos trabajo manual: pedidos creados y confirmados automáticamente.
- Una integración, tres medios de pago: Pix, tarjeta y boleto en el mismo endpoint.
- Crece con tu negocio: el mismo flujo sirve para pocos o muchos pedidos al día.
¿Quieres integrar pagos en tu sistema? Crea tu cuenta en Sila Pay
Buenas prácticas de integración
- Claves solo en el servidor: nunca pongas la api-key ni la secret-key en el front-end o en la app; las llamadas deben salir de tu back-end.
- Valida los webhooks: comprueba el header X-Silapay-Signature antes de marcar el pedido como pagado.
- Guarda el ID de la transacción: vincula el id que devuelve la API con el pedido de tu sistema.
- Gestiona errores y tiempos de espera: muestra un mensaje claro y permite reintentar sin duplicar el cobro.
- Empieza con importes bajos: prueba el flujo completo antes de abrirlo a todos los clientes.
Preguntas frecuentes
¿Necesito un desarrollador?
Para integrar por API, sí: alguien tiene que programar las llamadas en tu sistema. Si usas WooCommerce o Shopify, los plugins de Sila Pay son un camino más sencillo; y si no tienes web, el enlace de pago ya lo resuelve.
¿Dónde está la documentación?
En doc.silapay.pro, con las llamadas de Pix, tarjeta, boleto, saldo y webhooks, además de ejemplos de petición y respuesta.
¿La API sirve solo para cobrar?
No. Además de crear cobros, la documentación describe el envío de Pix (cash-out) y la consulta de saldo.
¿Necesito una empresa brasileña (CNPJ)?
En Sila Pay puedes vender como persona física o jurídica; el registro indica los documentos necesarios en cada caso.
Integra Pix, tarjeta y boleto con una sola API. Regístrate en Sila Pay