Integraste una API PIX. Todo funcionó en sandbox. Fuiste a producción. Dos días después, empiezan los tickets en soporte: “el pago no cayó”, “el QR Code expiró”, “el webhook no llegó”. Miras el panel y descubres que el 12% de las transacciones fallaron por timeout, el retry no existía, y la conciliación se volvió una planilla. Es el escenario más común en equipos que contratan la primera API PIX que encuentran en vez de evaluar cuál es la correcta para una operación en escala.
Esta guía es para desarrolladores, tech leads y gerentes de producto LATAM que procesan PIX en Brasil y necesitan elegir una API que aguante 10, 100 o 1000 transacciones por minuto sin romperse. Vas a entender: qué debe entregar una API PIX de verdad, cómo funciona el flujo técnico (Cash-In, Cash-Out, Cob, Split), los 8 criterios para evaluar proveedores, la comparación honesta de las alternativas del mercado, y los errores comunes que destruyen la conversión.
Una API PIX es la interfaz programática que permite que tu sistema cree, reciba y gestione transacciones PIX sin intervención humana. En la práctica, tu aplicación hace llamadas HTTP/REST a los endpoints del proveedor, que se comunica con el BACEN (Banco Central de Brasil) y los participantes del sistema PIX para liquidar el pago en segundos. La API cubre cobro (QR Code estático y dinámico), recepción (Cash-In), envío (Cash-Out), split automático y webhooks de confirmación.
La confusión común es pensar que “API PIX” es una sola cosa. En realidad, existen 4 tipos principales, y lo que tu operación necesita depende del modelo de negocio:
Imagina un infoproducto de US$95 vendido a las 20:47 de un sábado a un cliente en São Paulo. El flujo técnico de una API PIX bien arquitecturada:
/v2/cob con monto, identificador del pedido (txid) y datos del pagador. Latencia esperada: <300ms.Tiempo total desde el clic del cliente hasta la liberación del producto: 10 a 30 segundos. Ese es el benchmark de una buena API PIX. Si demora más que eso, hay cuello de botella en la infraestructura del proveedor.
PIX es gratuito para el usuario final, pero no es perfecto. Las empresas pierden hasta el 15% de los intentos de pago por motivos que una API PIX profesional resuelve y una amateur ignora:
| Criterio | Qué exigir | Red flag |
|---|---|---|
| SLA de uptime contractual | 99,9% con compensación por incumplimiento en el contrato | “99,9%” solo en el sitio web, sin contrato |
| Latencia documentada | p95 de creación de cobro <400ms | No tienen métricas públicas |
| Webhook con retry automático | At-least-once delivery con idempotency key | Webhook “best effort” sin retry |
| Tarifa negociable por volumen | Negociación desde US$60K/mes agregado | Tarifa fija “take it or leave it” |
| Sandbox funcional | Ambiente gratuito que espeja producción | Sin sandbox o sandbox limitado |
| SDKs oficiales | Node, Python, PHP, Go mínimo | Solo REST crudo, sin librerías |
| Soporte técnico directo | WhatsApp/Slack con ingeniería 24/7 | Solo email comercial en horario laboral |
| Conciliación y Split nativos | Match por txid, CPF o metadata custom | Conciliación vía planilla exportada |
La API PIX de BSPay fue construida para operaciones que escalan de 100 a 100.000 transacciones por día sin rewrite. Cubre Cash-In, Cash-Out, Cob, CobV y Split nativo — todo en la misma integración REST. Diferencial técnico: el orquestador interno gestiona múltiples proveedores PIX detrás de la API única, así que cuando uno cae, las transacciones rotan automáticamente sin que tengas que hacer nada. Más de 30.000 empresas activas procesan PIX por BSPay hoy.
Tarifa desde 2,99% negociable por volumen agregado, webhook con retry automático, SDKs oficiales en Node/Python/PHP, sandbox completo y soporte técnico vía grupo WhatsApp dedicado 24/7. Nuestro equipo te ayuda a migrar desde cualquier proveedor PIX actual sin downtime — mantienes el flujo operativo corriendo mientras cambias la capa de pago. Mira todas las funcionalidades en la home o habla con un especialista.
La integración básica (crear cobro + recibir webhook) toma 1-3 días para un desarrollador mid-level. La integración completa con Cash-Out, Split y conciliación automática toma 1-2 semanas. Con SDKs oficiales, ambos plazos se reducen a la mitad.
En APIs profesionales, la tasa de aprobación PIX está entre 96% y 99%. Una tasa por debajo del 94% indica problema en el proveedor o en el TTL del QR Code. Los rechazos en PIX suelen ser cuenta bloqueada, saldo insuficiente en el momento o QR expirado — no “tarjeta cancelada” como en tarjeta.
Para el usuario final el PIX es gratuito. Para el comercio, la API cobra fee por transacción (entre 0,99% y 4%, dependiendo del proveedor y del volumen). Un volumen agregado arriba de US$60.000/mes permite negociar una tarifa inferior al 2% en el mercado profesional.
Sí. Cualquier API PIX seria ofrece ambiente sandbox gratuito con transacciones simuladas idénticas a producción. Si el proveedor rechaza el sandbox o pide firma antes de testear, red flag. Debes poder integrar y probar el flujo completo antes de cualquier compromiso comercial.
API PIX es la interfaz técnica (endpoints REST, webhooks). Pasarela PIX (gateway) es la capa de producto que agrega API + checkout + panel + conciliación + antifraude en una solución vendida como paquete. Una API PIX pura exige que construyas todo en tu backend; una pasarela entrega más listo. En BSPay tienes ambos: API REST cruda para quien quiere control total, y pasarela lista para quien quiere velocidad.
Sí. PIX Automático (lanzado por BACEN en 2025) permite cobro recurrente autorizado por el cliente una sola vez, similar a débito automático. Las APIs PIX modernas ya exponen ese flujo — es lo que viabiliza suscripciones SaaS, mensualidades de cursos y planes recurrentes sin depender de tarjeta.
Depende del proveedor. Las APIs profesionales permiten operación multi-CNPJ con credenciales separadas por entidad, panel consolidado y conciliación aislada. Si el proveedor exige integración separada por CNPJ, vas a duplicar trabajo de ingeniería y contabilidad.
Sí, siempre que se sigan las prácticas estándar: HTTPS obligatorio, autenticación vía OAuth 2.0 o API key rotable, IP whitelisting opcional para endpoints críticos (Cash-Out), y verificación de firma HMAC en los webhooks. El riesgo real no es la API en sí, sino la mala configuración de tu lado (credenciales en código fuente público, webhook sin autenticación).