Inicio rápido

1. Obtén tu clave APICopiar enlace

Inicia sesión en SMSPVA y abre Profile and ApiKey en el menú de tu cuenta.

Guarda la clave en una variable de entorno del servidor para que tu aplicación la lea sin incluirla en el código fuente. No la expongas en el navegador ni en repositorios públicos.

export SMSPVA_API_KEY="YOUR_API_KEY"

2. Consulta tu saldoCopiar enlace

Activation V2 usa https://api.smspva.com y la cabecera apikey. El ejemplo cURL requiere un shell POSIX (macOS, Linux o WSL). En Windows, JavaScript y Python también funcionan desde PowerShell. JavaScript requiere Node.js 22.16+; Python utiliza la biblioteca estándar (3.10+).

curl --fail-with-body --max-time 30 \
  'https://api.smspva.com/activation/balance' \
  --header "apikey: $SMSPVA_API_KEY"

3. Interpreta la respuestaCopiar enlace

{
  "statusCode": 200,
  "data": { "balance": "10.50" }
}

Tu respuesta mostrará el saldo de tu cuenta. balance es una cadena de texto; consérvala al mostrar el importe. Antes de usar data, comprueba la respuesta HTTP y los errores de la API.

Una clave ausente o de longitud incorrecta devuelve HTTP 400 con APIKEY_NOT_SET. Si la solicitud agota el tiempo de espera, todavía no tienes un resultado confirmado.

Siguientes pasosCopiar enlace

Consulta la referencia del saldo, el plan de SDKs o MCP y Markdown.

Continúa con el flujo de activación, la referencia completa y los ejemplos en ocho lenguajes. No repitas automáticamente una compra tras un fallo de conexión: la primera solicitud podría haberse completado.