Saltar al contenido

Activación de SIM

Descripción

Este método permite activar una eSIM de Axios Mobile con una oferta seleccionada. Una vez completada la activación, el cliente recibirá los datos de su eSIM y un QR de activación.


URL API

https://apidevstore.axiosmobile.mx/v2

Parámetros de entrada

Los parámetros que debes incluir en tu solicitud son los siguientes:

ParámetroTipoRequeridoDescripciónEjemplo
carrierCodestringCódigo de carrier/SKU. Valores aceptados: 204, 212, 301, 303, 215."204"
amountnumberMonto de la transacción. Debe ser un número positivo.150
fullNamestringNombre completo del cliente."Juan Pérez"
contactPhonestringTeléfono de contacto del cliente."5512345678"
emailstringCorreo del cliente. Se usa para enviar el recibo."juan@example.com"
channelstringNoCanal de envío del recibo: email (default) o whatsapp."email"

Ejemplo de Uso

Método: POST
Endpoint: {{API}}/transactions
Headers: {{token}}

Body JSON

{
"carrierCode": "204",
"amount": 150,
"fullName": "Juan Pérez",
"contactPhone": "5512345678",
"email": "juan@example.com",
"channel": "email"
}

Response Success

{
"status": "COMPLETED",
"folio": "100036a358d5f64d032661114acfc",
"description": "TRANSACCIÓN EXITOSA",
"simData": {
"imsi": "334140179156088",
"iccid": "8952140062227833246F",
"msisdn": "5632158420",
"pin": "1234",
"puk": "63011475",
"serie": "00361",
"product": "ESIM",
"qrLink": "https://axios-mobile.s3.us-east-2.amazonaws.com/esims/8952140062227833246F.png"
}
}

Parámetros de salida

ParámetroTipoDescripciónEjemplo
statusstringEstado final de la transacción."COMPLETED"
foliostringIdentificador de la transacción."100036a358d5f64d032661114acfc"
descriptionstringDescripción del resultado."TRANSACCIÓN EXITOSA"
simData.imsistringIdentificador IMSI de la SIM."334140179156088"
simData.iccidstringICCID de la eSIM."8952140062227833246F"
simData.msisdnstringNúmero telefónico asignado."5632158420"
simData.pinstringPIN de la SIM."1234"
simData.pukstringCódigo PUK."63011475"
simData.seriestringSerie de la SIM."00361"
simData.productstringTipo de producto."ESIM"
simData.qrLinkstringURL pública del QR de activación de la eSIM."https://axios-mobile.s3..."

Estos son los parámetros que recibirás al realizar la solicitud. Asegúrate de manejar los datos correctamente en tu aplicación.


Diagrama de flujo

flowchart TD A([El cliente solicita activar una eSIM]) --> B{¿Datos completos\ny saldo suficiente?} B -->|No| X[Se rechaza la solicitud] B -->|Sí| C{¿Hay eSIM\ndisponible?} C -->|No| Y[Sin inventario disponible] C -->|Sí| D[Se procesa la activación] D --> E{¿La activación\nfue exitosa?} E -->|No| Z[Transacción fallida] E -->|Sí| F[eSIM activada y asignada] F --> G([El cliente recibe los datos de su eSIM\ny el QR de activación]) G --> H[Se envía el recibo\npor correo o WhatsApp]