Iniciar Pagar y suscribir

Inicia un pago y una suscripción de forma simultánea. La respuesta incluye la url_redirect a la que debes enviar a tu cliente para que complete el pago y la suscripción.

POST /v3/pay-and-subscribe

Ambiente	URL base API	Portal de comercio
Sandbox	https://api.virtualpos-sandbox.com	comercios.virtualpos-sandbox.com
Producción	https://api.virtualpos.cl	comercios.virtualpos.cl

Headers

Nombre	Requerido	Descripción
Content-Type	Sí	application/json
Authorization	Sí	API KEY del comercio
Signature	Sí	JWT HS256 firmado con la SECRET KEY, payload {"ciat": <timestamp>}. Ver firma.

Body

Campo	Tipo	Descripción
email	string	Correo del cliente asociado al pago y suscripción.
social_id	string	RUT del cliente.
first_name	string	Nombre del cliente.
last_name	string	Apellido del cliente.
phone_number	string	Teléfono del cliente.
service_id	string	Parámetro informado por el comercio para asociarlo a la suscripción y pago.
channel	string	Canal utilizado por el comercio para iniciar el proceso de suscripción.
return_url	string	URL a la que será redirigido el cliente al finalizar el flujo. Debe estar codificada en Base64.
callback_url	string	URL a la que se enviará un callback asíncrono al finalizar el proceso de inscripción. Debe estar codificada en Base64.
activation_amount	int32	Monto del pago para activar la suscripción.
payment_description	string	Breve descripción del pago.
merchant_internal_code	string	Identificador de tu negocio que representa el pago, por ejemplo número de pedido o factura.
plan_id	string	Identificador del plan del comercio.

Ejemplo de request

curl -X POST 'https://api.virtualpos-sandbox.com/v3/pay-and-subscribe' \
  -H 'Content-Type: application/json' \
  -H "Authorization: $API_KEY" \
  -H "Signature: $SIGNATURE" \
  -d '{
  "email": "john@virtualpos.cl",
  "social_id": "17890123-8",
  "first_name": "John",
  "last_name": "Doe",
  "phone_number": "56912345678",
  "service_id": "serviceid-123",
  "channel": "PORTAL",
  "return_url": "aHR0cHM6Ly9odHRwYmluLm9yZy9wb3N0",
  "callback_url": "aHR0cHM6Ly9odHRwYmluLm9yZy9wb3N0",
  "activation_amount": "2000",
  "payment_description": "descripcion de pago",
  "merchant_internal_code": "123456",
  "plan_id": "80c9ffe06b031702f180596bc208898c"
}'

Respuestas

Código	Descripción
200	Solicitud exitosa
400	Solicitud incorrecta o faltan parámetros
401	Falla de autenticación por credenciales incorrectas

200 OK

{
  "url_redirect": "https://suscripciones-pat.virtualpos-sandbox.com/pay-and-subscribe/init/subsc_3c127236-203c-48ce-8659-b097f09ba16d",
  "subscription": {
    "id": "subsc_3c127236-203c-48ce-8659-b097f09ba16d",
    "status": "SUSCRIBIENDO",
    "created_at": "2025-08-13 15:07:56",
    "channel": "ecommerce",
    "service_id": "serviceid-123",
    "activation_payments": [
      {
        "activation_amount": 2000,
        "payment_description": "descripcion de pago",
        "merchant_internal_code": "123456",
        "status": "pendiente"
      }
    ],
    "client": {
      "email": "john@virtualpos.cl",
      "social_id": "18665880-2",
      "first_name": "John",
      "last_name": "Doe",
      "phone_number": "56966744588"
    }
  }
}