Tipos de Integración
MO/TO: Pago manual
Pago Manual por teléfono o por correo electrónico, ideal para callcenters
Funcionamiento
El pago MO/TO (Mail Order / Telephone Order) es un tipo de pago que está orientado en gran medida a los callcenter. La principal característica de este tipo de pago es que el cliente no se encuentra presente en el momento de la realización del pago. En su lugar, el comercio es quien introduce los datos de tarjeta que el cliente le facilita ya sea por teléfono o por correo electrónico.
Dado que el titular no se encuentra de forma presencial, estas operaciones son tratadas como no seguras y por lo tanto no se solicita autenticación.
Mediante el pago MOTO pueden realizarse dos tipos de operaciones: autorización y preautorización. La realización de pagos MOTO pueden ejecutarse desde el Portal de Administración del TPV Virtual, pero también dispones de métodos para hacerlo vía redirección o vía REST.
Características de la integración
Para realizar una operación manual puedes hacerlo desde el Portal de Administración del TPV Virtual, o mediante Redirección o vía REST, pero para ello debes primero comprobar que tu TPV Virtual está habilitado para realizar esta operativa. Si en el Portal de Administración del TPV Virtual no vieras la opción de «Operación Manual», es muy probable que debas solicitar la activación a BBVA contactando con la Línea Comercios BBVA a través del la dirección de correo electrónico soportevirtual@bbva.com o en el teléfono 912 983 609.
Formas de realizar una operación manual
Tal y como se ha comentado, tienes tres formas de realizar una operación manual.
Usando el Portal de Administración del TPV Virtual
Desde el Portal de Administración del TPV Virtual, podrás realizar una operación manual de manera cómoda y pudiendo usar todas las funcionalidades disponibles. Para realizar esta operativa, inicia sesión en el Portal de Administración del TPV Virutal con tu usuario y contraseña facilitados por BBVA y selecciona en el menú lateral izquierdo la opción de «Operación Manual».
Una vez dentro de este apartado, en la parte superior se verán las tres operativas disponibles: «pago manual», «preautorización» y «devolución». En cualquiera de los tres casos, se presentará una pantalla muy parecida a la que se muestra a continuación de este bloque de texto. Primeramente, deberemos especificar el terminal desde el que queremos operar si el programa no lo autocompleta automáticamente. En el segundo grupo de cuadros de texto, se deberá indicar la tarjeta con la que se desea realizar la operación, que deberá haber sido facilitada por el cliente por teléfono. También puedes, en caso de que dispongas de la funcionalidad de gestión de clientes, de usar un cliente ya registrado en tu plataforma.
Por último, en los detalles de la operación, puedes escribir una descripción para identificarla más adelante, el importe utilizando el punto «.» como notación decimal, la divisa en caso de que tu terminal soporte divisas adicionales al Euro y un ID de operación que, si se deja en blanco, se generará aleatoriamente.
Una vez finalizada la operación, se mostrará un cuadro de confirmación por encima de la pantalla de operación manual tal y como se ve en el costado derecho, en el que se detallarán los detalles de la operación que se ha realizado.
En este caso, se puede visualizar el comercio, el código de comercio y el importe, además del número de pedido que se ha generado, que se recomienda guardar para poder localizar las operaciones más adelante en caso de querer generar devoluciones o revisar información. También se mostrarán los datos de la tarjeta con la que se ha realizado la operación así como el código de autorización y el resultado.
Usando una conexión vía REST
Para realizar un pago manual utilizando una conexión REST, primero debes crear una pequeña integración para poder enviar una petición REST al TPV Virtual con los parámetros correspondientes. Esta petición se enviará, según el entorno en el que queramos operar, a las siguientes URLs.
Autorización
Para que puedas realizar una operación manual mediante metición directa al SIS vía REST, deberás tener el permiso para realizar dicha operación. Puedes consultar la disponibilidad de este permiso con BBVA. Para este tipo de operaciones, se debe indicar en el parámetro Ds_Merchant_TransactionType el valor «0» (cero) y en el parámetro Ds_Merchant_DirectPayment el valor «MOTO».
Petición de PayGold REST - Sólo campo Ds_MerchantParameters sin codificar
{
"DS_MERCHANT_AMOUNT": "1000",
"DS_MERCHANT_CURRENCY": "978",
"DS_MERCHANT_CVV2": "123",
"DS_MERCHANT_DIRECTPAYMENT": "moto",
"DS_MERCHANT_EXPIRYDATE": "XXXX",
"DS_MERCHANT_MERCHANTCODE": "999008881",
"DS_MERCHANT_ORDER": "1524494336",
"DS_MERCHANT_PAN": " XXXXXXXXXXXXXXXXXX ",
"DS_MERCHANT_TERMINAL": "872",
"DS_MERCHANT_TRANSACTIONTYPE": "0"
}
Respuesta recibida del SIS
{
"Ds_Amount": "1000",
"Ds_AuthorisationCode": "088767",
"Ds_CardNumber": "454881********04",
"Ds_Card_Brand": "2",
"Ds_Card_Country": "840",
"Ds_Currency": "978",
"Ds_Language": "1",
"Ds_MerchantCode": "999008881",
"Ds_MerchantData": "",
"Ds_Order": "1524494336",
"Ds_Response": "0000",
"Ds_SecurePayment": "0",
"Ds_Terminal": "872",
"Ds_TransactionType": "0"
}
Preautorización
Si lo que quieres es realizar una preautorización vía REST, es preciso que tengas el permiso para realizar preautorizaciones activado en tu TPV Virtual. Para realizar ese tipo de operación, debes indicar en el parámetro Ds_Merchant_TransactionType el valor «1», y en el parámetro Ds_Merchant_DirectPayment el valor «MOTO».
Petición de PayGold REST - Sólo campo Ds_MerchantParameters sin codificar
{
"DS_MERCHANT_AMOUNT": "1000",
"DS_MERCHANT_CURRENCY": "978",
"DS_MERCHANT_CVV2": "123",
"DS_MERCHANT_DIRECTPAYMENT": "MOTO",
"DS_MERCHANT_EXPIRYDATE": "XXXX",
"DS_MERCHANT_MERCHANTCODE": "999008881",
"DS_MERCHANT_ORDER": "1524494336",
"DS_MERCHANT_PAN": " XXXXXXXXXXXXXXXXXX ",
"DS_MERCHANT_TERMINAL": "872",
"DS_MERCHANT_TRANSACTIONTYPE": "1"
}
Respuesta recibida del SIS
{
"Ds_Amount": "1000",
"Ds_AuthorisationCode": "088767",
"Ds_CardNumber": "454881********04",
"Ds_Card_Brand": "2",
"Ds_Card_Country": "840",
"Ds_Currency": "978",
"Ds_Language": "1",
"Ds_MerchantCode": "999008881",
"Ds_MerchantData": "",
"Ds_Order": "1524494336",
"Ds_Response": "0000",
"Ds_SecurePayment": "0",
"Ds_Terminal": "1",
"Ds_TransactionType": "1"
}
Usando una conexión por redirección
Para realizar un pago manual utilizando una conexión por redirección, primero debes crear una pequeña integración para poder enviar una petición al TPV Virtual con los parámetros correspondientes. Esta petición se enviará, según el entorno en el que queramos operar, a las siguientes URLs.
Autorización
Para que puedas realizar una operación manual mediante metición directa al SIS, deberás tener el permiso para realizar dicha operación. Puedes consultar la disponibilidad de este permiso con BBVA. Para este tipo de operaciones, se debe indicar en el parámetro Ds_Merchant_TransactionType el valor «0» (cero) y en el parámetro Ds_Merchant_DirectPayment el valor «MOTO».
Petición de PayGold por redirección - Sólo campo Ds_MerchantParameters sin codificar
{
"DS_MERCHANT_ORDER":"1552565870",
"DS_MERCHANT_MERCHANTCODE":"999008881",
"DS_MERCHANT_TERMINAL":"999",
"DS_MERCHANT_CURRENCY":"978",
"DS_MERCHANT_DIRECTPAYMENT": "MOTO",
"DS_MERCHANT_TRANSACTIONTYPE":"0",
"DS_MERCHANT_AMOUNT":"1000",
"DS_MERCHANT_MERCHANTURL":"http://www.prueba.com/urlNotificacion.php",
"DS_MERCHANT_URLOK":"http://www.prueba.com/urlOK.php",
"DS_MERCHANT_URLKO":"http://www.prueba.com/urlKO.php"
}
Respuesta recibida del SIS
{
"Ds_Date":"10%2F5%2F2019",
"Ds_Hour":"09%3A41",
"Ds_Amount": "1000",
"Ds_AuthorisationCode": "088767",
"Ds_CardNumber": "454881********04",
"Ds_Card_Brand": "2",
"Ds_Card_Country": "840",
"Ds_Currency": "978",
"Ds_Language": "1",
"Ds_MerchantCode": "999008881",
"Ds_MerchantData": "",
"Ds_Order": "1524494336",
"Ds_Response": "0000",
"Ds_SecurePayment": "0",
"Ds_Terminal": "1",
"Ds_TransactionType": "0"
}
Preautorización
Si lo que quieres es realizar una preautorización por redirección, es preciso que tengas el permiso para realizar preautorizaciones activado en tu TPV Virtual. Para realizar ese tipo de operación, debes indicar en el parámetro Ds_Merchant_TransactionType el valor «1», y en el parámetro Ds_Merchant_DirectPayment el valor «MOTO».
Petición de PayGold por redirección - Sólo campo Ds_MerchantParameters sin codificar
{
"DS_MERCHANT_ORDER":"1552565870",
"DS_MERCHANT_MERCHANTCODE":"999008881",
"DS_MERCHANT_TERMINAL":"999",
"DS_MERCHANT_CURRENCY":"978",
"DS_MERCHANT_DIRECTPAYMENT": "MOTO",
"DS_MERCHANT_TRANSACTIONTYPE":"1",
"DS_MERCHANT_AMOUNT":"1000",
"DS_MERCHANT_MERCHANTURL":"http://www.prueba.com/urlNotificacion.php",
"DS_MERCHANT_URLOK":"http://www.prueba.com/urlOK.php",
"DS_MERCHANT_URLKO":"http://www.prueba.com/urlKO.php"
}
Respuesta recibida del SIS
{
"Ds_Date":"10%2F5%2F2019",
"Ds_Hour":"09%3A41",
"Ds_SecurePayment":"0",
"Ds_Card_Type":"D",
"Ds_Card_Country":"724",
"Ds_Amount":"1000",
"Ds_Currency":"978",
"Ds_Order":"1575967259",
"Ds_MerchantCode":"999008881",
"Ds_Terminal":"1",
"Ds_Response":"0000",
"Ds_MerchantData":"",
"Ds_TransactionType":"0",
"Ds_ConsumerLanguage":"1",
"Ds_AuthorisationCode":"372663",
"Ds_Card_Brand":"2"
}