Documentación de eSIMTrade
api.esimtrade.com
Documentación práctica y clara de la API para revendedores.
Empieza por la autenticación, comprueba el saldo, consulta los planes y después trabaja con pedidos e inventario. Cada página de ruta explica la autenticación, los campos de la solicitud, la respuesta y ejemplos que puedes copiar.
Crear pedido
Realiza una compra de revendedor con el precio de tu cuenta y el saldo prepago. Se admite la idempotencia.
Ruta de API
POST /portal/order
Funcionamiento de la ruta
Envía el slug de un plan y la cantidad para crear un pedido. Se comprueban el precio de tu cuenta y el saldo disponible; la respuesta incluye el resultado de la compra.
Si envías idempotencyKey y repites la misma compra, la API puede devolver el resultado original en lugar de crear un pedido duplicado.
| Campo del cuerpo | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| slug | string | Sí | Slug del plan obtenido en la respuesta de planes |
| qty | number | No | Cantidad; el valor predeterminado es 1 |
| days | number | No | Valor opcional del periodo específico del proveedor |
| idempotencyKey | string | Recomendado | Clave estable para reintentos del cliente |
Si el saldo prepago es insuficiente, se devuelve HTTP 402. Los conflictos por compras idempotentes duplicadas pueden devolver HTTP 409.
Crear pedido
curl --location --request POST 'https://api.esimtrade.com/api/v1/portal/order' \
--header 'x-access-code: YOUR_ACCESS_CODE' \
--header 'x-secret-key: YOUR_SECRET_KEY' \
--header 'Content-Type: application/json' \
--data '{
"slug": "japan-5gb-30days",
"qty": 1,
"idempotencyKey": "order-20260417-001"
}'Ejemplo de error de validación
{
"error": "Invalid quantity"
}En esta página