Para esta guía vamos a ver como crear una suscripción para cobrar un servicio a un cliente de manera periódica. Digamos que tienes un servicio en el cual ofreces 1 mes de prueba y después cobras una renta mensual de $99.99 pesos indefinidamente (o hasta que tu cliente cancele el servicio). Para ello vamos a hacer lo siguiente:
- Crear plan
- Tokenización de la tarjeta de crédito o débito usando la librería Openpay.js
- Crear cliente
- Asosiación token de tarjeta con cliente
- Suscribir al cliente
Crear plan
Un plan es un plantilla para una suscripción que contiene el costo, frecuencia de cobro, número de días de prueba, etc. Para crear un plan tenemos dos opciones: Opción 1.- Creación desde la APIPuedes tener cuantos planes desees. Por ejemplo puedes tener un plan Oro, Platino y Bronce para diferentes niveles de servicio.Si la llamada es correcta tendremos una respuesta que contiene el
id
del plan Respuesta:Para más información de los parámetros del plan dirígete a “Agregar Plan”.
Opción 2.- Creacion desde el dashboard Puedes crear planes también desde el dashboard en Planes -> Agregar:Tokenización de la tarjeta
Para tokenizar una tarjeta del cliente utilizando la librería Openpay.js. Primero agregamos alhead
el archivo de Openpay.js y el archivo de JQuery: Luego asignamos a la librería de Openpay nuestro merchant-id
y nuestra llave pública (public-key
):Creación del token de tarjeta
Una vez que instalaste y configuraste la librería, para crear un token es necesario llamar al método OpenPay.token.create() Los parámetros que recibe el método son:- El parámetro
CREATE_PARAMETERS_OBJECT
es un objeto Javascript que contiene la información de la tarjeta. - El parámetro
SUCCESS_CALLBACK
define la función que se llamará en caso de que la operación haya sido exitosa. - El parámetro
ERROR_CALLBACK
define la función que se llamará en caso de que la operación haya fallado.
Para mayor referencia del uso de la librería ver la página de Openpay.js
Crear cliente
Bien, ahora crearemos al cliente que vamos a suscribir. Respuesta:Asociación del token de tarjeta al cliente
Ahora sólo resta usar eltoken_id
que viene en la petición para guardar y asignar la tarjeta al cliente. El objeto card contiene un id, el cual debes guardar en tu servidor ya con el podrás hacer cargos a esa tarjeta después. Puedes consultar la referencia de Crear Tarjeta con Token para mas información. Ejemplo de respuesta{
"type":"credit",
"brand":"visa",
"id":"kso4st83wxaibffyt6su",
"card_number":"424242XXXXXX4242",
"holder_name":"Juan Perez Ramirez",
"expiration_year":"15",
"expiration_month":"12",
"allows_charges":true,
"allows_payouts":false,
"creation_date":"2014-02-12T10:57:09-06:00",
"bank_name":"BANCOMER",
"bank_code":"012",
"customer_id":"a2b79p8xmzeyvmolqfja"
}
Notas: Puedes simular diferentes resultados usando las tarjetas de PruebasSuscribir al cliente
Por ultimo crearemos la suscripción con elid
de plan (psjubnktzpofhakixfkp), el id
del cliente (axapgwwolofnckfui2wx) y el id
de tarjeta (kokzmiiwephcdmq1h2qr), con lo cual la petición quedaría así: Respuesta: Listo ya tenemos nuestra suscripción creada, la cual se va a cobrar automáticamente cada mes por $99.99 después de que los días de pruebas transcurran. Notas: - Puedes simular diferentes resultados usando las tarjetas de Pruebas
- Implementa las Notificaciones para conocer el estado de los pagos en tiempo real