Pagos MoTo
Paylands ofrece una funcionalidad llamada "Pagos Mo/To" para procesar pagos offline. Mo/To es el acrónimo para Mail Order / Telephone Order.
Con esta herramienta web, podrás subir un archivo CSV que contiene órdenes de pago que se enviarán por mail o por SMS a los usuarios.
El usuario recibirá en su mail/teléfono un enlace que le llevará a la página de pago desde la que podrá finalizarlo.
La herramienta soporta plantillas específicas para enviarlas por SMS o e-mail. Para utilizar una plantilla personalizada, deberás enviar un e-mail a soporte@paylands.com.
Estructura del fichero de pagos.
Los pagos MoTo se indican mediante un CSV, que es un documento de texto cuya primera línea contiene la cabecera y el resto de líneas los datos de cada uno de los pagos.
Cabecera | Tipo | Requerido | Descripción |
---|---|---|---|
AMOUNT | Integer | SI | Importe a cobrar, en céntimos. |
OPERATIVE | String | SI | Tipo de operación a realizar. Puede ser AUTHORIZATION o DEFERRED. Para un pago, deberá enviarse el valor AUTHORIZATION. |
DESTINATION | String | SI | Email/teléfono del usuario que recibirá el enlace para realizar el pago. En el caso del teléfono, debe indicarse en formato internacional, indicando el prefijo del país. |
SECURE | String | SI | true/false. Indica si el pago será seguro o no. |
CUSTOMER_EXT_ID | String | NO | Identificador del usuario que hará el pago. |
SOURCE_UUID | String | NO | UUID de la tarjeta asociada al customer_ext_id que realiza el pago. |
ADDITIONAL | String | NO | Campo de texto libre que se enviará al comercio en la notificación. |
URL_POST | String | NO | URL del comercio donde se enviará la notificación con el resultado del pago. |
URL_OK | String | NO | URL del comercio donde se redirigirá al usuario si el pago se ha realizado correctamente. |
URL_KO | String | NO | URL del comercio donde se redirigirá al usuario si el pago ha fallado. |
CARD_TEMPLATE | String | NO | Código que identifica la plantilla que se usará para introducir los datos de tarjeta. |
MOTO_TEMPLATE | String | NO | Código que identifica la plantilla que se usará en el envío del email/SMS. |
DCC_TEMPLATE | String | NO | Código que identifica la plantilla que se usará en el caso de que el pago tenga DCC |
CERTIFIED | String | NO | true/false. Indica si el envío de email o sms será certificado. |
EXTRA_DATA | String | NO | Campos del extra_data separados por punto y coma. Las subclaves serán anidadas usando un punto. Por ejemplo, para indicar el cof RECURRING, habría que indicar el valor cof.reason:RECURRING |
ROUTE | String | NO | Si el método de envío es PHONE, determina el enrutado del SMS. Puede ser DIRECT o INDIRECT. Por defecto será DIRECT. |
Los valores se delimitan con una coma: ",". Las cabeceras opcionales que no contengan ningún valor pueden omitirse. Los valores nulos o vacíos se indican dejando un hueco entre comas. Un ejemplo de CSV es el siguiente:
AMOUNT,OPERATIVE,DESTINATION,SECURE,SOURCE_UUID,CUSTOMER_EXT_ID,ADDITIONAL,URL_POST,URL_OK,URL_KO,CARD_TEMPLATE,MOTO_TEMPLATE,DCC_TEMPLATE,CERTIFIED
12035,AUTHORIZATION,+34666554411,false,,user_1234,additional_info_1234,http://google.es/notification,http://google.es/ok_payment,http://google.es/ko_payment,,90895BE4-F614-447A-AE7F-082B248FE3A3,,false
En el ejemplo, se creará la orden para un pago no seguro de 120.35€, asociado al cliente 'user_1234'. El valor del campo 'SOURCE_UUID' es NULO porque no se ha indicado ningún valor.
Pagos MoTo tokenizados
Si se ha tokenizado la tarjeta con anterioridad se puede indicar el SOURCE_UUID de la tarjeta y el CUSTOMER_EXT_ID al cual se asoció la tarjeta para que el pago se lleve a cabo directamente a través del 3DS, sin que el usuario tenga que indicar los datos de la tarjeta en la carta de pago. Los pagos tokenizados son SEGUROS independientemente de si se indica el campo secure
a TRUE o no.
Campos personalizados en plantillas de email y SMS
Se puede incluir campos personalizados en la plantillas de email y SMS. Para ello, el formato que se debe enviar, ya sea desde formulario del panel o envíandolas mediante API deberá ser:
clave1:valor1;clave2:valor2
Los diferentes campos deben ir separados por punto y coma.
Por ejemplo, enviando en la campaña moto, en el campo additional el siguiente valor:
nombre: Juan García; edad: 28
En la plantilla de email/sms se puede acceder a estos valores de la siguiente forma:
Bienvenido {{customFields.nombre}},
felices {{customFields.edad}} años.