Pagos recurrentes

[Aldo]

Hola, quiero implementar el sistema de pagos recurrentes. En su pagina para desarrolladores existen dos secciones sobre Pagos recurrentes, la primer es en base de peticiones y la segunda es para configurar sobre el portal. En la segunda se menciona que solo esta habilitado para Colombia y Brasil. ¿Los Pagos recurrentes se pueden usar en México? de ser así me podrían proporcionar la descripción de los campos (Cuales son obligatorios y que información debe de ir en cada acampo). Nota: PAra pagos recurrentes no hay tabla de descripción variables como en pagos.

Saludos!

[ADMIN]

Buenas tardes Aldo,

De antemano te agradecemos el hacer uso de nuestro foro para publicar tus dudas.

Te informo que en México si es posible utilizar el servicio de pagos recurrentes. Sin embargo, es necesario tener en cuenta que debido a que este servicio necesita de procesamiento sin cvv2 o código de seguridad, en México solo se permitirá el procesamiento de los pagos recurrentes para las franquicias Visa y Mastercard.

De acuerdo al método de integración que tengas en mente puedes implementar API (http://developers.payulatam.com/es/api/recurring_payments.html) o SDK (http://developers.payulatam.com/es/sdk/recurring_payments.html) para pagos recurrentes, y en los enlaces podrás encontrar ejemplos de peticiones.

Con respecto a las variables te puedo proporcionar la siguiente información:

  

Te agradecemos tu recomendación y esperamos que la información haya sido de utilidad.

[Aldo]

Muchas gracias por la información. Sin embargo ya que el ejemplo que tienen es para brasil seria de gran ayuda ver que variables son obligatorias para México. Realizare el ejemplo para Mexico. Cualquier contratiempo que tenga se los haré saber.

De nuevo muchas gracias!

Saludos!

[ADMIN]

Buenos días Aldo,

Te informamos que las imágenes con las variables publicadas están asociadas a cualquier país. De igual forma, puedes hacer uso de los ejemplos que se encuentran en los links previamente enviados pues estos también son genéricos.

No dudes en contactarnos cualquier duda o inquietud.

[Aldo]

Hola nuevamente Admin,

Una duda en los "Pagos recurrentes" / Tarjetas de crédito, al crear una tarjeta de crédito hay un campo llamado "document" ( "document": "1020304050"). ¿Cual seria la descripción para este campo, es decir que dato va ahí?

De antemano muchas gracias.

Saludos!

[ADMIN]

Buenos días Aldo,

Te informamos que el campo "document" hace referencia al documento nacional de identidad asociado al tarjeta habiente. Es decir, el documento del pagador asociado a la tarjeta de crédito.

Esperamos que la información haya sido de utilidad.

[Aldo]

Hola Admin,

Muchas gracias por la información anterior.

Me ha surgido otra duda, dentro de los pagos recurrentes, de que forma puedo saber si se realizo el cobro a la tarjeta de crédito? Esto con el fin de verificar si se realizo el cobro correctamente y no suspender el servicio.

Quedo al pendiente.

Saludos!

[ADMIN]

Buenos días Aldo,

Existen varios métodos para verificar que se realizó el cobro de un pago.

1. En el módulo administrativo https://secure.payulatam.com/, se puede configurar la recepción de un correo electrónico cada vez que una transacción es aprobada o rechazada. A través de la pestaña Configuración -> Configuración Cuentas -> Check email al vendedor.

2. Se puede desarrollar una página de confirmación; nuestro sistema hará el reporte a esta página cada vez que una transacción sea aprobada o rechazada. Se utiliza para la actualización del sistema o bases de datos. Puedes encontrar mayor información en http://developers.payulatam.com/es/web_checkout/integration.html, sección "3. Página de Confirmación".

3. Es posible utilizar el API para obtener información de los cobros realizados. En particular, se deben consultar las facturas asociadas a una suscripción o a un cliente utilizando el método GET:

https://api.payulatam.com/payments-api/rest/v4.3/recurringBill?customerId={customerId}

https://api.payulatam.com/payments-api/rest/v4.3/recurringBill?subscriptionId={subscriptionId}

De igual forma te informamos que es posible configurar la variable maxPendingPayments al crear el plan. Este parámetro hace referencia a la cantidad máxima de pagos pendientes que puede tener una suscripción antes de ser cancelada. En caso de que quieras cancelar la suscripción si el primer pago no fue cobrado, puedes configurar el parámetro con valor 1 o de acuerdo a tu especificación.

[Aldo]

Hola Admin, Buenos días,

Solo para esclarecer mis dudas.

Ejemplo: 

1. Tengo un servicio(plan) que se estará cobrando mensualmente por "x" cantidad.

2. Tengo 2 clientes que se van a suscribir al servicio (cliente A se suscribió el 1° y el cliente B el 22 de "x" mes).

¿Como se realiza el cobro, es decir el cobro se realiza en la fecha que se suscribió cada cliente por (eje. para el cliente A todos los días 1 y cliente B todos los días 22 de cada mes)? ¿Se puede poner fecha fija para todos no importando la fecha de suscripción?

3. Se tiene planeado crear un servicio web que se encargara en revisar todas las suscripciones diariamente para así ver quien si pago y quien no, para posteriormente cancelar el servicio y modificar nuestra BD.

Con lo que se describe en el punto 3:

"Es posible utilizar el API para obtener información de los cobros realizados. En particular, se deben consultar las facturas asociadas a una suscripción o a un cliente utilizando el método GET:

https://api.payulatam.com/payments-api/rest/v4.3/recurringBill?customerId={customerId}

https://api.payulatam.com/payments-api/rest/v4.3/recurringBill?subscriptionId={subscriptionId} "

Ya que se menciona que de esta forma es posible saber el estatus de cada orden, revisando la documentación no pude encontrar algún ejemplo pero son muy parecidos a los cargos adicionales (el que se indica recurringBill vs el que se describe en la documentación recurringBillItems).

Me podría proporcionar algun ejemplo de respuesta (Json) ya que este método "/rest/v4.3/recurringBillItems/{recurringBillItemId}" regresa algo en el cual no es posible saber el pago

{
   "id": "5wm1pxmpiwq",
   "description": "Cargo extra de prueba",
   "additionalValues": [
      {
         "name": "ITEM_TAX_RETURN_BASE",
         "value": 0,
         "currency": "COP"
      },
      {
         "name": "ITEM_TAX",
         "value": 0,
         "currency": "COP"
      },
      {
         "name": "ITEM_VALUE",
         "value": 20000,
         "currency": "COP"
      }
   ],
   "subscriptionId": "5wjxrja8mz9"
}

Quedo al pendiente y de antemano muchas gracias.

Saludos!

[ADMIN]

Buenos días Aldo,

Con respecto a tu primera pregunta, te informamos que si es posible configurar la suscripción para que todos los clientes paguen el mismo día. Para esto, es necesario utilizar la variable "trialDays" cuando se creará la suscripción. Esta variable corresponde a los días de prueba que le proporcionarás al cliente. En el caso de tu ejemplo, para el cliente B (inscripción del 22) puedes especificar 8 días de prueba. De esta manera el primer cobro y los sucesivos se realizarán el día primero de cada mes.

En relación a los pagos de las suscripciones, utilizando el método GET y la URL /rest/v4.3/recurringBill?subscriptionId=id_suscripción, un ejemplo de respuesta es:

{"recurringBillList": [

      {

      "id": "ae5bd79e-3581-42e0-8167-a476e27d1ecd",

      "orderId": 109354462,

      "subscriptionId": "a6ae84u0sbxn",

      "state": "NOT_PAID",

      "amount": 2000,

      "currency": "COP",

      "dateCharge": 1462510800000

   },

      {

      "id": "5153fb3e-bfd0-40b2-99f6-4d2f81fd58e8",

      "subscriptionId": "a6ae84u0sbxn",

      "state": "PENDING",

      "amount": 2000,

      "currency": "COP",

      "dateCharge": 1465189200000

   }

]}

En el ejemplo de respuesta los parámetros corresponden a:

- id: Identificador de la factura recurrente.

- subscriptionId: Identificador de la factura

- state: Estado del pago: "NOT_PAID" es un cobro que se realizó pero no se pagó (pago y reintentos fueron declinados); "PENDING" se refiere al próximo pago que se va a realizar, de acuerdo al intervalo de cobro; "RETRYING_PAYMENT" hace referencia al cobro que se realizó, pero debido a que fue declinado siguen los reintentos según especificados; cuando fue realizado el pago exitosamente el valor será PAID.

- amount: Valor del pago.

- currency: Moneda

- dateCharge: Fecha del cobro. Esta se retorna en formato TimeStamp Unix. Se deben retirar los últimos tres "0" y utilizar posteriormente un convertidor TimeStamp.

[Aldo]

Hola Admin, 

Muchísimas gracias por la información, estamos evaluando si lo hacemos por medio de "Pagos recurrentes" o por "Tokenización" y nosotros implementar la lógica de cobro.

De nuevo le agradezco su apoyo.

Saludos!