¿Cuál API necesito?
SPIDI tiene dos APIs. Cuál usas depende de quién eres y de cómo recibes pagos.
¿Por dónde empiezo? — ¿Necesitas programar?
- No programo / quiero empezar hoy → SPIDI Center (el panel) o un plugin (WooCommerce/Shopify). Sin código.
- Programo y recibo pagos online (web, app, enlace) → API Productos (este portal). → Recibe tu primer pago.
- Programo y recibo pagos presenciales con tarjeta (terminal/POS) → API Merchant.
¿Ya sabes que vas por API? Sigue debajo para el detalle de cada una.
1. ¿Para quién es cada API?
🛒 API Productos — si recibes pagos online. Para equipos que reciben pagos desde una web, una app o por un enlace.
- Comercio directo: integras tu propio checkout, botón o enlaces de pago.
- Plataforma / integrador: un SaaS, una plataforma e-commerce o plugins (WooCommerce/Shopify) que ofrecen SPIDI a muchos comercios.
🏪 API Merchant — si cobras con tarjeta en un punto de venta físico (POS). Para proveedores y desarrolladores de soluciones de punto de venta (terminales, software de caja, apps para datáfonos, ERPs de tienda) que integran SPIDI como medio de pago presencial con tarjeta: emparejan terminales, atienden el pago a dos tiempos y cierran el lote del día.
¿No programas? Si eres un comercio y no desarrollas, usa SPIDI Center o un plugin listo (WooCommerce/Shopify), o escríbenos. No necesitas tocar el API.
2. Decisión rápida
- ¿Recibes pagos online (web, app o enlace)? → API Productos. → Recibe tu primer pago · Ver API Productos
- ¿Recibes en un punto de venta físico (terminal/datáfono, POS)? → API Merchant. → Ver API Merchant
3. Señales para reconocer tu caso
| Si tu caso es… | API | Modo |
|---|---|---|
| Checkout o botón de pago en tu web o app | Productos | Directo |
| Enviar un pago por WhatsApp, correo o QR | Productos | Directo |
| Suscripciones o pagos recurrentes a un mismo cliente | Productos (Paradas) | Directo |
| Repartir un pago entre varios receptores | Productos (Split) | Directo |
| Un plugin o SaaS que pone SPIDI en muchas tiendas | Productos | Integrador → ver modo integrador |
| Un datáfono o caja registradora física (punto de venta / POS) | Merchant | Directo |
| Software de punto de venta para muchos comercios | Merchant | Integrador → ver modo integrador |
| Cuadrar y cerrar el lote del día de una terminal | Merchant | Directo |
4. Comparación
| Eje | Productos (pagos online) | Merchant (punto de venta / POS) |
|---|---|---|
| Para qué | E-commerce, enlaces, web/app | Terminales, pagos presenciales |
| Con qué paga tu cliente | Cuenta, Pago Móvil, cripto | Tarjeta |
| Dónde | Online (web/app/enlace) | Presencial (en tu local) |
| Dominio | spidipagos.com | spuntodeventa.com |
| Cómo integras | Creas una sesión y rediriges al payment_url | Emparejas el terminal y operas el pago |
| Cómo confirmas | Consultas el status + avisos automáticos | Pago a dos tiempos con confirmación |
| Recursos | Botón, Solicitud, Split, Paradas | Transacciones, anulaciones, cierres |
5. Señales de confianza
SPIDI cuenta con el respaldo de Banco Sofitasa y liquida en bolívares de forma directa. Recibes tu dinero en Bs sin importar si tu cliente paga con cuenta bancaria, Pago Móvil, cripto (online, con Productos) o tarjeta (presencial, con Merchant).
6. Modo integrador
¿Integras SPIDI en nombre de otros comercios (un plugin o un SaaS para muchas tiendas)? El modo integrador permite identificar al integrador y al cliente final. → Atribución del integrador (disponible en una fase posterior).
7. ¿Y dentro de Productos?
- Botón: pago dentro de tu web o app. · Solicitud: enlace que envías por un canal externo.
- Paradas: una URL permanente por cliente para pagos recurrentes. · Split: repartir entre varios receptores.
8. Siguiente paso
¿Listo? → Recibe tu primer pago (tutorial de Productos, Botón web).