Introducción a Pagar y suscribir

Pagar y suscribir permite que tu cliente pague y quede suscrito a pagos automáticos con tarjeta (PAT) en un solo paso. En el mismo formulario de Virtualpos el cliente ingresa su tarjeta, paga el monto de activación y su suscripción queda activa para los cobros siguientes.

Es útil cuando quieres incorporar la suscripción a pagos automáticos dentro de tu proceso de pago habitual, por ejemplo en tu portal de pagos o ecommerce.

Flujo de integración

1. Iniciar Pagar y suscribir: tu sistema llama a POST /v3/pay-and-subscribe. Virtualpos crea la suscripción en estado SUSCRIBIENDO y responde con una url_redirect.
2. Redirigir al cliente a la url_redirect, donde se despliega el formulario de pago y suscripción.
3. El cliente completa el formulario: se tokeniza su tarjeta, se paga el monto de activación y se activa la suscripción.
4. Notificación: Virtualpos envía un POST a tu callback_url (webhook).
5. Retorno: el cliente es redirigido a tu return_url.
6. Consultar el estado de la suscripción con GET /v3/pay-and-subscribe/{subscription_id}.

Nota

La suscripción se asocia a un Plan existente de tu comercio, que se indica con plan_id.

Autenticación y firma

Las llaves y headers son los mismos del resto de la API (ver Autenticación y firma). En Pagar y suscribir, la firma es un JWT HS256 firmado con tu SECRET KEY cuyo payload contiene la fecha de creación de la solicitud:

{ "ciat": 1767225600 }

ciat es el timestamp Unix (en segundos) del momento en que se genera la solicitud.

Ambientes

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

Colección Postman

Las operaciones están disponibles en la colección Virtualpos - Pagar y suscribir del workspace público de Virtualpos en Postman.