Las compras de card-on-file se identifican como aquellas compras donde el cliente ya no requiere la utilización del pin para realizar una transacción. Esto debido a la generación previa de un acuerdo con el comprador donde se aceptan las compras que sean con base a ese acuerdo.
Ese acuerdo deberá de tener un identificador único que permita la identificación del contrato por el comercio y el comprador, el cuál se recibirá como parámetro dentro de los servicios de compra de Pagando Check². Este parámetro substituye el uso del parámetro de pin.
Establecimiento del acuerdo
El acuerdo se construye en dos momentos, y es importante distinguirlos porque las condiciones de cada compra son distintas:
- Primera compra (alta del acuerdo). El titular de la tarjeta debe estar presente y autenticarse ante su banco emisor mediante 3D-Secure, completando el reto (challenge) que éste solicite. Esta autenticación es la que da validez al acuerdo y protege las compras posteriores, por lo que el acuerdo se establece únicamente si la autenticación del titular se completa con éxito y la autorización del cobro es aprobada por el banco. Si cualquiera de las dos condiciones falla, el acuerdo no queda registrado y la primera compra deberá intentarse de nuevo.
- Compras posteriores. Una vez establecido el acuerdo, las compras que se envíen con el mismo identificador ya no requieren el pin ni un nuevo reto del emisor: se procesan con los datos de la tarjeta previamente registrada, amparadas por la autenticación de la primera compra.
Escenarios que requieren reautenticación del cliente
De manera excepcional, el banco emisor puede solicitar que el titular vuelva a autenticarse (por ejemplo, si la tarjeta fue reemplazada o por políticas del propio banco). En esos casos la respuesta indicará que se requiere una nueva autenticación y será necesario repetir el proceso de la primera compra antes de continuar con los cobros del acuerdo.
Tarjetas no soportadas para pagos recurrentes
Algunas tarjetas están inscritas en una versión del protocolo 3D-Secure (2.1) que no admite la autenticación de cobros recurrentes automáticos. En estos casos se devuelve el código 330 y el acuerdo no puede procesarse de forma recurrente con esa tarjeta; se recomienda solicitar al cliente otro medio de pago.
Tipo de petición: POST
Ruta de petición: https://api.pagandocheck.com/v1/pagando/orders/create-order
Headers: Autorization: Bearer <token provisto>
Parámetros
| Campo | Tipo | Descripción. | Requerido |
|---|---|---|---|
userId | String | Identificador del cliente que realizara la transacción | true |
amount | String | Monto expresado en pesos (MXN) por el que se realizara el pago. | true |
cardId | String | Tarjeta tokenizada con la que se ralizara el pago. | true |
aftToken | String | Identificador del cliente provisto por el token de antifraude | true |
agreement | String | Identificador del contrato generado por el comercio y el comprador para aprobar la transacción • Longitud máxima de 20 caracteres • Se pueden usar caracteres alfanuméricos • El único caracter especial permitido es el guión medio: – | true |
paymentFrequency | Number | Periodo de días entre cada cobro, este debe de ser un valor entre 1 y 31, siendo el valor por defecto igual a 30 (mensual) | false |
Las respuestas y códigos de respuesta esperados son iguales a la compra normal.
El identificador del contrato deberá de ser generado por el comercio, así mismo, el comercio deberá de llevar la gestión y control de estos identificadores de acuerdos creados. Pagando Check² no realiza la generación de este identificador.
Posibles códigos de respuesta
| Código | Mensaje | Explicación |
|---|---|---|
66 | The order has been successfully completed. | Procesamiento de transacción correcta |
71 | La orden requiere de revisión adicional. | La transacción necesita realizar una revisión por medio de 3D Secure, con activación previa |
206 | Missing card in request | La transacción no incluye la información de la tarjeta necesaria para procesar el pago. |
207 | Card not have 3D Secure | La tarjeta no cuenta con soporte o no está habilitada para autenticación 3D Secure, requerida para completar la transacción. |
208 | Card not suited for ecommerce payments | La tarjeta no está habilitada por el banco emisor para realizar pagos en comercio electrónico. |
300 | No payment settings found, please check your public key. | El sistema de pagos en producción no ha sido liberado completamente por favor, contacta a soporte |
301 | The payment method associated with the provided user was not found. | No se recibió el identificador de tarjeta en la petición de pago. |
302 | An error occurred and the payment could not be processed. Please try again later. | Puede darse por la falta de configuración de un elemento para el procesamiento de pagos o por una configuración erronea, por favor contacta a soporte |
304 | The amount to pay has not been specified. | No se recibió el parámetro de amount en la petición de pago. |
305 | Payment has been declined, please try again later or with another payment method. | Error devuelto por la entidad bancaria, estos errores tienen que ver directamente con la tarjeta utilizada. |
306 | None anti fraud token was found. | No se envió el token antifraude en la petición de pago. |
307 | None anti fraud token was found. | No se envió el token antifraude en la petición de pago. |
308 | The transaction has been declined due to the possibility of fraud. | Este código de estatus es arrojado por nuestro sistema antifraude, por favor contacta a soporte para mas información. |
320 | The card’s cvv has not been specified. | No se recibió el parámetro de cvv en la petición. |
328 | Recurrent agreement information is incomplete. | Verifique que se envíe paymentFrequency con el formato correcto. |
329 | Recurrent payment requires customer re-authentication. | El cobro recurrente no pudo autenticarse de forma automática y requiere que el cliente vuelva a autorizar el acuerdo mediante un nuevo cobro de alta con autenticación 3D-Secure. Consulte la sección Escenarios que requieren reautenticación del cliente. |
330 | Recurrent payments not supported for this card version. | La tarjeta está inscrita en una versión de 3D-Secure que no admite pagos recurrentes automáticos. Solicite al cliente otro medio de pago. |
