Integración por API
DisponibleIntegración por API
¿Piensas vender eSIM dentro de tu propia app o de tu proceso de reserva? Cuéntanos qué necesitas.
La API está disponible para socios aprobados cuando ventas habilita el acceso. Crea una clave de solo lectura o con permiso para pedidos en el panel de socios. Todas las compras usan tu monedero prepagado en USD.
Inicio rápido de la API
Tras aprobar tu cuenta, ventas asigna los precios y habilita el acceso a la API. Crea una clave en el panel de socios. Las claves de solo lectura no pueden realizar pedidos. Tu cuenta también debe tener habilitadas las compras.
https://simvoro.com/api/partner/v1Usa una clave bearer desde el servidor en cada solicitud. No incluyas la clave en el código del navegador ni en URLs. Puedes revocarla en el panel de socios.
Authorization: Bearer YOUR_API_KEY| Método | Endpoint | Resultado |
|---|---|---|
| GET | /products?destination=japan | Tus precios asignados en USD e IDs de producto. Filtra por el slug del destino y pagina con cursor. |
| GET | /balance | Saldo del monedero, fondos reservados y USD disponibles. |
| GET | /transactions | Transacciones del monedero y nextCursor. |
| GET | /orders | Resúmenes de pedidos de socios y nextCursor (50 por página). |
| POST | /orders | Reserva fondos y pide una eSIM. Requiere una clave con permiso para pedidos. |
| GET | /orders/{orderId} | Estado del pedido, último consumo de datos sincronizado y datos de instalación tras la entrega. |
Crear un pedido
Envía un UUID como Idempotency-Key. Reutiliza el mismo UUID tras un tiempo de espera agotado o un fallo de conexión. Envía el precio confirmado por el cliente y confirma que el dispositivo admite eSIM y está desbloqueado. Los cambios de precio en tiempo real devuelven 409 PRICE_CHANGED. Esta API es real; las compras aceptadas usan fondos reales del monedero.
POST /api/partner/v1/orders
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
Idempotency-Key: 83c77d9f-395f-4ff0-8ed6-c461bda46559
{"productId":"PRODUCT_ID_FROM_CATALOG","expectedPrice":"2.25","deviceConfirmed":true}Una respuesta 201 contiene orderId y esim; revisa esim.status y esim.failure. Consulta el pedido cada 10 segundos. Los fondos se reservan primero y se cobran al verificar la entrega. Una repetición también puede devolver un pedido fallido. Si el resultado del proveedor es incierto, los fondos siguen reservados mientras se concilia el pedido original. Los datos de instalación son privados y solo aparecen tras verificar la entrega.
Los importes son cadenas decimales en USD. Las listas devuelven items y nextCursor; continúa hasta que nextCursor sea null. Límites: 120 solicitudes por clave y minuto y 10 intentos de compra por usuario y minuto. Respeta Retry-After ante un 429. Errores habituales: 401 clave inválida, 403 sin permiso, 402 fondos insuficientes, 404 pedido inaccesible, 409 conflicto de precio o idempotencia, 503 servicio no disponible. Consulta el pedido original antes de intentar otra compra.
Qué incluir en tu solicitud
- Tu plataforma y quiénes son tus clientes
- Tu volumen mensual previsto
- Los destinos que quieres ofrecer
- Qué tiene que hacer tu sistema, por ejemplo, pedir una eSIM y mostrar su código QR a tu cliente
Asociarse con nosotros
Envía una solicitud y nuestro equipo se pondrá en contacto contigo al respecto.