A lo largo de esta sección definiremos cómo reutilizar una orden de pago de MYMOID. Damos por supuesto que la persona que está leyendo esta documentación ha consultado la documentación de Pago. Los contenidos que vamos a abordar son los siguientes:
- Introducción
- Reutilizar una orden de pago
- Almacenar un medio de pago para reutilizarlo posteriormente
Para poder reutilizar una orden de pago ésta debe encontrarse en estado PAID, en caso contrario no la podremos reutilizar. Al reutilizar una orden de pago, en realidad lo que estamos haciendo es crear una nueva orden de pago y pagarla en ese instante con el medio de pago utilizado con la orden de pago original.
2.- Reutilizar una orden de pago
La ventaja principal de esta funcionalidad consiste en poder reutilizar un medio de pago sin necesidad de volver a introducirlo. De esta forma, el cliente no
tendrá que volver a facilitar los datos de su tarjeta, lo que supone una
ventaja tanto desde el punto de vista de la seguridad como de la
comodidad. Para ello, partiremos de una orden de pago previamente pagada. A continuación generaremos una nueva orden de pago
con los parámetros referencia, concepto e importe y la pagaremos
utilizando el medio de pago utilizado en la orden de pago inicial.
La petición a realizar es la siguiente:
POST {urlServidorMymoid}/pay/order/reissue/{paymentOrderId}
Siendo el parámetro paymentOrderId de la url el identificador de la orden de pago en estado pagado de la que queremos reutilizar el medio de pago. El cuerpo de la petición será el siguiente:
{
"reference":"referencia de la nueva orden de pago",
"concept":"concepto de la nueva orden de pago",
"amount": 1
}
La respuesta de la API tendrá el siguiente formato:
{
"status": true,
"code": 0,
"data": {
"paymentOrderId": "c9b2dd940ed9614d5424e12a59c2d31167975fffc85c3dbca9ccd3386bd29bfd",
"shortCode": "RGLL3P",
"currencyCode": "EUR",
"amount": 100,
"merchantId": "282682dd6b19c81ee7d6b3322505ebe20e03467c0a6dac129c2206e5202ba375",
"reference": "referencia de la nueva orden de pago",
"concept": "concepto de la nueva orden de pago",
"status": "PAID",
"currentStatus": {},
"expirationCard": "01/20",
"pan": "xxxxxxxxxxxx0003",
"creationDate": 1454504239000
}
}
Los datos del medio de pago recibidos en la respuesta (pan y expirationCard) hacen referencia al que se utilizó para pagar la orden de pago original, como hemos mencionado anteriormente.
3.- Almacenar un medio de pago para reutilizarlo posteriormente
Una de las posibilidades más interesantes de esta funcionalidad es poder almacenar un medio de pago sin necesidad de realizar ningún cargo sobre él. Para ello, el procedimiento será el mismo que el descrito en el apartado 5 de la documentación de Pago. Crearemos una orden de pago cuyo importe sea 0 euros, cargaremos su formulario de pago asociado e introduciremos en él el medio de pago como indica el apartado 8 de la documentación mencionada anteriormente. En este caso no se realizará ningún cargo sobre el medio de pago introducido, simplemente se validará que su información es correcta, por tanto el formulario no mostrará el importe de la orden de pago. Otra de las diferencias que encontraremos es que el botón del formulario pondrá Validar tarjeta en lugar de Aceptar como describíamos en el apartado 8 de la documentación de Pago. A continuación podemos ver el aspecto que tendrá el formulario de pago:
Si el medio de pago es válido, la orden de pago aparecerá como pagada y podremos reutilizarla tantas veces como queramos según lo descrito en el apartado anterior.