Datafast Developers | La solución para tus pagos en línea se encuentra aquí

Introducción

Dataweb les permite integrar su negocio al e-commerce mediante la implementación de un botón de pagos en su sitio web. Con este producto, podrá ofrecerles a sus clientes la mejor experiencia al momento de realizar sus pagos en compras en línea con todas las tarjetas bancarias. Todo lo expuesto en el documento es lo que se debe integrar en sus portales web, los campos son mandatorios, el código fuente adjunto es referencial y sirve como guía para su comercio. Recuerde que antes de pasar a producción, Datafast S.A. deberá certificar el desarrollo aplicado por el comercio.

Dataweb

Es una solución de forma de pago compuesta por una API y un widget (Con certificación PCI DSS). Permite la integración en los diferentes portales e-commerce ya sean de desarrollo propio o por medio de CMS, de aquí en adelante se lo describirá como botón de pagos.

Front-end

Al ser una solución web, su estructura está definida por las tecnologías:

HTML
CSS
JavaScript

Para la recepción de datos se utiliza el formato JSON

Back-end (Tecnologías)

El botón de pagos se adapta a las nuevas tecnológica y los lenguajes de programación soportados son:

Python
Java
Php
Groovy
VB.Net
Ruby
NodeJs
C#
Scala

Certificados

El botón de pagos utiliza certificado TLS 1.2 con encriptación SHA-2 (256 bits) por lo que su sitio web debe poseer el mismo tanto en ambientes de pruebas y producción. Cualquier otro certificado inferior al mencionado en el párrafo anterior debe ser deshabilitado (TLS 1.1 / 1.0, SSL2, SSL3, etc.), caso contrario debe comunicarlo de inmediato. Para conocer todos los requerimientos técnicos revisar Requerimientos Tecnicos.

Ejemplos

En este documento encontrarán ejemplos de código basado en el lenguaje PHP pero esto no indica que es la manera de hacerlo ya que cada desarrollador debe aplicar los estándares y tecnología de plataforma a implementar el botón de pagos.

Plugins

No son aplicables, es decir Datafast no desarrolla plugins para plataformas, lo que hace es ofrecerles el “engine” del botón de pagos para que pueda ser adaptado a su portal.

Transacciones y Monto

Cuando se está en la fase dos (Fase final) el monto de las transacciones no debe superar los $50 caso contrario se consumirá el cupo rápidamente de las tarjetas de prueba. Cuando se realice el paso a producción, el comercio deberá tener a la mano una tarjeta de crédito real y un set de datos ficticios de ser necesario, esto ya queda a criterio del comercio.

Esquema de Seguridad

Esquema de Seguridad

Validación de Conexión al Gateway

Antes de empezar el desarrollo se debe comprobar que el servidor/terminal en donde se implementará el botón de pagos tenga conectividad a nuestro gateway de pagos.

Para realizar la comprobación debe ejecutarse en una terminal dentro del servidor en este fragmento de código. Comprobación de Conectividad con el gateway de pagos.

                            
                            curl https://eu-test.oppwa.com/v1/checkouts -d 
                            "entityId=8a829418533cf31d01533d06f2ee06fa" -d "amount=92.00" -d 
                            "currency=USD" -d "paymentType=DB" -H "Authorization: Bearer 
                            OGE4Mjk0MTg1MzNjZjMxZDAxNTMzZDA2ZmQwNDA3NDh8WHQ3RjIyUUVOWA=="

Deberá obtener un resultado como se muestra a continuación

                            
                            {
                                "result": {
                                    "code": "000.200.100",
                                    "description": "successfully created checkout"
                                },
                                "buildNumber": "7e7236ae4cbc6acd0859cfe9babdab46c815ce7b@2022-07-14 09:55:07 +0000",
                                "timestamp": "2022-07-15 19:16:51+0000",
                                "ndc": "0FCB9B41626193BC6B0FD2E6F0DBDDB8.uat01-vm-tx03",
                                "id": "0FCB9B41626193BC6B0FD2E6F0DBDDB8.uat01-vm-tx03"
                            }

Puede que se tenga que activar el módulo CURL para esta prueba.

Fases de Integración

Para la integración de la solución se ha dividido en dos etapas de pruebas antes del paso al ambiente de producción.

En ambos casos se debe incluir la siguiente línea de Javascript después del tag de cierre </body>

                            
                            <script type="text/javascript" src="https://www.datafast.com.ec/js/dfAdditionalValidations1.js">

Fase uno

En esta fase el comercio o establecimiento a implementar el botón podrá tener una primera experiencia al interactuar con el Gateway de pagos.

Se debe tener parametrizado los campos que varían cuando se cambien de ambientes, es decir entre prueba y producción.

Parámetro	Descripción
url	Indica el ambiente en el cual se está trabajando (Prueba / Producción)
mid	Indica el identificador del comercio
tid	Indica el identificador del terminal
textMode	Este parámetro en ambiente de producción no se incluye en el método, pero en pruebas si es necesaria (Fase 2) tal como se verá en los ejemplos.
entityId	Identificador de entidad
Authorization	Parámetro de cabecera para autenticación de tipo Bearer

Parametros Generales

En la versión anterior eran mandatorios los parámetros userId y password, estos fueron reemplazados por el autorizador (Authorization).

Identificador de Pago (CheckoutId)

En esta primera instancia se envían los parámetros básicos hacia la plataforma de pago, para esta guía se utilizará el lenguaje PHP (PHP CheckoutId). La respuesta a una solicitud exitosa es una cadena JSON con un id que se requiere en el segundo paso para crear el formulario de pago. Si usted utiliza otro lenguaje de por ejemplo Java puede obtener el código en el Java CheckoutId, para C# el C# CheckoutId, para los otros lenguajes que soporta nuestro API ( Back-end Tecnologias) revisar los Ejemplos.

Los parámetros en esta sección son los que se describen en la siguiente tabla:

Parámetro	Descripción
url	https://test.oppwa.com
entityId	8a829418533cf31d01533d06f2ee06fa
amount	Monto de la transacción, ejemplo: 5.00
currency	El valor es USD
paymentType	Para compras el valor es DB
Authorization	Bearer OGE4Mjk0MTg1MzNjZjMxZDAxNTMzZDA2ZmQwNDA3NDh8 WHQ3RjIyUUVOWA==

Parametros de la fase 1

                            
                            function request(){
                                $url = "https://test.oppwa.com/v1/checkouts";
                                $data = "entityId=8a829418533cf31d01533d06f2ee06fa" .
                                        "&amount=92.00" .
                                        "&paymentType=DB";
                                $ch = curl_init();
                                curl_setopt($ch, CURLOPT_URL, $url);
                                curl_setopt($ch, CURLOPT_HTTPHEADER, array(
                                    'Authorization:Bearer OGE4Mjk0MTg1MzNjZjMxZDAxNTMzZDA2ZmQwNDA3NDh8WHQ3RjIyUUVOWA=='));
                                curl_setopt($ch, CURLOPT_POST, 1);
                                curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
                                curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false); //this should be set to true in production
                                curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
                                $responseData = curl_exec($ch);
                                if(curl_errno($ch)){
                                    return curl_error($ch);
                                }
                                curl_close($ch);
                                return $responseData;
                            }

Ejemplo en PHP del primer método (Para obtener el id)

Se ejecuta el método y se obtiene la respuesta en formato JSON

                            
                            {
                                "result":{
                                    "code":"000.200.100",
                                    "description":"successfully created checkout"
                                },
                                "buildNumber":"7867e483baee31e6351c5a53a4236b2f54606e87@2020-04-24 08:07:01 +0000",
                                "timestamp":"2020-04-26 04:46:44+0000",
                                "ndc":"79E1E1EBB41134A257CB8D22280D6BBC.uat01-vm-tx01",
                                "id":"79E1E1EBB41134A257CB8D22280D6BBC.uat01-vm-tx01"
                            }

Formulario de Pago

Para la generación del formulario de pago se debe utilizar el id (checkoutId) obtenido en el paso anterior. En la página donde ubicarán el formulario de pago deben agregar el código Javascript que se muestra a continuación junto al checkoutId. Cabe mencionar que este checkoutId se obtiene cada vez que se ejecute el método y tiene una caducidad de 30 minutos.

Script de Formulario de Pago

Una vez agregado el script se procede a invocar el formulario de pago insertando el código que muestra la figura 5, donde shopperResultURL es la dirección a donde se redirigirá la página una vez que haya presionado el botón “Pagar” ya que el Gateway le enviará un parámetro necesario para el siguiente paso, por otro lado, en la propiedad data-brands se puede configurar las marcas de las tarjetas que se utilizaran, siendo estas VISA MASTER AMEX DINERS DISCOVER, esto también puede ser parametrizado si así lo creen conveniente. Para tarjetas ALIA primero deberá solicitarlo al departamento comercial del banco emisor y luego Datafast le dará las instrucciones técnicas.

                            
                            <form action="{shopperResultUrl}" class="paymentWidgets" data-brands="VISA MASTER AMEX"> </form>

Código HTML de invocación del Formulario de Pago

A continuación, un ejemplo utilizando el lenguaje Php.

                            
                            <script src="https://test.oppwa.com/v1/paymentWidgets.js?checkoutId=<?php echo $json['id'] ?> "></script>
                            <form action ="<?php echo $baseUrl ?>" class="paymentWidgets" data-brands="VISA MASTER DINERS DISCOVER AMEX">
                            </form>

Código ejemplo del Formulario de Pago

Una vez configurado, el formulario se construye y se comporta de la siguiente manera.

Formulario de Pago con datos de pruebas para su uso

Para esta fase puede utilizar los datos de tarjeta de crédito que se muestran en la figura 7. Por asuntos de revisión, en el campo cardholder se debe poner el nombre del comercio.

Una vez presionado el botón pagar, los datos vuelven a viajar al gateway y nos devuelve un parámetro a la página seleccionada en el parámetro shopperResultURL.

En esta página usted podrá obtener el parámetro resourcePath cuyo contenido es: /v1/checkouts/{id}/payment tal como lo muestra la siguiente imagen

                            
                            resourcePath=/v1/checkouts/79E1E1EBB41134A257CB8D22280D6BBC.uat01-vm-tx01/payment

Con esto puede continuar con el paso 3 (Procesamiento de la compra y obtención de los datos de la transacción)

Estado de Transacción

Cuando reciben el parámetro resourcePath se procede a crear el método que se muestra en la siguiente figura para obtener los datos de respuesta de la transacción (PHP Estado de la Transacción /Java Estado de la Transacción /C# Estado de la Transacción). Cabe recalcar que el valor del parámetro obtenido se concatena a la Url de prueba/producción.

                            
                            function request(){
                                $url = "https://teAst.oppwa.com/v1/checkout/{id}/payment";
                                $url .="?entityId=8a829418533cf31d01533d06f2ee06fa";
                                $ch= curl_init();
                                curl_setopt($ch, CURLOPT_URL, $url);
                                curl_setopt($ch, CURLOPT_HTTPHEADER, array(
                                    'Authorization:Bearer OGE4Mjk0MTg1MzNjZjMxZDAxNTMzZDA2ZmQwNDA3NDh8WHQ3RjIyUUVOWA=='));
                                curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'GET');
                                curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false); //this should be set to true in production
                                curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
                                $responseData = curl_exec($ch);
                                if(curl_errno($ch)){
                                    return curl_error($ch);
                                }                                
                                curl_close($ch);
                                return $responseData;
                            }

Segundo método utilizando el parámetro resourcePath

Una vez ejecutado este método la plataforma envía la respuesta en formato de texto JSON hacia el cliente.

                            
                            {
                                "id":"8a82944a5ec84a95015ee46612620fbd",
                                "paymentType":"DB",
                                "paymentBrand":"VISA",
                                "amount":"92.00",
                                "currency":"USD",
                                "descriptor":"7985.7566.9922 OPP_Chanel",
                                "result":{
                                    "code":"000.100.110",
                                    "description":"Request successfully processed in 'Merchant in Integrator Test Mode'"
                                },
                                "resultDetails":{
                                    "clearingInstituteName":"Acceptance Test"
                                },
                                "card":{
                                    "bin":"420000",
                                    "last4Digits":"0000",
                                    "holder":"Juan Ruiz",
                                    "expiryMonth":"01",
                                    "expiryYear":"2020"
                                },
                                "threeDSecure":{
                                    "eci":"07"
                                },
                                "customParameters":{
                                    "CTPE_DESCRIPTOR_TEMPLATE":""
                                },
                                "risk":{
                                    "score":"100"
                                },
                                "buildNumber:"0602a109f824c84b382349a08fb4a8cbaf1ba67b@2017-10-02 14:26:32 +0000",
                                "timestamp":"2017-10-03 22:40:48+0000",
                                "ndc":"86D77C1022E0F529518A9DB2B16C6121.sbg-vm-txt02"
                            }

Si por algún motivo no se pueda obtener el estado de la transacción de manera sincrónica entonces puede usar el Verificador de Transacciones.

Fase dos

Una vez integrado el botón en su fase inicial de pruebas procederemos a realizar algunos cambios en el método inicial para poder así realizar transacciones de pruebas hacia el switch transaccional de Datafast en ambiente de desarrollo. En la fase uno las transacciones no llegan a Datafast.

Los parámetros de autenticación en esta fase son proporcionados por Datafast previa solicitud vía correo electrónico, adicional se otorga una tarjeta de crédito de prueba.

entityId
Authorization (Bearer)

Nuevos Campos

Se procederá describir campo por campo lo que se necesita agregar como parámetros en el primer método del API. Estos campos son obligatorios y no se puede poner valores por defecto como “SN”, “NA”, “0999999999”, etc. Si tiene problemas para obtener desde su sistema algún campo por favor indicarlo mediante correo electrónico al departamento de riesgos mediante servddpago@datafast.com.ec.

Nombre

Este campo se refiere al nombre del usuario que está realizando la transacción, el mismo será asignado a un campo disponible de la plataforma.

customer.givenName | AlfNum {3,48}

Segundo Nombre

Este campo se refiere al segundo nombre del usuario que está realizando la transacción, el mismo será asignado a un campo disponible de la plataforma.

customer.middleName | AlfNum {2,50}

Apellido

Este campo se refiere al apellido del usuario que está realizando la transacción, el mismo será asignado a un campo disponible de la plataforma.

customer.surname | AlfNum {3,48}

Dirección IP

Este campo se refiere a la dirección ip del equipo desde donde el usuario está realizando la transacción, el mismo será asignado a un campo disponible de la plataforma, no debe enviar la IP de su servidor.

customer.ip | AlfNum 255{1,255}

Identificador del Cliente en el Comercio

Este campo se refiere a la identificación (id único) del usuario registrado en el sistema, el mismo será asignado a un campo disponible de la plataforma.

customer.merchantCustomerId | AlfNum 16{1,16}

Número de Transacción

Este campo se refiere a la identificación (id único) de la transacción (trx) registrada en el sistema, el mismo será asignado a un campo disponible de la plataforma, cabe mencionar que este identificador debe ser único por transacción así sea rechazada en su primer intento.

merchantTransactionId | AlfNum 255{8,255}

Dirección de Correo Electrónico

Este campo se refiere a la dirección de correo electrónico asociada a un usuario del sistema, el mismo será asignado a un campo disponible de la plataforma.

customer.email | AlfNum 128{6,128}

Documento de Identificación del Usuario

Este campo se refiere al documento de identidad del usuario en sistema (DNI, Cédula, pasaporte, etc.), el mismo será asignado a un campo disponible de la plataforma. La longitud del campo es siempre de 10 caracteres y debe coexistir con el anterior campo caso contrario le emitirá error. En el caso de usar RUC se debe cortar y solo enviar la longitud indicada, internamente en su sistema puede guardar el dato completo, si el dato es menor a la longitud requerida entonces se debe completar con ceros a la izquierda.

customer.identificationDocId | AlfNum 10{1,10}

Datos del producto

En esta sección se describirá los campos necesarios para almacenar la información de los ítems(productos o servicios) involucrados en la compra, cabe aclarar que los parámetros a utilizar estarán agrupados en arreglos de datos simples.

Nombre

Nombre del producto, no se acepta el &

cart.items[0].name | AlfNum 255{1,255}

Descripción

Descripción del producto.

cart.items[0].description | AlfNum 255{1,255}

Precio

Precio del producto.

cart.items[0].price | Num 13 {1,10}.{2}

Cantidad

Cantidad del producto.

cart.items[0].quantity | Num 5 {1,12}.{0,3}

Teléfono del Cliente

Número de teléfono, de formato alfanumérico y longitud máxima de 25 caracteres.

customer.phone | AlfNum 25 {7,25}

Dirección de entrega

Dirección de entrega de la compra del cliente, de formato alfanumérico y longitud máxima de 100 caracteres.

shipping.street1 | AlfNum 100 {1,100}

Dirección del Cliente

Dirección del cliente que realice la compra (generalmente el de la factura), de formato alfanumérico y longitud máxima de 100 caracteres.

billing.street1 | AlfNum 100{1,100}

País de entrega

País de entrega de compra que realiza el cliente, de formato alfabético y longitud de 2 caracteres en mayúscula. Ejm (EC, CL, US, etc. Formato ISO 3166-1)

shipping.country | Alf 2{2}

País del Cliente

País de compra que realiza el cliente (generalmente de la factura), de formato alfabético y longitud de 2 caracteres en mayúscula. Ejm (EC, CL,US, etc. Formato ISO 3166-1)

billing.country | Alf 2{2}

Modo de Prueba

Le indica a la plataforma en qué modo se están haciendo las transacciones.

testMode

Toma el valor de EXTERNAL. En producción este parámetro tiene que ser eliminado completamente.

Parámetros Personalizados

Le indica a la plataforma en qué modo se están haciendo las transacciones.

Datos de Impuestos

Toda transacción debe tener obligatoriamente información relacionada con los impuestos, si acaso no utiliza alguno de ellos igual deben enviarlo pero con valores en cero. El formato para estos campos es #######.## (2 decimales, sin separador de miles)

cart.items[0].quantity | Num 5 {1,12}.{0,3}

% Base 0 (variable)

Este campo es asignado para aquellos valores que no gravan impuestos.

customParameters[SHOPPER_VAL_BASE0]

% Base imponible (variable)

Este campo es asignado para aquellos valores que si gravan impuestos, en este caso el % del IVA.

customParameters[SHOPPER_VAL_BASEIMP]

Valor de impuesto (variable)

Este campo es el valor calculado a la base imponible, en este caso el valor del IVA.

customParameters[SHOPPER_VAL_IVA]

Ejemplo de compra

Para una mejor explicación se detalla el siguiente ejemplo.

Una compra por un total de $3.12 que se desglosa de la siguiente manera:

a.	% Base imponible	$1
b.	Valor de impuesto	$0.12
c.	Total (a+b)	$1.12
d.	% Base 0	$2
	Total (c+d)	$3.12 (Monto)

Ejemplo de una compra con impuestos

Los campos quedarían así:

customParameters[SHOPPER_VAL_BASE0]=2.00

customParameters[SHOPPER_VAL_BASEIMP]=1.00

customParameters[SHOPPER_VAL_IVA]=0.12

Datos del comercio (MID Y TID)

En esta sección se describen el identificador del comercio (MID) y el identificador del terminal (TID. Para pruebas (fase 2) se tendrán los siguientes valores 1000000406 y PD100406 respectivamente. En producción, Datafast debe proporcionarles otros.

customParameters[SHOPPER_MID]= 1000000406

customParameters[SHOPPER_TID]= PD100406

Datos de identificación

En esta sección se describen datos necesarios para validación de identificación, estos valores son fijos.

Identificador de Seguridad

customParameters[SHOPPER_ECI]= 0103910

Identificador del proveedor

customParameters[SHOPPER_PSERV]= 17913101

Risk Parameters

Este campo sirve para identificar al comercio en la transacción, solo se debe poner el nombre de este, también es obligatorio para procesos internos de prevención de fraude.

risk.parameters[USER_DATA2] | AlfNum (30)

risk.parameters[USER_DATA2]=SuComercio

A continuación, un ejemplo de implementación en el lenguaje PHP.

                                    
                                    function request ($entityId, $items , $total, $valoriva, $base12, $base0, $email, $primer_nombre, $segundo_nombre, $apellido,
                                    $cedula, $trx, $ip_address, $telefono, $direccion_cliente, $pais_cliente, $direccion_entrega, $pais_entrega,
                                    $postcode){
                                        $url = "https://test.oppwa.com/v1/checkouts";
                                        $data = "entityId=" .$entityId.
                                        "&amount=".$total.
                                        "&currency=USD".
                                        "&paymentType=DB". 
                                        "&customer.givenName=".$primer_nombre 
                                        "&customer.middleName=".$segundo_nombre. 
                                        "&customer.surname=".$apellido. 
                                        "&customer.ip=".$ip_address. //IP del cliente, no del servidor
                                        "&customer.merchantCustomerId=000000000001" //id de cada usuario en la plataforma
                                        "&merchantTransactionId=transaction_" .$trx. //ejemplo de identificador
                                        "&customer.email=" .$email. 
                                        "&customer.identificationDocType=IDCARD". 
                                        "&customer.identificationDocId=".$cedula. //10 caracteres máximo
                                        "&customer.phone=".$telefono. 
                                        "&billing.street1=".$direccion_cliente. 
                                        "&billing.country=".$pais_cliente. 
                                        "&billing.postcode".$postcode. 
                                        "&shipping.street1=".$direccion_entrega. 
                                        "&shipping.country=".$pais_entrega. 
                                        "&risk.parameters[SHOPPER_MID]=1000000505". 
                                        "&customParameters[SHOPPER_TID]=PD100406". 
                                        "&customParameters[SHOPPER_ECI]=0103910". 
                                        "&customParameters[SHOPPER_PSERV]=17913101". 
                                        "&customParameters[SHOPPER_VAL_BASE0]=.$base0". 
                                        "&customParameters[SHOPPER_VAL_BASEIMP]=.$base12". 
                                        "&customParameters[SHOPPER_VAL_IVA]=.$valoriva";
                                    $i = 0;
                                    foreach($items["cart"] as $c){
                                        $data.= "&cart.items[".$i."].name=".$c["product_name"];
                                        $data.= "&cart.items[".$i."].description="."Descripcion: ".$c["product_name"];
                                        $data.= "&cart.items[".$i."].price=".$c["product_price"];
                                        $data.= "&cart.items[".$i."].quantity=".$c["q"];
                                        $i++:
                                    }
                                    $data .="&customParameters[SHOPPER_VERSIONDF]=2";
                                    $data .="&testMode=EXTERNAL";
                                    $ch = curl_init();
                                    curl_setopt($ch, CURLOPT_POST, 1);
                                    curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
                                    curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false); //this should be set to true in production
                                    curl_setopt($ch, CURLOPT_RETURNTRANSFER, false);
                                    $responseData = curl_exec($ch);
                                    if(curl_errno($ch)){
                                        return curl_error($ch);
                                    }
                                    curl_close($ch);
                                    return $responseData;
                                    }

Código ejemplo del primer método que hace la petición del id (CheckoutId) fase 2.

Una vez ejecutado el método se obtendrá la respuesta en formato JSON, la cual se muestra en la siguiente imagen. Como podrá observar en esta respuesta se incluye información de la transacción que puede ser almacenadas en su base de datos para un mejor control, se recomienda que se guarde esta información ya sea en una transacción exitosa como en una fallida, adicional se recomienda que cada transacción cuando se genere sea guardad con un estado (procesada/no procesada) para que esta información pueda usarse en el método de verificador de transacciones que se verá más adelante.

Campo	Descripción
Id	Identificador de la transacción ya sea aprobada o rechazada
resultDetails.Authcode	Campo código de autorización de la transacción aprobada. Ej. 058142.
resultDetails.BatchNo	Número de lote
resultDetails.TotalAmount	Si es una transacción diferida con intereses entonces el valor será el totalizado del monto más el valor de los intereses generados por el banco en la transacción, sino el valor será igual al monto normal.
resultDetails.Interest	El valor individual del interés generado por el banco en la transacción
resultDetails.Response	Campo que indica si la transacción fue aprobada o rechazada, esto se detalla en la sección de mensajes.
resultDetails.AcquirerCode	Código asociado a la entidad financiera que aprobó/rechazó la transacción.
resultDetails.ReferenceNo	Número de referencia
resultDetails.CardType	Nomenclatura del Banco dueño de la tarjeta utilizada en la transacción

Descripción de datos importantes

Código de Mensajes

El listado a continuación muestra los códigos de respuestas emitidos por el switch transaccional. La descripción de los códigos debe ser personalizados para una mejor comprensión por parte del cliente y evitar bloqueos, es decir usted puede cambiar la descripción que le llega como respuesta en el JSON para mostrarlo de mejor manera al usuario. De manera general los códigos que empiezan por 800 son debido a un rechazo por la entidad bancaria.

Códigos Generales

El botón de pagos maneja dos categorías en su mensajería, una general y otra detallada para de esta manera tener claro el motivo de algún rechaza de la transacción. En la siguiente tabla podrá observar los diferentes tipos de mensajes recibidos en el campo result { code:_código_,descripción: _abc_} del JSON de respuesta, estos les permite tener una idea general del rechazo sin embargo para una mayor certeza revisen el apartado de Rechazo de Transacción

Código	Descripción Web	Detalle
000.000.000	Transaction succeeded	Approved (Producción). Mensaje para todo proceso exitoso.
000.200.100	successfully created checkout	Creación del id (checkoutId) de manera exitosa.
800.110.100	Duplicate transaction	Mensaje cuando existe una mala interacción de la interfaz provocando el envío del identificador de la transacción más de una vez. El técnico del comercio debe solucionarlo.
200.100.101	invalid Request Message. No valid XML. XML must be url-encoded! maybe it contains a not encoded ampersand or something similar.	Mensaje generalmente emitido cuando se pone mal el dato de la cédula de identidad, teléfono entre otro. Si todo está bien, entonces se debe revisar el campo Response, si tiene el valor de 05 quiere decir que la respuesta del banco presentó una demora, esto puede causar confusión al cliente debido a que puede haberle llegado un mensaje de consumo sin embargo la respuesta no llegó a Datafast y por ende no le llega al portal web del comercio.
200.100.103	Invalid Request Message. The request contains structural errors	Mensaje invalido. Cuando hay algún dato errado enviado por ejemplo una cédula así 1234567890
800.100.171	Transaction declined (pick up card)	Pick up: Retenga y llame
700.300.700	referenced tx can not be reversed (reversal not possible anymore)	Reverso declinado
800.100.174	transaction declined (invalid amount)	Monto inválido
800.100.151	transaction declined (invalid card)	Tarjeta de crédito inválida
800.100.402	cc/bank account holder not valid	No such issuer. Omisión de nombre de tarjetahabiente.
800.100.190	transaction declined (invalid configuration data)	Transacción declinada por el banco, puede ser por estos motivos dependiendo del campo Response: Enviaron un tipo de crédito que no está autorizado por el banco al comercio. No está autorizado a transaccionar con dicha tarjeta. Transacción rechazada por el banco que no pertenece a nuestra red.
800.100.152	Authorization Error (95) transaction declined by authorization system	La transacción fue rechazada por el banco, se desconoce el motivo. En el caso de tarjetas Diners/Discover/Visa MC del Banco Pichincha se debe revisar el campo ExtendedDescription debido a que puede ser una transacción cancelada por el usuario.
800.100.197	transaction declined (registration cancelled externally)	Customer cancellation
800.100.176	transaction declined (account temporarily not available. Please try again later)	Transacción rechazada por el banco, intentar de nuevo. Esto ocurre generalmente con las tarjetas de débito.
100.400.311	transaction declined (format error)	Format Error
100.100.100	request contains no creditcard, bank account number or bank name	No se envió datos de la tarjeta, generalmente este un problema técnico de la página web del comercio, no del botón.
800.100.165	transaction declined (card lost)	Tarjeta reportada como pérdida
800.100.159	transaction declined (stolen card)	Tarjeta reportada como sustraída
800.100.155	transaction declined (amount exceeds credit)	Fondos insuficientes
100.100.400	request contains no cc/bank account holder	Se envía vacío el cardholder, esto lo controla la página web del comercio.
100.100.303	Card Expired	Tarjeta expirada
800.100.170	transaction declined (transaction not permitted)	Puede darse por el uso de una tarjeta de débito que no puede realizar compras por internet.
100.550.310	amount exceeds limit for the registered account	Monto excede el cupo
800.100.168	transaction declined (restricted card)	Tarjeta restringida, cliente debe llamar al banco.
800.100.179	transaction declined (exceeds withdrawal count limit)	Hay tarjetas que tiene un máximo de transacciones permitidas.
100.100.402	cc/bank account holder not valid	Cardholder inválido, puede ser que tenga caracteres especiales, la validación es del gateway, no del banco.
600.200.100	Invalid Payment Method	Modalidad invalida
700.100.200	non matching reference amount	Verifique interés
700.400.200	cannot refund (refund volume exceeded or tx reversed or invalid workflow?	Se intentó anular una transacción que ya había sido anulada previamente.
800.100.157	transaction declined (wrong expiry date)	Vigencia de la tarjeta errada
800.100.501	Card holder has advised his bank to stop all recurring payments for this merchant	Establecimiento cancelado
800.100.100	transaction declined for unknown reason	Puede ser por dos motivos: La tarjeta tiene problemas por lo que el cliente debe llamar al Banco. Transacción con una tarjeta de débito que no tiene autorizado compras por internet.
800.100.171	transaction declined for unknown reason	Llame al centro de Autorización
800.300.500	transaction temporary blacklisted (too many tries invalid CVV)	La tarjeta se encuentra en lista negra debido a múltiples intentos de transacciones con CVV errado, se libera después de 48 horas
800.300.501	transaction temporary blacklisted (too many tries invalid expire date)	La tarjeta se encuentra en lista negra debido a múltiples intentos de transacciones con fecha de caducidad errada, se libera después de 48 horas.
900.100.201	error on the external gateway (bank)	Se ha perdido la conexión con el Gateway de Pagos, inténtelo después de unos minutos, si el problema persiste por un lapso estimado entonces debe contactarse con servbdpago@datafast.com.ec
900.100.100	unexpected communication error with connector/acquirer	Se ha perdido la conexión con el banco, intentar luego de unos minutos.
900.100.300	no response from connector/acquirer [uncertain result]	Existió una desconexión en el instante de la transacción, si el problema persiste entonces comunicarse rápidamente con Datafast.
800.100.176	transaction declined (account temporarily not available. Please try again later)	Try Request Again. Transacción rechazada por el banco, intente luego o llame al banco
800.100.199	transaction declined (invalid tax number)	Mensaje emitido cuando se ha calculado mal los impuestos, la base 0% + la base 12% + valor del IVA debe ser igual al monto que se envía.
600.200.201	Channel/Merchant not configured for this payment method	Terminal inválido o diferido no permitido.
600.200.500	Invalid payment data. You are not configured for this currency or sub type (country or brand)	Mensaje emitido cuando no se ha asignado una marca de tarjeta para transaccionar.
800.100.151	transaction declined (invalid card)	Tarjeta inválida
800.100.156	transaction declined (format error)	Depende del valor del código en el campo Response, revisar el apartado de Rechazo de Transacción
800.100.162	Transaction declined (limit exceeded)	La tarjeta tiene un límite en el monto en compras, aún teniendo cupo.
100.100.101	invalid creditcard, bank account number or bank name /	Tarjeta de crédito inválida
100.700.801	identity contains no or invalid identification value	Se está enviando un campo mal, ya sea en el nombre o en su valor, el técnico debe revisar internamente.
100.400.147	Payment void and transaction denied by ReD Shield	La transacción infringió una regla antifraude. Estas reglas fueron definidas por el comercio al momento de firmar. Para detalles de que regla se activó deben enviar un email servicio al cliente servbdpago@datafast.com.ec
100.400.149	Payment void and data error by ReD Shield	La transacción tiene datos que infringe una regla antifraude. Para detalles de que regla se activó deben enviar un email servicio al cliente servbdpago@datafast.com.ec
100.400.325	External risk system not available	Si este mensaje se presenta en muchas transacciones entonces el comercio debe comunicarse con Datafast de manera inmediata.
SEGUNDO FACTOR DE AUTENTICACIÓN (3DS – OTP)
100.380.401	User Authentication Failed. (3DSecure Error)	User Authentication Failed. (3DSecure Error)
100.380.501	User Authentication Error (risk management transaction timeout)	El tarjetahabiente no digitó el código enviado por el banco dentro del tiempo establecido.
100.396.103	Previously pending transaction timed out (Error in asynchronous workflow)	El tarjetahabiente no digitó el código enviado por el banco dentro del tiempo establecido para tarjetas DINERS/DISCOVER/VISA-MC Banco Pichincha)
100.390.108	Transaction rejected because merchant not participating in 3DSecure program (3DSecure Error)	Error de configuración en el canal. Contactarse inmediatamente con servbdpago@datafast.com.ec
100.390.112	Technical Error in 3D system (3DSecure Error)	Error de configuración en el canal. Contactarse inmediatamente con servbdpago@datafast.com.ec

Códigos Generales de Mensajes transaccionales en Producción

Código	Descripción Web	Detalle
000.100.112	Request successfully processed in 'Merchant in Connector Test Mode'	Approved (Pruebas), este mensaje se recibe en la fase 2 cuando se agrega el campo testMode=External
000.100.110	Request successfully processed in 'Merchant in Integrator Test Mode'	Approved (Pruebas), este mensaje se recibe en la fase 1

Código de Mensajes Generales en Pruebas

Código	Descripción Web	Detalle
000.200.100	successfully created checkout	Petición correcta, el checkoutId puede extraerse del JSON de respuesta
200.300.404	invalid or missing parameter	Campo inválido: puede ser por nombre, longitud o formato.

Códigos de respuestas en la creación del formulario (1ra. Función)

Códigos de Mensajes Detallados

En cada transacción ya sea aprobada o rechazada se debe tener en cuenta estos dos campos para obtener información más detallada:

Response
AcquirerCode

Aprobación de la transacción (Banco adquirente)

En cada transacción ya sea aprobada o rechazada se debe tener en cuenta estos dos campos para obtener información más detallada:

##	Descripción
01	Pacificard
02	Diners
03	Pichincha
04	Banco Guayaquil
05	Solidario
06	Medianet
07	Bando del Austro
08	Coop. 9 de Octubre

Banco Adquirente

Así mismo en este escenario se puede conocer con que tarjeta se realizó la transacción, el valor del campo CardType tiene los siguientes valores:

AZ	Descripción
DC	Diners
PM	Mastercard Pacifico
PV	Visa Pacifico
VI	Visa Internacional
VP	Visa Pichincha
BG	Amercican Express
VG	Visa Banco Guayaquil
MG	Mastercard Banco Guayaquil
DG	Débito Banco Guayaquil
DP	Débito Pacificar
MP	Mastercard Pichincha
DI	Discover
CO	Coop. 29 de Octubre
VM	Visa Medianet
VA	Visa Banco del Austro
MM	Mastercard Medianet
MA	Mastercard Banco del Austro
CS	Crédito Solidario
DS	Débito Solidario
UP	Unión Pay

AZ Tarjetas de crédito.

Para información adicional, escribir a servbdpago@datafast.com.ec

Rechazo de la Transacción (Respuestas del Banco)

Cuando la transacción es rechazada el valor del campo Response tiene alguno de los valores que se detalla en la siguiente tabla.

##	Descripción
02	Significa que hay un problema con la tarjeta del cliente, y tiene que llamar al Centro de Autorización del banco
03	Establecimiento inválido. Primero debe verificar si el comercio tiene asignado el tipo de crédito reportado, si todo está bien entonces llamar a DF y consultar.
04	Retenga la tarjeta y llame (puede haber sido reportada como robada o está utilizando una T.C. no válida)
05	Transacción rechazada por el banco, no especifica el motivo, en este caso puede llamar al banco y consultar
12	Transacción invalida, mensaje general emitido por el banco, puede ser por que la tarjeta no tiene permitido compras por internet, generalmente las de débito.
13	Monto inválido
14	Error en el número de tarjeta
15	Error en el número de tarjeta
17	Socio cancelado
19	Transacción rechazada, favor reintente
41	Tarjeta pérdida. Retenga la tarjeta y llame
43	Tarjeta robada. Retenga la tarjeta y llame
51	Fondos insuficientes
54	Tarjeta expirada
57	Transacción inválida o no permitida (diferidos mal enviado o transacción realizada con una tarjeta de débito con restricciones)
61	Monto excede el crédito disponible
62	Tarjeta restringida
76	Cuenta Inválida. En este caso es por el uso de una tarjeta de crédito no valida (Renovaciones)
77	Modalidad inválida. Cuando no tiene autorizado un tipo de crédito (diferido)
79	Vigencia errada (Fecha de caducidad)
80	Establecimiento cancelado
84	Significa que hay un problema con la tarjeta del cliente, y tiene que llamar al Centro de Autorización del banco
88	Transacción rechazada, favor reintente
89	Terminal inválida, se debe verificar si tiene el tipo de crédito autorizado por el banco caso contrario el comercio debe comunicarse con Datafast para revisión.
91	Entidad fuera de linea (Puede ser que el banco tuvo una intermitencia y justamente llegó la transacción y no la procesó
FORMAT_ERROR	Este mensaje es debido a la validación de la cédula es decir está sobrepasando los 10 caracteres, generalmente cuando envían el RUC
ER	Puede ser por 3 motivos: Transacción con mal cálculo de impuestos No se está enviando el MID y TID correctos (Error en la programación) Transacciones con monto menor a $1.00

Código de respuesta emitida por el banco

Opciones Avanzadas

Esta sección describirá como utilizar las opciones de tipos de créditos otorgados y autorizados por los bancos. Para esto se debe incluir la librería JQuery, por ejemplo:

                                        
                                            <script type=”text/javascript” src="jquery-3.2.1.js" > </script>

Diferidos

Para los diferidos o cuotas se debe agregar código javascript en la misma página o sección en donde se invoca el formulario de pago, en el ejemplo a continuación se lo agrega de forma estática, pero se recomienda que esto sea dinámico.

                                
                                <script type="text/javascript">
                                    var wpwlOptions = {
                                        onReady: function(){
                                            var numberOfInstallmentsHtml = '<div class="wpwl-label wpwl-label-custom" style="display:inline-block">Diferidos:</div>' +
                                              '<div class="wpwl-wrapper wpwl-wrapper-custom" style="display:inline-block">' +
                                              '<select name="recurring.numberOfInstallments"><option value="0">0</option><option value="3">3' +
                                              '</div>'
                                            $('form.wpwl-form-card').find('.wpwl-button').before(numberOfInstallmentsHtml);           
                                        },
                                        style: "card",
                                        locale: "es",
                                        labels: {cvv: "CVV", cardHolder: "Nombre(Igual que en la tarjeta)"}
                                    }
                                </script>

Javascript para diferidos (Installments)

Este código se puede generar de forma dinámica si acaso se posee los tipos de diferidos aprobados por el banco emisor en alguna tabla de la base de datos y agregarlos en campos de texto ocultos, sino puede dejarlo fijo en el formulario, igual la validación es que si se selecciona la opción 0 “cero” o simplemente no se envía este campo entonces se lo interpreta como una transacción corriente.

Código:

                                            
                                                <script type="text/javascript" > </script>
                                                var wpwlOptions = {
                                                       onReady: function() { 
                                                               var numberOfInstallmentsHtml = '<div
                                                               class="wpwl-label
                                                               wpwl-label-custom"
                                                               style="display:inline-block">Diferidos: </div>+ 
                                                               '<div class="wpwl-wrapper wpwl-wrapper-custom"
                                                               style="display:inline-block">'+ 
                                                               <select
                                                               name="recurring.numberOfInstallments"> 
                                                               <option value="0">0 </option><option
                                                               value="3">3+ 
                                                               </option><option value="6">
                                                               6</option><option
                                                               value="9">9</option></select>'+ 
                                                               </div>; 
                                                               $('form.wpwl-form-card').find('.wpwl-button').before(numberOfInstallmentsHtml);
                                                           } 
                                                } </script>

Muy importante que el nombre (atributo name) del elemento HTML (select) sea recurring.numberOfInstallments debido a que es un campo válido y reconocido por la plataforma de pago, cualquier cambio de este nombre no se garantiza el correcto funcionamiento.

Al agregar este JavaScript no se ve afectada la función request, es un campo que el formulario de pago lo envía de forma automática.

Si se decide en aplicar los diferidos de forma dinámica entonces se sugiere que en un paso anterior a la carga del formulario de pago se le muestre al usuario los tipos de diferidos autorizados y después agregan los campos de manera dinámica a la porción de código Javascript. A continuación, un ejemplo del paso previo a cargar el formulario.

Ejemplo de interfaz previa de selección de diferidos

Cuando se agregan las opciones de diferidos, en la respuesta JSON se puede observar un campo adicional en la respuesta de aprobación de una transacción tal como se muestra en la imagen.

                            
                                [recurring] => Array 
                                    (
                                        [numberOfInstallments] => 0
                                    )

Quedando el formulario con la opción de diferidos de forma estática de la siguiente manera

Opcion de diferidos

Tipo de Crédito

Para utilizar la opción de tipos de crédito se debe conocer con exactitud lo que el banco le haya autorizado, una vez en conocimiento de lo antes expuesto se debe utilizar el campo customParameters[SHOPPER_TIPOCREDITO]. La siguiente tabla muestra los tipos de crédito disponibles con el respectivo valor del parámetro.

SHOPPER_TIPOCREDITO	Descripción
00	Transacción Corriente
01	Diferido Corriente
02	Diferido con Interés
03	Diferido sin Interés
07	Diferido con Interés + Meses de Gracia
09	Diferido sin Interés + Meses de Gracia
21	Diferido Plus
22	Diferido

Tipos de crédito

La figura siguiente muestra el aspecto de la opción de tipo de crédito utilizando javascript de forma estática.

Opción Tipo de crédito

El siguiente código de ejemplo se debe agregar en la misma sección en donde se carga el formulario de pago, si lo hacen de forma dinámica entonces en vez del tag select lo reemplazan con un input text de manera oculta pero respetando la propiedad name caso contrario el Gateway de pagos no reconocerá el campo.

                                            
                                                var tipocredito = 
                                                '<div class="wpwl-wrapper wpwl-wrapper-custom" style="display:inline-block">'+ 'Tipo de crédito: <select
                                                name="customParameters[SHOPPER_TIPOCREDITO]"> <option value="00">Corriente</option>'+ 
                                                <option value="01">Dif Corriente</option>'+ 
                                                <option value="02">Dif con int</option>'+ 
                                                <option value="03">Dif sin int</option>'+ 
                                                <option value="07">Dif con int + Meses gracia</option>'+ 
                                                <option value="09">Dif sin int + Meses gracia</option>'+ 
                                                <option value="21">Dif plus cuotas</option>'+ 
                                                <option value="22">Dif plus</option>'+ 
                                                </div> 
                                                $('form.wpwl-form-card').find('.wpwl-button').before(tipocredito);

A nivel de Javascript tendría una apariencia como se muestra en la siguiente imagen.

                                
                                <script type="text/javascript">
                                    var wpwlOptions = {
                                        onReady: function() {
                                            var numberOfInstallmentsHtml ='<div class="wpwl-label wpwl-label-custom" style="display:inline-block">Diferidos:</div>' +
                                            '<div class="wpwl-wrapper wpwl-wrapper-custom" style="display:inline-block">' +
                                            '<select name="recurring.numberOfInstallments"><option value="0">0</option><option value="3">3</option><option value="6">6</option>
                                                <option value="9">9</option></select>' +
                                            '</div>';
                                            $('form.wpwl-form-card').find('.wpwl-button').before(numberOfInstallmentsHtml);
                                            var tipocredito =
                                                '<div class="wpwl-wrapper wpwl-wrapper-custom" style="display:inline-block">' +
                                                'Tipo de crédito:<select name="customParameters[SHOPPER_TIPOCREDITO]"><option value="00">Corriente</option>' +
                                                '<option value="01">Dif Corriente</option>' +
                                                '<option value="02">Dif con int</option>' +
                                                '<option value="03">Dif sin int</option>' +
                                                '<option value="07">Dif con int + Meses gracia</option>' +
                                                '<option value="01">Dif sin int + Meses gracia</option>' +
                                                '<option value="01">Dif plus cuotas</option>' +
                                                '<option value="01">Dif plus</option>' +
                                                '</div>'
                                            $('form.wpwl-form-card').find('.wpwl-button').before('tipocredito');

                                            var datafast= '<br/><br><img src='+'"https://www.datafast.com.ec/images/verified.png" style='+'"display:block;margin:0 auto; width:100%;">';
                                            $('form.wpwl-form-card').find('.wpwl-button').before(datafast);

                                        },
                                        style: "card",
                                        locale: "es",
                                        labels: {cvv: "CVV", cardHolder: "Nombre(Igual que en la tarjeta)", insertCode:"Ingrese el codigo"}
                                    }
                                </script>

Código Javascript de la implementación de Diferidos y Tipos de Crédito

En un navegador web (browser) se mostraría lo siguiente.

Formulario con las opciones de diferidos y tipos de crédito

Se vuelve a recalcar que todo lo expuesto a nivel de diseño son ejemplos, al final el desarrollador en conjunto con el comercio definirá el flujo y aspecto que más se adapte.

Cuando se ejecuta una transacción con algún tipo de crédito seleccionado entonces en el JSON de respuesta se incluirá este campo.

                                
                                [shipping] => Array
                                (
                                    [street1] => Edif. Las Camaras, piso 4
                                    [country] => EC    
                                )

                                [customParameters] => Array
                                (
                                    [SHOPPER_EndToEndIdentity] => 586e34692e12a8a342ae7972d18ac
                                    [SHOPPER_TIPOCREDITO] => 00
                                    [CTPE_DESCRIPTOR_TEMPLATE] =>

Validación campos vacíos

Dentro del formulario del botón de pagos se pueden validar por ejemplo que el campo cardholder no este vacío para evitar transacciones rechazadas por el banco renombrado el método onBeforeSubmitCard.

                                
                                <script type="text/javascript">
                                    var wpwlOptions= {
                                        style: "card",
                                        locale: "es",
                                        labels: {cvv: "CVV", cardHolder: "Nombre(Igual que en la tarjeta)"},
                                            onBeforeSubmitCard: function(){
                                                if($("$.wpwl-control-cardHolder").val()===""){
                                                    $(".wpwl-control-cardHolder").addClass("wpwl-has-error");
                                                    $(".wpwl-button-CardHolder").after("<div class='wpwl-hint-cardHolderError'>Campo requerido</div>");
                                                    $(".wpwl-button-pay").addClass("wpwl-button-error").attr("disabled", "disabled");
                                                    return false;
                                                }else
                                                    return true;
                                                }                               
                                    }
                                </script>

Código para validación del campo cardholder (Nombre del dueño de la tarjeta).

Estilo del formulario

En alguna ocasión se necesita que el formulario se contraste con los colores corporativos, para este caso puede optar con la modalidad “plana”, para esto debe cambiar el parámetro style con el valor plain. Luego puede aplicar sus propias reglas de estilos.

Estilo plano del formulario de pago

Optimización Móvil

Nuestro Widget está optimizado para navegadores móviles de forma predeterminada. Sin embargo, si está creando su propio estilo personalizado para el formulario de pago, aquí hay algunos consejos.

Habilitar el diseño responsivo en el HTML

Agregar el siguiente código entre las etiquetas head

                                                
                                                    <meta name = "viewport" content = "ancho = ancho del dispositivo, escala inicial = 1">

Mobile First (CSS)

Mejore su formulario con Media Queries, para construir sus estilos móviles para viewports más amplios (como tabletas) y pantallas de alta resolución. Se recomienda que adapte estas consultas multimedia en función del contenido de su sitio en lugar de reflejar las dimensiones fijas de dispositivos específicos.

                                                
                                                    /* Valor por defecto, aplica a todos los dispositivos */ 
                                                    .button {width: 100%} 
                                                    @media (min-width: 480px) { 
                                                         /* esta regla se aplica solo a dispositivos con un ancho de pantalla 
                                                         mínimo de 480px*/ 
                                                         .button { 
                                                         width: 50%; 
                                                         } 
                                                    }

Botones y Campos de texto (CSS)

Los campos y botones de entrada más grandes hacen que el uso de su formulario de pago sea mucho más fácil. Apple dice que el toque de dedo promedio es de aproximadamente 44x44 píxeles. Por supuesto, casi todos los campos y botones de entrada son más grandes que 44px. En la mayoría de los casos, solo necesita establecer la altura.

                                                
                                                    .input, .button { height: 44px; width: 100%;}

El aspecto sería el que se muestra a continuación, recordar que la adaptación depende de la experiencia de la persona que lo está implementando, todo el código expuesto es referencial.

Formulario adaptado para aplicaciones móviles

OneclickCheckout (Pago con un click)

Esta guía le permite lograr una aceleración significativa del proceso de compra reutilizando los datos que un cliente ingresó para una transacción.

Preparación del pago

En este punto se repite lo de la Fase Dos, la diferencia radica en agregar código JavaScript como se muestra a continuación.

                                
                                <script type="text/javascript">
                                    var wpwlOptions = {
                                        onReady: function(onReady) {
                                            var createRegistrationHtml = '<div class="customLabel">Desea guardar de manera segura sus datos?</div> 
                                             <div class="customInput"><input type="checkbox" name="createRegistration" /></div>';
                                            $('form.wpwl-form-card').find('.wpwl-button').before(createRegistrationHtml);
                                        },
                                        style: "card",
                                        locale: "es",

                                        labels: {cvv: "Codigo de verificación", cardholder: "Nombre(Igual que en la tarjeta),"},

                                        registrations: {
                                            requireCvv: true,
                                            hideInitialPaymentForms: true
                                        }
                                    }
                                </script>

Código para activar la captura (tokenización) de los datos de la tarjeta del cliente.

A continuación, el código:

                                            
                                                var createRegistrationHtml = '<div class="customLabel">Desea guardar de manera segura sus datos?</div> 
                                                <div class="customInput"><input type="checkbox" name="createRegistration" /></div>';
                                                $('form.wpwl-form-card').find('.wpwl-button').before(createRegistrationHtml);

Formulario incluyendo la opción de captura de datos

En el Json de respuesta de la transacción podrá observa un nuevo campo llamado registrationId el cual contiene el token asociado a los datos de la tarjeta de crédito. Este campo debe ser guardado en una tabla de su base de datos asociada a un id del usuario del sistema, de esta manera usted podrá consultar en la siguiente compra si ese usuario tiene tokens asociados.

En la segunda compra, de existir tokens asociados a ese cliente entonces usted los agregará a la primera función request() usando el parámetro registrations de la siguiente manera:

                                                  
                                                registrations[0].id= 8ac7a49f6ab04d18016ab2067a2731b2
                                                registrations[1].id= 8ac7a4a06ab05883016ab2067d3841d0

Quedando el formulario de la siguiente forma.

Formulario de pago OneclickCheckout (Pago con un click)

Cabe mencionar que debido a que el formulario cambia su aspecto entonces también cambie sus reglas CSS aplicadas por lo que si desean a este formulario de pago rápido agregar las opciones de diferidos y tipos de crédito entonces el único cambio que deben realizar en la sección de Javascript es cambiar la regla CSS a la cual se hace referencia.

                                
                                var numberOfInstallments0cchk = '<div class="wpwl-label wpwl-label-custom" style="display:inline-block">Diferidos: </div>+
                                '<div class="wpwl-wrapper wpwl-wrapper-custom" style="display:inline-block">'+ <select
                                name="recurring.numberOfInstallments"><option value="0">0 </option><option value="3">3+
                                    </option><option value="6">6</option><option value="9">9</option></select>'+
                                    </div>;
                                $('form.wpwl-form-registrations').find('.wpwl-button').before(numberOfInstallmentsOcchk);

Eliminación del Token

Una vez almacenado, un token se puede eliminar usando el método DELETE HTTP usando la siguiente función.

                                
                                function request($identificador){
                                    $url = "https://test.oppwa.com/v1/registrations/".$identificador;
                                    $url .= "?entityId=8a8294185a65bf5e015a6c8b89a10d8d";

                                    $ch = curl_init();
                                    curl_setopt($ch, CURLOPT_URL, $url);
                                    curl_setopt($ch, CURLOPT_HTTPHEADER, array(
                                        'Authorization:Bearer OGE4Mjk0MTc0YjdlY2IyODAxNGI5Njk5MjIwMDE1Y2N8c3k2S0pzVDg='));
                                    curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'DELETE');
                                    curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false); //this should be set to true in production
                                    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
                                    $responseData = curl_exec($ch);
                                    if(curl_errno($ch)){
                                        return curl_error($ch);
                                    }
                                    curl_close($ch);
                                    return $responseData;
                                }

Función de eliminación del token

La respuesta al ejecutar esta función está en formato JSON en donde podrá obtener el código correspondiente si fue eliminado correctamente.

                                
                                {
                                    "id":"8ac74a26db4c658016db60e28fe3f51",
                                    "referencedid":"8ac7a4a16db4c3ba016db609e49733d8",
                                    "merchantTransactionId":"transaction_306",
                                    "result":{
                                        "code":"000.100.112",
                                        "description":"Request successfully processed in Merchant in Connector Test Mode"
                                    },
                                    "customer":{
                                        "merchantCustomerId":"1",
                                        "buildNumber":"acd90696fa1135b6bcca17bf1be027856159bce4@2019-10-08 14:06:34 +0000",
                                        "timestamp":"2019-10-10 14:24:04 +0000",
                                        "ndc":"8a8294185a65bf5e015a6c8b89a10d8d_d22020ef08d1490a8d9d3ea80eeb9503"
                                    }
                                }

Si desea comprobar que el token está eliminado puede intentar realizar una transacción con dicho token y obtendrán el siguiente mensaje.

Mensaje de error en la transacción ya que no existe el token

Anulaciones

En este apartado se indicará el proceso de anulación que debe ser implementado por el comercio de acuerdo con sus metodologías y estándares.

Cada transacción de compra aprobada en su respuesta dentro del formato JSON viene un campo llamado id, tal como se muestra en la siguiente figura.

                            
                            Array 
                            (
                                [id] => 8ac7a4a072e61a030172e8629eaf2af9
                                [paymentType] => DB
                                [paymentBrand] => VISA
                                [amount] => 1.12
                                [currency] => USD
                                [descriptor] => 1459.42717847 Low Risk Sector
                                [mechantTransactionId] => transaction_644
                                [result] => Array
                                    (
                                        [code] => 000.100.112
                                        [description] => Request successfully processed
                                    )
                            )

En el método mostrado a continuación, lo marcado en color amarillo es el id de la transacción aprobada y esta debe concatenarse a la URL que se observa, también el campo paymentType debe ser igual a RF y así los otros campos mostrados.

                            
                            function request(){
                                $url = "https://eu-test.oppwa.com/v1/payments/{id}";
                                $data = "entityId=8a8294174b7ecb28014b9699220015ca" .
                                        "&amount=10.00" . 
                                        "&currency=USD" . 
                                        "&paymentType=RF" . 
                                        "&testMode=EXTERNAL";
                                $ch = curl_init();
                                curl_setopt($ch, CURLOPT_URL, $url);
                                curl_setopt($ch, CURLOPT_HTTPHEADER, array(
                                    'Authorization:Bearer OGE4Mjk0MTc0YjdlY2IyODAxNGI5Njk5MjIwMDE1Y2N8c3k2S0pzVDg='));
                                curl_setopt($ch, CURLOPT_POST, 1);
                                curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
                                curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false); //this should be set to true in production
                                curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
                                $responseData = curl_exec($ch);
                                if(curl_errno($ch)){
                                    return curl_error($ch);
                                }
                                curl_close($ch);
                                return $responseData;
                            }

Método de anulación

Una vez ejecutado el método se obtendrá la respuesta en formato JSON de la siguiente manera.

                            
                            Array
                            (
                                [id] => Sac7a4a072e61a030172e801495e51e0
                                [referencedid] => 8ac7a49f72e6114e0172e7b98da03751
                                [payment Type] => RF
                                [amount] => 1.12
                                [currency]> USD
                                [descriptor] => 5636.2635.2023 Low Risk Sector
                                [merchantTransactionId] => transaction_636
                                [result] => Array
                                (
                                    [code] => 000.100.112
                                    [description] => Request successfully processed in 'Merchant in Connector Test Mode'
                                )
                                [resultDetails] => Array
                                (
                                    [ExtendedDescription] => Transaction succeeded (Transacción Aprobada)
                                    [clearingInstituteliame] => Datafast
                                    [AuthCode] => 058682
                                    [ConnectorTxID1] => 8ac7a4a072e61a030172e801495e51e0
                                    [ReferenceNbr] => 280624-000845 
                                    [Acquirer Response] => 08_04VG
                                )
                                [customer] => Array
                                (
                                    [merchantCustomerId] => 000000000001
                                )
                                [buildlumber] => albe3f77948f3988ab60864738489ae29b2a63da@2020-06-24 16:41:11 +0000
                                [timestamp] => 2020-06-24 20:24:59+0000
                                [ndc] => Ba8294185a65bf5e915a6c8b89a10d8d_c91b3c90bc854145a00611e3843948bd
                            )

Otros Métodos de Integración

Una manera alterna para la integración de nuestro botón de pagos es haciéndolo con la modalidad server-to-server, pero esta opción no es la ofrecida por defecto a los comercios debido a que esto implica la validación de algunos factores de riesgos y certificados.

Esta modalidad debe ser validada por Datafast y las entidades financieras involucradas.

Personalización

El botón de pagos puede ser personalizado en su apariencia (CSS), solo basta conocer el nombre de las clases asociadas actualmente a los elementos. Para adicional información se debe solicitar a Datafast.

                            
                            <script>
                            var wpwlOptions = {
                                iframeStyles: {
                                    'card-number-placeholder': {
                                        'color': '#ff0000',
                                        'font-size': '16px',
                                        'font-family': 'monospace'
                                    },
                                        'cvv-placeholder': {
                                            'color': '#0000ff',
                                            'font-size': '16px',
                                            'font-family': 'Arial'
                                        }
                                }
                            }
                            </script>

Código de referencia en la personalización de reglas de estilos

Para validaciones que involucren JavaScript seguir la referencia del apartado Validación de campos vacios

Verificador de Transacciones

En el caso de que el portal no reciba el mensaje de aprobación o rechazo de la transacción se ha implementado la funcionalidad de verificar si la misma consta en nuestra base, de ser así usted podrá realizar una consulta y obtener los datos de esta e ingresarla a su sistema. Existen dos maneras de realizar las verificaciones.

Verificar por identificador de la transacción

En esta modalidad se podrá consultar mediante el identificador de la transacción es decir por el paymentId

                                
                                function request($identificador){
                                    $url = "https://test.oppwa.com/v1/query/".$identificador;
                                    $url .= "?entityId=8a8294185a65bf5015a6c8b89a10d8d";

                                    $ch = curl_init();
                                    curl_setopt($ch, CURLOPT_URL, $url);
                                    curl_setopt($ch, CURLOPT_HTTPHEADER, array(
                                        'Authorization:Bearer OGE4Mjk0MTg1YTY1YmY1ZTAxNWE2YzhiMmY20TBkOGJ8UmtqcH10TKU4cw=='));
                                    curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false); //this should be set to true in production
                                    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
                                    $responseData = curl_exec($ch);
                                    if(curl_errno($ch)){
                                        return curl_error($ch);
                                    }
                                    curl_close($ch);
                                    return $responseData;
                                }

Función para verificar y obtener si una transacción fue procesada (aceptada/rechazada)

Cuando se ejecuta la función se obtendrá una respuesta en formato JSON en donde encontrará los datos de la transacción la cual puede ser procesada por la aplicación del comercio.

                              
                                [resultDetails] => Array
                                (
                                    [RiskFraudStatusCode] => ACCEPT
                                    [RequestId] => 350545885144
                                    [ConnectorTxID1] => 8ac7a4a26ca94245016cab600999378d
                                    [AuthCode] => 123134
                                    [ReferenceNbr] => 190819 000014
                                    [EXTERNAL_SYSTEM_LINK] => https://csi-stage.redworldwide.com/index.red#transactiondet
                                    [OrderId] => 447145618125
                                    [ExtendedDescription] => Transaction succeeded [RiskStatusCode] => PENDING
                                    [clearingInstituteName] => Datafast
                                    [RiskResponseCode] => 0100
                                    [AcquirerResponse] => 00_04VG
                                    [RiskOrderId] => 000537010000XCI20190819153454054
                                )

Ejemplo de funcionamiento en un portal web

Verificar por el número de transacción del comercio

En esta modalidad se puede consultar por el identificador único de la transacción del comercio (merchantTransactionId).

                                
                                function request2($identificador){
                                    $url = "https://oppwa.com/v1/query";
                                    $url .= "?entityId=8acda4cd7038b8c201703f5644f33c49";
                                    $url .= "&merchantTransactionId=" .$identificador;

                                    $ch = curl_init();
                                    curl_setopt($ch, CURLOPT_URL, $url);
                                    curl_setopt($ch, CURLOPT_HTTPHEADER, array(
                                        'Authorization:Bearer OGEjZGE0Y2Q3DM4YjhjMjAxNzAzZjU0ZTYwNDNjNDF8TVBDalB0NkVxRA'));
                                    curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'GET');
                                    curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false); //this should be set to true in production
                                    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
                                    $responseData2 = curl_exec($ch);
                                    if(curl_errno($ch)){
                                        return curl_error($ch);
                                    }
                                    curl_close($ch);
                                    return $responseData2;
                                }

Función para verificar y obtener si una transacción fue procesada (aceptada/rechazada) mediante el merchantTransactionId

Al igual que la primera modalidad esta función retorna como respuesta un JSON en el cual podrán obtener los datos de la transacción. Deben tomar en cuenta que cambian ciertas claves (keys) dentro del array y que puede retornar más de un dato en el caso de que se desea consultar una transacción y esta fue anulada, por lo que en la consulta se obtendrán dos registros, el DB y el RF

Paso a Producción

Para salir a producción se debe tener presente el siguiente procedimiento de certificación.

Una vez que se ha desarrollado el botón en ambiente de pruebas se realiza lo siguiente:

Proceso	Descripción	Responsable
Script de Pruebas	Deberá descargar el Script de Pruebas dando click aquí, deberá llenarlo con datos de las transacciones de prueba.	Comercio
Validación de Script	Una vez que el comercio ha entregado vía correo electrónico el archivo de las transacciones entonces se procede a validar que cumpla con los requisitos establecidos en este documento. Si existe alguna inconsistencia en los datos se le hará conocer para su corrección por parte del Comercio	Datafast / Comercio
Escaneo de Vulnerabilidades	Datafast con el fin de garantizar que las transacciones se realicen en un ambiente seguro procede a escanear el sitio web del comercio en busca de vulnerabilidades. Se entrega un informe al comercio, si hay remediaciones por hacer entonces será el comercio quien estime sus tiempos de correcciones, una vez entregada las modificaciones se reinicia el proceso de escaneo lo que involucra otra vez de 24 a 48 horas laborables para entregar el informe.	Datafast / Comercio
Gestión de códigos bancarios	Datafast se encargar de gestionar la creación de códigos bancarios que autoricen al comercio poder transacciones con el botón de pagos. Es importante tener claro los tipos de créditos habilitados por la entidad financiera	Datafast
Gestión de códigos transaccionales	Datafast se encarga de la creación de MID y TID una vez que el banco haya proporcionado los códigos como se menciona en el ítem anterior.	Datafast
Ajuste de códigos	El comercio se encargará de realizar los ajustes al código para salir a producción (Actualización de Código para el Paso a Producción), notificará a Datafast cuando haya terminado para la revisión respectiva	Comercio
Salida a Producción	Se coordina fecha y hora para realizar una transacción en producción para esto el comercio deberá tener una tarjeta de crédito real, así como un ítem de prueba en su sistema con un valor no mayor a $1.00	Datafast/Comercio

Ejemplos

Código básico en lenguaje PHP, función para obtener el CheckoutId.

                                        
                                        function request() { 
                                           $url = "https://eu-test.oppwa.com/v1/checkouts"; 
                                           $data = "entityId=8a829418533cf31d01533d06f2ee06fa" 
                                           "&amount=92.00" 
                                           "&currency=USD"
                                           "&paymentType=DB"; 
                                           $ch = curl_init(); 
                                           curl_setopt($ch, CURLOPT_URL, $url); 
                                           curl_setopt($ch, CURLOPT_HTTPHEADER, array('Authorization:Bearer
                                           OGE4Mjk0MTg1MzNjZjMxZDAxNTMzZDA2ZmQwNDA3NDh8WHQ3RjIyUUVOWA==')); 
                                           curl_setopt($ch, CURLOPT_POST, 1); 
                                           curl_setopt($ch, CURLOPT_POSTFIELDS, $data); 
                                           curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);// this should be set to true in production 
                                           curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); 
                                           $responseData = curl_exec($ch); 
                                           if(curl_errno($ch)) { 
                                               return curl_error($ch); 
                                           } 
                                           curl_close($ch); 
                                           return $responseData; 
                                        }

Código básico en PHP, función de comprobación del estado de la transacción. Previamente ya se ha obtenido el parámetro $resourcePath basado en la URL en el atributo action del tag FORM

                                        
                                        function request() {
                                           $url = "https:// eu-test.oppwa.com".$resourcePath;
                                           $url .= "?entityId=".$entityId;
                                           $ch = curl_init();
                                           curl_setopt($ch, CURLOPT_URL, $url);
                                           curl_setopt($ch, CURLOPT_HTTPHEADER, array(
                                           'Authorization:BearerOGE4Mjk0MTg1MzNjZjMxZDAxNTMzZDA2ZmQwNDA3NDh8WHQ3RjIyUUVOWA=='));
                                           curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'GET');
                                           curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);// this should be set to true in production
                                           curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
                                           $responseData = curl_exec($ch);
                                           if(curl_errno($ch)) {
                                              return curl_error($ch);
                                           }
                                           curl_close($ch);
                                           return $responseData;
                                        }

Java

CheckoutId
Estado de la Transacción

Código básico en lenguaje JAVA, función para obtener el CheckoutId.

                                        
                                       private String request() throws IOException {
                                           HttpsURLConnection conn = (HttpsURLConnection) url.openConnection();
                                           conn.setRequestMethod("POST");
                                           conn.setRequestProperty("Authorization", "Bearer
                                           OGE4Mjk0MTc0YjdlY2IyODAxNGI5Njk5MjIwMDE1Y2N8c3k2S0pzVDg=");
                                           conn.setDoInput(true);
                                           conn.setDoOutput(true);
                                           String data = ""
                                           + "entityId=8a8294174b7ecb28014b9699220015ca"
                                           + "&amount=92.00"
                                           + "&currency=USD"
                                           + "&paymentType=DB";
                                           DataOutputStream wr = new DataOutputStream(conn.getOutputStream());
                                           wr.writeBytes(data);
                                           wr.flush();
                                           wr.close();
                                           int responseCode = conn.getResponseCode();
                                           InputStream is;
                                           if (responseCode >= 400) is = conn.getErrorStream();
                                           else is = conn.getInputStream();
                                           return IOUtils.toString(is);
                                        }

Código básico en JAVA, función de comprobación del estado de la transacción. Previamente ya se ha obtenido el parámetro String resourcePath basado en la URL en el atributo action del tag FORM

                                        
                                       private String request() throws IOException {
                                         URL url = new URL("https://eu-test.oppwa.com/v1/checkouts/{id}/payment?entityId8a829418533cf31d01533d06f2ee06fa");
                                         HttpsURLConnection conn = (HttpsURLConnection) url.openConnection();
                                         conn.setRequestMethod("GET");
                                         conn.setRequestProperty("Authorization", "BearerOGE4Mjk0MTg1MzNjZjMxZDAxNTMzZDA2ZmQwNDA3NDh8WHQ3RjIyUUVOWA==");
                                         int responseCode = conn.getResponseCode();
                                         InputStream is;
                                         if (responseCode >= 400) is = conn.getErrorStream();
                                         else is = conn.getInputStream();
                                         return IOUtils.toString(is);    
                                        }

C#

CheckoutId
Estado de la Transacción

Código básico en lenguaje C#, función para obtener el CheckoutId

                                    
                                    public Dictionary <string, dynamic> Request() {
                                       Dictionary<string, dynamic> responseData;
                                       string data=" entityId=8a829418533cf31d01533d06f2ee06fa"
                                       "&amount=92.00" +
                                       "&currency=USD" +
                                       "&paymentType=DB";
                                       string url = "https://eu-test.oppwa.com/v1/checkouts";
                                       byte[] buffer = Encoding.ASCII.GetBytes(data);
                                       HttpWebRequest request = (HttpWebRequest)HttpWebRequest.Create(url);
                                       request.Method = "POST";
                                       request.Headers["Authorization"] = "Bearer 
                                       OGE4Mjk0MTg1MzNjZjMxZDAxNTMzZDA2ZmQwNDA3NDh8WHQ3RjIyUUVOWA==";
                                       request.ContentType = "application/x-www-form-urlencoded";
                                       Stream PostData = request.GetRequestStream();
                                       PostData.Write(buffer, 0, buffer.Length);
                                       PostData.Close();
                                       using (HttpWebResponse response = 
                                       (HttpWebResponse)request.GetResponse())
                                       {
                                          Stream dataStream = response.GetResponseStream();
                                          StreamReader reader = new StreamReader(dataStream);
                                          var s = new JavaScriptSerializer();
                                          responseData = s.Deserialize<Dictionary<string, dynamic>>(reader.ReadToEnd());
                                          reader.Close();
                                          dataStream.Close();
                                       } return responseData;
                                    }

Código básico en C#, función de comprobación del estado de la transacción. Previamente ya se ha obtenido el parámetro String resourcePath basado en la URL en el atributo action del tag FORM

                                    
                                    public Dictionary<string, dynamic> Request() { 
                                     Dictionary<string, dynamic> responseData;string data="entityId=8a829418533cf31d01533d06f2ee06fa";
                                     string url = "https://eu-test.oppwa.com/v1/checkouts/{id}/payment?" + data;
                                     HttpWebRequest request = (HttpWebRequest)HttpWebRequest.Create(url);
                                     request.Method = "GET";
                                     request.Headers["Authorization"] = "BearerOGE4Mjk0MTg1MzNjZjMxZDAxNTMzZDA2ZmQwNDA3NDh8WHQ3RjIyUUVOWA==";
                                     using (HttpWebResponse response = 
                                     (HttpWebResponse)request.GetResponse())
                                     {
                                        Stream dataStream = response.GetResponseStream();
                                        StreamReader reader = new StreamReader(dataStream);
                                        var s = new JavaScriptSerializer();
                                        responseData = s.Deserialize<Dictionary<string, dynamic>>(reader.ReadToEnd());
                                        reader.Close();
                                        dataStream.Close();
                                     }
                                     return responseData;
                                    }

Python

CheckoutId
Estado de la Transacción

Código básico en lenguaje Python, función para obtener el CheckoutId.

                                    
                                    Import urllib, urllib2, json def request():
                                       url = "https://eu-test.oppwa.com/v1/checkouts"
                                       data = {
                                          'entityId' : '8a829418533cf31d01533d06f2ee06fa',
                                          'amount' : '92.00',
                                          'currency' : 'USD',
                                          'paymentType' : 'DB'
                                       }
                                       try:
                                          opener = urllib2.build_opener(urllib2.HTTPHandler)
                                          request = urllib2.Request(url, data=urllib.urlencode(data))
                                          request.add_header('Authorization', 'Bearer
                                          OGE4Mjk0MTg1MzNjZjMxZDAxNTMzZDA2ZmQwNDA3NDh8WHQ3RjIyUUVOWA==')
                                          request.get_method = lambda: 'POST'
                                          response = opener.open(request)
                                          return json.loads(response.read());
                                          except urllib2.HTTPError, e:
                                          return e.code;

Código básico en Python, función de comprobación del estado de la transacción. Previamente ya se ha obtenido el parámetro String resourcePath basado en la URL en el atributo action del tag FORM

                                    
                                    import urllib, urllib2, json def request():
                                       url = "https://eu-test.oppwa.com/v1/checkouts/{id}/payment"
                                       url += '?entityId=8a829418533cf31d01533d06f2ee06fa'
                                       try:
                                          opener = urllib2.build_opener(urllib2.HTTPHandler)
                                          request = urllib2.Request(url, data='')
                                          request.add_header('Authorization', 'Bearer
                                          OGE4Mjk0MTg1MzNjZjMxZDAxNTMzZDA2ZmQwNDA3NDh8WHQ3RjIyUUVOWA==')
                                          request.get_method = lambda: 'GET'
                                          response = opener.open(request)
                                          return json.loads(response.read());
                                          except urllib2.HTTPError, e:
                                          return e.code;

Node.js

CheckoutId
Estado de la Transacción

Código básico en lenguaje Node.js, función para obtener el CheckoutId.

                                    
                                const https = require('https');
                                const querystring = require('querystring');
                                const request = async () => {
                                   const path='/v1/checkouts';
                                   const data = querystring.stringify({
                                      'entityId':'8a8294174b7ecb28014b9699220015ca',
                                      'amount':'92.00',
                                      'currency':'EUR',
                                      'paymentType':'DB'
                                   });
                                   const options = {
                                      port: 443,
                                      host: 'eu-test.oppwa.com',
                                      path: path,
                                      method: 'POST',
                                      headers: {
                                      'Content-Type': 'application/x-www-form-urlencoded',
                                      'Content-Length': data.length,
                                      'Authorization':'BearerOGE4Mjk0MTc0YjdlY2IyODAxNGI5Njk5MjIwMDE1Y2N8c3k2S0pzVDg='
                                      }
                                   };
                                   return new Promise((resolve, reject) => {
                                      const postRequest = https.request(options, function(res) {    
                                         const buf = [];
                                         res.on('data', chunk => {
                                            buf.push(Buffer.from(chunk));
                                         });
                                      res.on('end', () => {
                                         const jsonString = Buffer.concat(buf).toString('utf8');
                                         try {
                                            resolve(JSON.parse(jsonString));
                                            } catch (error) {
                                               reject(error);
                                            }
                                      });
                                   });
                                   postRequest.on('error', reject);
                                   postRequest.write(data);
                                   postRequest.end();
                                   });
                                };

Código básico en Node.js, función de comprobación del estado de la transacción. Previamente ya se ha obtenido el parámetro String resourcePath basado en la URL en el atributo action del tag FORM

                                    
                                    const https = require('https'); 
                                       const querystring = require('querystring');
                                       const request = async () => {
                                          var path='/v1/checkouts/{id}/payment';
                                          path += '?entityId=8a8294174b7ecb28014b9699220015ca';
                                          const options = {
                                           port: 443,
                                           host: 'eu-test.oppwa.com',
                                           path: path,
                                           method: 'GET',
                                           headers: {
                                           'Authorization':'BearerOGE4Mjk0MTc0YjdlY2IyODAxNGI5Njk5MjIwMDE1Y2N8c3k2S0pzVDg='
                                           }
                                          };
                                       const postRequest = https.request(options, function(res) {
                                          const buf = [];
                                          res.on('data', chunk => {
                                             buf.push(Buffer.from(chunk));
                                          });
                                          res.on('end', () => {
                                             const jsonString = Buffer.concat(buf).toString('utf8');
                                                try {
                                                resolve(JSON.parse(jsonString));
                                             } catch (error) {
                                                reject(error);
                                             }
                                          });
                                       });
                                       postRequest.on('error', reject);
                                       postRequest.end();
                                       });
                                    };

Ejemplo Visual Basic.Net

CheckoutId
Estado de la Transacción

Código básico en VB.net, función para obtener el CheckoutId

                                    
                                    Public Function Request() As Dictionary(Of String, Object) 
                                       Dim url As String = "https://eu-test.oppwa.com/v1/checkouts"
                                       Dim data As String = "" +
                                       "entityId=8a829418533cf31d01533d06f2ee06fa" +
                                       "&amount=92.00" + "&currency=USD" + "&paymentType=DB"
                                       Dim req As WebRequest = WebRequest.Create(url)
                                       req.Method = "POST"
                                       req.Headers.Add("Authorization", "BearerOGE4Mjk0MTg1MzNjZjMxZDAxNTMzZDA2ZmQwNDA3NDh8WHQ3RjIyUUVOWA==")
                                       req.ContentType = "application/x-www-form-urlencoded"
                                       Dim byteArray As Byte() = Encoding.UTF8.GetBytes(data)
                                       req.ContentLength = byteArray.Length
                                       Dim dataStream As Stream = req.GetRequestStream()
                                       dataStream.Write(byteArray, 0, byteArray.Length)
                                       dataStream.Close()
                                       Dim res As WebResponse = req.GetResponse()
                                       Dim resStream = res.GetResponseStream()
                                       Dim reader As New StreamReader(resStream)
                                       Dim response As String = reader.ReadToEnd()
                                       reader.Close()
                                       resStream.Close()
                                       res.Close()
                                       Dim jss As New System.Web.Script.Serialization.JavaScriptSerializer()
                                       Dim dict As Dictionary(Of String, Object) = jss.Deserialize(Of Dictionary(Of
                                       String, Object))(response)
                                       Return dict
                                    End Function

Código básico en VB.net, función de comprobación del estado de la transacción. Previamente ya se ha obtenido el parámetro String resourcePath basado en la URL en el atributo action del tag FORM

                                    
                                    Public Function Request() As Dictionary(Of String, Object) 
                                       Dim url As String = "https://eu-test.oppwa.com/v1/checkouts/{id}/payment" +
                                       "?entityId=8a829418533cf31d01533d06f2ee06fa"
                                       Dim req As WebRequest = WebRequest.Create(url)
                                       req.Method = "GET"
                                       req.Headers.Add("Authorization", "BearerOGE4Mjk0MTg1MzNjZjMxZDAxNTMzZDA2ZmQwNDA3NDh8WHQ3RjIyUUVOWA==")
                                       req.ContentType = "application/x-www-form-urlencoded"
                                       Dim res As WebResponse = req.GetResponse()
                                       Dim resStream = res.GetResponseStream()
                                       Dim reader As New StreamReader(resStream)
                                       Dim response As String = reader.ReadToEnd()
                                       reader.Close()
                                       resStream.Close()
                                       res.Close()
                                       Dim jss As New System.Web.Script.Serialization.JavaScriptSerializer()
                                       Dim dict As Dictionary(Of String, Object) = jss.Deserialize(Of Dictionary(Of 
                                       String, Object))(response)
                                       Return dict
                                    End Function
                                    responseData = Request()("result")("description")

Comprobación de Conectividad con el gateway de pagos

                                
                                curl https://eu-test.oppwa.com/v1/checkouts -d 
                                "entityId=8a829418533cf31d01533d06f2ee06fa" -d "amount=92.00" -d 
                                "currency=USD" -d "paymentType=DB" -H "Authorization: Bearer 
                                OGE4Mjk0MTg1MzNjZjMxZDAxNTMzZDA2ZmQwNDA3NDh8WHQ3RjIyUUVOWA=="

Requerimientos Tecnicos

Los requerimientos técnicos se mencionan a continuación:

Sitio Web en producción con solución de carrito de compras que contenga el stock de todos los productos e información del Dominio (Esta deberá encontrarse en la página web c/u en una sección independiente):

Política de Privacidad,
Contacto (correo y # de Teléfono),
Políticas de Envío y Entrega (no aplica en comercios cuyos giros son servicios),
Términos y condiciones del comercio hacia el cliente.

Términos y condiciones del comercio hacia el cliente.
El contenido de la página debe ser seguro y afianzado con un Certificado Digital HTTPS:
1. El contenido de la página debe ser seguro y afianzado con un Certificado Digital HTTPS:
2. El contenido de la página debe ser seguro y afianzado con un Certificado Digital HTTPS:
3. Algoritmo Hash de firma: SHA 256 o superior
4. Cifrado mínimo : AES 256 bits o superior
5. Clave pública: RSA 2048 bits
6. Protocolo de intercambio de claves: ECDH de 256 bits o superior
Tener dos ambientes de integración (Desarrollo y producción)
El proveedor de Web Host del sitio debe ser PCI DSS.
El sitio no debe tener Malware o HTML Spam.
La IP debe ser única y no debe alojar otros dominios.
El sitio web no debe alojar vínculos hacia otros sitios web considerados como dañinos.

Posterior al escaneo inicial, se efectuarán Escaneos mensuales donde se evaluarán los puntos de escaneo por primera vez, más cambios significativos realizados.

Actualización de Código para el Paso a Producción

Cambiar las URL de test (https://eu-test.oppwa.com) a producción (https://eu- prod.oppwa.com) en todos los métodos del API implementado en su portal web, también en el front-end (Javascript).
Eliminar el parámetro testMode=EXTERNAL de todos los métodos (transacciones y anulaciones, tokenización, etc.).

Eliminar el parámetro testMode=EXTERNAL de todos los métodos (transacciones y anulaciones, tokenización, etc.).

                                            
                                            curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);

Cambiar las credenciales de test a producción (Estas deben ser proporcionadas por DF).
1. ID de entidad
2. ID de entidad
Cambiar el MID y TID (Estas deben ser proporcionadas por DF).
1. MID
2. TID

Agregar imagen de certificación. Si no tiene JS entonces agregue esto debajo del formulario de pago(<form></form>)

                                        
                                        <script type="text/javascript">
                                        var wpwlOptions = {
                                           onReady: function() {
                                           var datafast= '<br/><br/><img src='+'"https://www.datafast.com.ec/images/verified.png"
                                           style='+'"display:block;margin:0 auto; width:100%;">';
                                           $('form.wpwl-form-card').find('.wpwl-button').before(datafast);
                                           },
                                        style: "card",locale: "es", labels: {cvv: "CVV", cardHolder: "Nombre(Igual que en la tarjeta)"}
                                        } 
                                        </script>

Una vez realizado esto, por favor enviar una captura de pantalla del botón ya que con este cambio, debe mostrarse el Powered by Datafast con la imagen de las marcas de tarjetas. Para ALIA, Datafast debe proporcionarle la instrucción para incluir el logo.

No realizar transacciones de prueba en producción sin coordinación de Datafast, una vez que se confirme la prueba con fecha y hora, se procederá a revisar y si todo está correcto se dará por terminado el proceso por medio de un correo electrónico, es importante nos comunique antes de realizar la primera y única transacción en producción sin importar la respuesta obtenida debido a que en este ambiente las reglas de prevención de fraude están activas y pueden bloquear el exceso de pruebas locales, adicional se recomienda un monto mínimo de $1.00 para dicha prueba.

Finalmente, una vez en producción cualquier consulta o requerimiento deberá ser canalizada a través de nuestra cuenta de correo servbdpago@datafast.com.ec

Preguntas Frecuentes

Glosario

¿Qué es el MID?

El MID (en sus siglas en inglés Merchant ID) es la identificación única de tu comercio según el producto contratado en Datafast, se lo ubica en el encabezado de los vouchers. El MID está compuesto por 12 dígitos numéricos que pueden empezar con 10, 20, 30, 70, 71, 72,73 o 99 finalizando con “00”.

¿Qué es el TID?

El TID (en sus siglas en inglés Terminal ID) es la identificación del dispositivo asignado a cada comercio. Se encuentra ubicado en el encabezado de los vouchers junto al MID y está compuesto por letras y números.

¿Qué es el Banco Adquirente?

El Banco Adquirente es la entidad encargada de depositar en la cuenta bancaria que designes todas las ventas que realices a través de nuestros productos.

¿Cuál es el nombre de mi Banco Adquirente?

El nombre de tu Banco Adquirente se encuentra en el encabezado de tus vouchers junto a la etiqueta "Adquirente".

¿Qué es un P.O.S?

El P.O.S o Point Of Sale, es un terminal electrónico que se asigna a cada comercio para el procesamiento de tarjetas de crédito o débito.

Tarjetas Permitidas

¿Con qué tarjetas se puede transaccionar en Datafast?

Con la red Datafast podrás realizar transacciones con todas las tarjetas de crédito y débito de las marcas más prestigiosas a nivel mundial, entre ellas: American Express, Diners Club, Discover, Mastercard y Visa.

Acreditaciones

¿Dónde depositan los valores de las ventas realizadas?

Las ventas realizadas se depositan en la cuenta bancaria que elijas, debe estar a tu nombre y en estado activo.

¿En cuánto tiempo se acredita el valor de las ventas realizadas?

El Banco Adquirente es quien procesa las acreditaciones de todas la transacciones realizadas. La fecha de acreditación dependerá de la frecuencia de pago establecida por cada emisor posterior a efectuarse el cierre de lote:

Banco Guayaquil
🕰 24 horas
💳 American Express, Mastercard y Visa

Banco del Pacífico
🕰 24 horas
💳 Mastercard y Visa

Banco Pichincha, Diners y Discover
🕰 Corriente: 48 horas
🗓 Diferido propio (diferido con intereses): 7 días
🗓 Plan pago especial (diferido sin inetereses): 7 días

Negociaciones especiales Banco Pichincha, Diners y Discover:
🗓 Diferido corriente: 14 y 29 de cada mes
🗓 Plan pago normal: 14 y 29 de cada mes

¿Con quién debo comunicarme si no han sido acreditadas mis ventas?

Comunícate con tu Banco Adquirente si los valores de las transacciones realizadas no han sido acreditados dentro de los plazos indicados.

Diferidos

¿Cómo puedo solicitar el incremento de los meses plazo de diferidos?

Para incrementar los meses plazo de diferidos debes solicitarlo con entidad bancaria.

¿Cómo se puedo diferir una transacción con meses de gracia?

Comunícate con el Banco emisor de la tarjeta con la que deseas aplicar el tipo de crédito meses de gracia para verificar que tu establecimiento cuente con la aprobación previo a la selección de diferidos especiales en tu dispositivo.

Comisión

¿Cuál es el valor de comisión que se cobra por realizar transacciones en Datafast?

La comisión o tarifa porcentual es un cobro que realiza el Banco Adquirente según el tipo de crédito y plazos seleccionados, acorde lo establecido por Resolución de la Junta Bancaria vigente.

¿Cuál es la comisión por ventas en diferido?

Conoce la tabla de factores de interés para transacciones con crédito diferido con intereses. Puedes descargar la tabla aquí.

¿Por qué las gasolineras cobran una tarifa de $0.20 cuando el pago se realiza con tarjeta de crédito o débito?

Por Resolución de la Junta Bancaria vigente, todo consumo de gasolina que se cancele con tarjeta de crédito o débito pagará una comisión de $0,20.

Retenciones

¿Se realizan retenciones de ley por cada transacción?

Si, el Banco Adquirente es el responsable de realizar las retenciones de ley sobre el monto vendido.

Actualización de datos

¿Qué se debe hacer si cambio el número de RUC de mi establecimiento?

Debes iniciar un nuevo proceso de contratación del servicio para registrar el nuevo RUC.

¿Qué se debe hacer si se realiza cambio de dirección, nombre comercial, nombre de la razón social y nombre del representante legal de mi negocio?

Completa el formulario de actualización de datos ingresando al siguiente link (URL) y envíalo vía e-mail a serviciosalcliente@datafast.com.ec con los siguientes documentos:

✅ Copia de Cédula de representante legal.
✅ Copia de papeleta de votación del representante legal.
✅ Copia de RUC.
✅ Copia de Nombramiento Actualizado (aplica solo para persona Jurídica).

Traslados de Equipos

¿Puedo trasladar un equipo de una sucursal a otra?

En la cláusula Segunda, literal "C" del contrato se detalla que los equipos no podrán ser transladados a otra dirección sin la autorización expersa de Datafast. En caso de requerir un equipo para otra sucursual se recomienda solicitar un equipo adicional.

Datamóvil

¿Cómo confirmo que mi equipo Datamóvil se encuentre cargado?

Presiona la tecla amarilla, si los 4 indicadores luminosos led se encienden de color azul tu dispositivo estará totalmente cargado. Si el 4to indicador se enciende de color naranja tu equipo no cuenta con batería, emitirá el mensaje “El lector tiene batería baja, por favor cárguelo”.

¿Cómo reconozco si mi equipo Datamóvil está conectado?

Cuando el equipo se encuentra conectada correctamente aparecerá el ícono de auriculares en la parte superior de la pantalla.

¿Qué debo hacer si en la pantalla me muestra un mensaje “Conecte lector (LT019)” y lo tengo conectado?

Verifica en la pantalla de tu celular o tablet si en la parte superior aparece el icono de auriculares, de ser así, desconecta el dispositivo por unos segundos y vuélvelo a conectar.
Si persiste la alerta, por favor reinicia el lector insertando un objeto fino en el orificio que se encuentra en la parte inferior izquierda del dispositivo y repit el proceso.

¿Qué debo hacer si el dispositivo DATAMÓVIL emite el mensaje “Favor reintente”?

El mensaje REINTENTE indica que la transacción está siendo analizada por un oficial de crédito, en este caso, espera 10 segundos y vuelve a realizar la transacción. Si el mensaje continúa, espera 10 segundos más para volver a realizar la transacción.
Este procedimiento se lo debe realizar máximo 3 veces, tiempo en el cual el oficial de crédito debe resolver la autorización o negación de la misma.

¿Qué dígitos debo ingresar si me pide PIN?

Si el teléfono solicita PIN, debes ingresar en el dispositivo Datamóvil los cuatro dígitos que normalmente ingresas en el cajero automático.

¿Qué debo hacer si no puedo continuar con la transacción?

Verifica que tu smartphone o tablet cuente con datos disponibles o conexión a una red Wi-Fi.

¿Cómo puedo desbloquear mi contraseña?

Espera 3 minutos para volver a ingresar tu contraseña, si el problema persiste comunícate con soporte técnico al 3730520 a nivel nacional o envía un mensaje de WhatsAPP con la palabra hola al 0999109000.

¿Cómo puedo recuperar mi contraseña?

Selecciona "Olvidó su contraseña" en la pantalla principal de la aplicación e ingresa tu usuario. Automáticamente recibirás un correo electrónico con una contraseña temporal para que realices el cambio de clave.

¿Cómo reenviar un voucher al cliente?

Ingresa en la opción “Operaciones” y seleccione la transacción deseada. En la pantalla superior derecha, presiona el ícono de un “sobre” e ingresa el correo electrónico del cliente.

¿Por cuánto tiempo es válido checkout.id?

El checkout.idexpira después de 30 minutos.

¿Qué sucede cuando se cierra una ventana emergente?

Algunos métodos de pago en Dataweb (COPYandPAY) permiten el pago en una ventana emergente/caja de luz. Cuando se muestra la ventana emergente, es posible realizar el pago o cerrarla. En caso de que se cierre la ventana emergente, es posible que el comprador continúe con su pago con otro método de pago, por ejemplo, elegir Masterpass, cambiar de opinión, cerrar la ventana emergente y luego pagar, por ejemplo, con una tarjeta de crédito.

¿Dataweb es compatible con 3D Secure?

Sí, los formularios de pago tienen 3D Secure incorporado. Para activar 3D Secure, se debe configurar el canal e ingresar una tarjeta registrada. Consulte la Guía 3-D Secure 2.x (https://datafast.docs.oppwa.com/tutorials/threeDSecure) para obtener más detalles.

¿Qué idiomas se admiten en el formulario de pago?

Por defecto hay 25: en, de, fr, es, it, nl, dk, fi, se, tr, ja, sl, pt, pl, cz, hu, bg, ro, ru, cn, gr, no, sk, ar, ko. Pero es posible cambiar el valor de texto de las etiquetas a cualquier cosa que elija utilizando la API de wpwlOptions.

¿Qué es la selección activa de métodos de pago (APMS)?

La selección activa de métodos de pago le permite ofrecer de forma dinámica diferentes marcas de pago según el perfil de riesgo de cada comprador individual. Con esta integración puede: - Ofrecer la combinación perfecta de métodos de pago locales - Dirigir la selección de pagos de forma activa y en tiempo real durante el pago - Optimizar la gestión de riesgos según los requisitos comerciales de cada tienda

¿Qué sucede si un comprador cierra su navegador?

Si un comprador cierra su navegador después de seleccionar el método de pago pero antes de ejecutar el pago, puede causar problemas de conciliación ya que su plataforma nunca recibirá el estado final del pago. Por esta razón, llamamos automáticamente a shopperResultUrl si no ha sido llamado después de 29 minutos. De esta forma tu plataforma puede solicitar el estado final, siendo notificado que el pago no fue procesado. Se enviará una notificación desde la puerta de enlace a la tienda para activar el estado de obtención antes de que se agote el tiempo de espera de la identificación de pago, pero solo después de hacer clic en el botón "pagar ahora" en el widget de pago.

Técnicamente, si se llamó a POST /checkouts/{id}/pago y no se llamó a GET /checkouts/{id}/pago, OPP envía una solicitud GET a shopperResultUrl con un parámetro resourcePath, sugiriendo al comerciante que llame a GET /checkouts/ {id}/pago. Lo mismo se aplica a /checkouts/{id}/registro.

IMPORTANTE: la baseUrl debe terminar en "/", por ejemplo, "https://test.oppwa.com/".

¿Dataweb es compatible con el diseño web responsivo?

Sí, Dataweb en OPP es compatible con el diseño receptivo

¿Qué navegadores son compatibles con Dataweb?

Todos los navegadores actuales son compatibles. También nos encargamos de que los navegadores más antiguos que todavía están en uso sean compatibles. El único navegador donde esto significa limitaciones son las versiones anteriores de Internet Explorer. Allí probamos la funcionalidad para versiones >= 11. Incluya la siguiente metatag en su fuente html.

                                                              
                                                                <meta http-equiv="X-UA-Compatible" content="IE=edge">

¿Se podría usar Dataweb como un widget independiente?

Sí, y varios clientes lo están usando de esa manera.

¿Por qué debo usar Dataweb y no mis propios formularios?

Este botón fue la primera solución de formulario de pago certificada PCI 3 SAQ-A disponible en el mercado.

Ofrece una gran variedad de características versátiles. Si bien es muy fácil de integrar en una página web con solo dos líneas de código, varios casos de uso están disponibles y son compatibles al mismo tiempo.

Dataweb se ve bonito y simple, pero tengo mis propios diseños de tienda. ¿Cómo puedo adaptarlo a mi diseño?

Revisa nuestra Guía de personalización.

Esto presenta un editor interactivo donde puede probar cualquier estilo de la referencia de estilo en la misma página.
Los campos de entrada en el widget generan su propia etiqueta de formulario HTML
El widget puede cargarse dentro de una etiqueta de formulario existente (pago), que ya no es un código HTML válido. Por lo tanto, los campos no serán enviados. Asegúrese de eliminar el widget adicional y el pago con tarjeta de crédito debería funcionar.

¿Cómo puedo validar el nombre del titular de la tarjeta?

Esto se puede hacer usando el siguiente script java El script Java realiza la validación pero no está conectado a ninguna configuración en BIP.

                                                              
                                                                var wpwlOptions = {
                                                                    estilo:"tarjeta",
                                                                    onBeforeSubmitCard: function(e){
                                                                        var titular = $('.wpwl-control-cardHolder').val();
                                                                        if (titular.trim().longitud < 2)    {
                                                                            $('.wpwl-control-cardHolder').addClass('wpwl-has-error').after('<div class="wpwl-hint wpwl-hint-cardHolderError">Titular de la tarjeta no válido</div>') ;
                                                                            falso retorno;
                                                                        }
                                                                        devolver verdadero;
                                                                    }
                                                                }

¿Por qué no carga el formulario del botón de pagos si se está enviando correctamente los parámetros?

Puede que exista alguna restricción a nivel de acceso del servidor hacia internet, se recomienda revisar las reglas de salida, adicional usar las herramientas de desarrolladores de Google para verificar que la siguiente línea este correcta. Este puede ser en ambiente de pruebas o en producción

                                                            
                                                            (function(){

                                                                var hasClass = function (elem, clsName){
                                                                    if(elem.className){
                                                                        return (' ' + elem.className + ' ').indexOf(' ' + clsName + ' ') > -1;
                                                                    }
                                                                    return false;
                                                                }
                                                            
                                                                var getPaymentWidgetsForm = function (){
                                                                    var forms = document.forms;
                                                                    for (var index = 0; index < forms.length; ++index) {
                                                                        var form = forms[index];
                                                                        if(hasClass(form, 'paymentWidgets')){
                                                                            return form;
                                                                        }
                                                                    }
                                                                    return null;
                                                                }
                                                            
                                                                var timestamp = new Date().toUTCString();
                                                                var ndc = 'ff74e27bc8404422ae159a9f19e5a114';
                                                                var errorDetail = "checkoutId 669740A464B8C14A15A81D23DE02F918.prod02-vm-tx16\"><\/script> is invalid";
                                                            
                                                                setTimeout(function() {
                                                                    var paymentForm = getPaymentWidgetsForm();
                                                                    if(paymentForm != null) {
                                                                        var contentHtml = ['Payment cannot be completed.',
                                                                                    'Please contact support with following information:', '<span></span>',
                                                                                    'ndc: ' + ndc, 'timestamp: ' + timestamp].join('<br />');
                                                                        var errorDivHtml = ['<div class="wpwl-message wpwl-has-error" style="color: #a94442;">',
                                                                            contentHtml ,'</div>'].join('');
                                                                        paymentForm.innerHTML = errorDivHtml;
                                                                        var spanElement = paymentForm.getElementsByTagName('span')[0];
                                                                        spanElement.innerText = errorDetail;
                                                                    }
                                                                }, 1);
                                                            }());

Si no se generó el checkoutId, entonces se mostrará vacío y no mostrará el formulario

                                                            
                                                            {  "result":{    
                                                                    "code":"200.300.406",    
                                                                    "description":"Page not found",    
                                                                    "timestamp":"2022-07-13 19:50:42"  
                                                                },  
                                                                    "buildNumber":"20141216-153400.r1.static", 
                                                                    "ndc":"l1jc1rrvfel3kwoqn50uioadp82ir6oo"
                                                            }

Change Log

Abril 11, 2022

Andrés Flores

3.2

UpdateCambio de ENDPOINT del Gateway de pagos tanto en producción como en ambiente de prueba por motivos de desactivación del anterior.

Octubre 11, 2021

Andrés Flores

3.1.1

NewSe agrega código nuevo de respuesta asociado a la cancelación de transacción de tipo OTP (800.100.152).

UpdateSe cambió el Título de la sección 3.1.3 por "Obtener el estado de la transacción"

Julio 22, 2021

Andrés Flores

3.1

NewNueva mensajería 3DS / OTP como segundo factor de autenticación.

UpdateActualización de imágenes de ejemplos de código(Anulación / Tokenización / Verificador)

Julio 08, 2020

Andrés Flores

3.0

Nueva versión que incluye:

NewNuevos parámetros de envío de información.

NewNuevas validaciones en cálculos de impuestos.

UpdateMejoras en texto de mensajería de respuesta de las transacciones.

UpdateEliminación de campos SHOPPER_interes / SHOPPER_gracia

NewNuevo método de anulación

NewNuevo parámetro para tipos de crédito.

SandBox

Generar CheckouId

Código básico en lenguaje PHP, función para obtener el CheckoutId.

                                        
                                        function request() { 
                                           $url = "https://eu-test.oppwa.com/v1/checkouts"; 
                                           $data = "entityId=8a8294175f113aad015f11652f2200a5".
                                           "&amount=1.12".
                                           "&currency=USD".
                                           "&paymentType=DB".
                                           "&customParameters[SHOPPER_MID]=1000000505".
                                           "&customParameters[SHOPPER_TID]=PD100406".
                                           "&customParameters[SHOPPER_PSERV]=17913101".
                                           "&risk.parameters[USER_DATA2]=Sismetic".
                                           "&customParameters[SHOPPER_VAL_BASE0]=0.00".
                                           "&customParameters[SHOPPER_VAL_BASEIMP]=1.00".
                                           "&customParameters[SHOPPER_VAL_IVA]=0.12".
                                           "&customParameters[SHOPPER_VERSIONDF]=2".
                                           "&merchantTransactionId=21112024_0138216822556".
                                           "&customer.merchantCustomerId=999999".
                                           "&testMode=EXTERNAL"; 
                                           $ch = curl_init(); 
                                           curl_setopt($ch, CURLOPT_URL, $url); 
                                           curl_setopt($ch, CURLOPT_HTTPHEADER, array('Authorization:Bearer OGE4Mjk0MTg1YTY1YmY1ZTAxNWE2YzhjNzI4YzBkOTV8YmZxR3F3UTMyWA==')); 
                                           curl_setopt($ch, CURLOPT_POST, 1); 
                                           curl_setopt($ch, CURLOPT_POSTFIELDS, $data); 
                                           curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);// this should be set to true in production 
                                           curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); 
                                           $responseData = curl_exec($ch); 
                                           if(curl_errno($ch)) { 
                                               return curl_error($ch); 
                                           } 
                                           curl_close($ch); 
                                           return $responseData; 
                                        }

Código básico en lenguaje JAVA, función para obtener el CheckoutId.

                                        
                                        private String request() throws IOException {
                                           URL url = new URL("https://eu-test.oppwa.com/v1/checkouts");
                                           HttpsURLConnection conn = (HttpsURLConnection) url.openConnection();
                                           conn.setRequestMethod("POST");
                                           conn.setRequestProperty("Authorization", "Bearer OGE4Mjk0MTg1YTY1YmY1ZTAxNWE2YzhjNzI4YzBkOTV8YmZxR3F3UTMyWA==");
                                           conn.setDoInput(true);
                                           conn.setDoOutput(true);
                                           String data = "entityId=8a8294175f113aad015f11652f2200a5"
                                           + "&amount=1.12"
                                           + "&currency=USD"
                                           + "&paymentType=DB"
                                           + "&customParameters[SHOPPER_MID]=1000000505"
                                           + "&customParameters[SHOPPER_TID]=PD100406"
                                           + "&customParameters[SHOPPER_PSERV]=17913101"
                                           + "&risk.parameters[USER_DATA2]=Sismetic"
                                           + "&customParameters[SHOPPER_VAL_BASE0]=0.00"
                                           + "&customParameters[SHOPPER_VAL_BASEIMP]=1.00"
                                           + "&customParameters[SHOPPER_VAL_IVA]=0.12"
                                           + "&customParameters[SHOPPER_VERSIONDF]=2"
                                           + "&merchantTransactionId=21112024_0138216822556"
                                           + "&customer.merchantCustomerId=999999"
                                           + "&testMode=EXTERNAL"; 
                                           DataOutputStream wr = new DataOutputStream(conn.getOutputStream());
                                           wr.writeBytes(data);
                                           wr.flush();
                                           wr.close();
                                           int responseCode = conn.getResponseCode();
                                           InputStream is;
                                           if (responseCode >= 400) is = conn.getErrorStream();
                                           else is = conn.getInputStream();
                                           return IOUtils.toString(is);
                                        }

Código básico en lenguaje C#, función para obtener el CheckoutId

                                        
                                        public Dictionary <string, dynamic> Request() {
                                           Dictionary<string, dynamic> responseData;
                                           string data="entityId=8a8294175f113aad015f11652f2200a5"+
                                           "&amount=1.12" +
                                           "&currency=USD" +
                                           "&paymentType=DB"+
                                           "&customParameters[SHOPPER_MID]=1000000505"+
                                           "&customParameters[SHOPPER_TID]=PD100406"+
                                           "&customParameters[SHOPPER_PSERV]=17913101"+
                                           "&risk.parameters[USER_DATA2]=Sismetic"+
                                           "&customParameters[SHOPPER_VAL_BASE0]=0.00"+
                                           "&customParameters[SHOPPER_VAL_BASEIMP]=1.00"+
                                           "&customParameters[SHOPPER_VAL_IVA]=0.12"+
                                           "&customParameters[SHOPPER_VERSIONDF]=2"+
                                           "&merchantTransactionId=21112024_0138216822556"+
                                           "&customer.merchantCustomerId=999999"+
                                           "&testMode=EXTERNAL"; 
                                           string url = "https://eu-test.oppwa.com/v1/checkouts";
                                           byte[] buffer = Encoding.ASCII.GetBytes(data);
                                           HttpWebRequest request = (HttpWebRequest)HttpWebRequest.Create(url);
                                           request.Method = "POST";
                                           request.Headers["Authorization"] = "Bearer OGE4Mjk0MTg1YTY1YmY1ZTAxNWE2YzhjNzI4YzBkOTV8YmZxR3F3UTMyWA====";
                                           request.ContentType = "application/x-www-form-urlencoded";
                                           Stream PostData = request.GetRequestStream();
                                           PostData.Write(buffer, 0, buffer.Length);
                                           PostData.Close();
                                           using (HttpWebResponse response = 
                                           (HttpWebResponse)request.GetResponse())
                                           {
                                              Stream dataStream = response.GetResponseStream();
                                              StreamReader reader = new StreamReader(dataStream);
                                              var s = new JavaScriptSerializer();
                                              responseData = s.Deserialize<Dictionary<string, dynamic>>(reader.ReadToEnd());
                                              reader.Close();
                                              dataStream.Close();
                                           } return responseData;
                                        }

Código básico en lenguaje Python, función para obtener el CheckoutId.

                                        
                                        import urllib, urllib2, json 
                                        def request():
                                         url = "https://eu-test.oppwa.com/v1/checkouts"
                                         data = {
                                            'entityId':'8a8294175f113aad015f11652f2200a5',
                                            'amount':'1.12',
                                            'currency':'USD',
                                            'paymentType':'DB',
                                            'customParameters[SHOPPER_MID]':'1000000505',
                                            'customParameters[SHOPPER_TID]':'PD100406',
                                            'customParameters[SHOPPER_PSERV]':'17913101',
                                            'risk.parameters[USER_DATA2]':'Sismetic',
                                            'customParameters[SHOPPER_VAL_BASE0]':'0.00',
                                            'customParameters[SHOPPER_VAL_BASEIMP]':'1.00',
                                            'customParameters[SHOPPER_VAL_IVA]':'0.12',
                                            'customParameters[SHOPPER_VERSIONDF]':'2',
                                            'merchantTransactionId':'21112024_0138216822556',
                                            'customer.merchantCustomerId':'999999',
                                            'testMode':'EXTERNAL' 
                                         }
                                         try:
                                          opener = urllib2.build_opener(urllib2.HTTPHandler)
                                          request = urllib2.Request(url, data=urllib.urlencode(data))
                                          request.add_header('Authorization', 'Bearer OGE4Mjk0MTg1YTY1YmY1ZTAxNWE2YzhjNzI4YzBkOTV8YmZxR3F3UTMyWA==')
                                          request.get_method = lambda: 'POST'
                                          response = opener.open(request)
                                          return json.loads(response.read());
                                         except urllib2.HTTPError as e:
                                          return e.code;

Código básico en lenguaje Node.js, función para obtener el CheckoutId.

                                        
                                    var https = require('https');
                                    var querystring = require('querystring');
                                    function request(callback) {
                                       var path='/v1/checkouts';
                                       var data = querystring.stringify( { 
                                          'entityId':'8a8294175f113aad015f11652f2200a5',
                                          'amount':'1.12',
                                          'currency':'USD',
                                          'paymentType':'DB',
                                          'customParameters[SHOPPER_MID]':'1000000505',
                                          'customParameters[SHOPPER_TID]':'PD100406',
                                          'customParameters[SHOPPER_PSERV]':'17913101',
                                          'risk.parameters[USER_DATA2]':'Sismetic',
                                          'customParameters[SHOPPER_VAL_BASE0]':'0.00',
                                          'customParameters[SHOPPER_VAL_BASEIMP]':'1.00',
                                          'customParameters[SHOPPER_VAL_IVA]':'0.12',
                                          'customParameters[SHOPPER_VERSIONDF]':'2',
                                          'merchantTransactionId':'21112024_0138216822556',
                                          'customer.merchantCustomerId':'999999',
                                          'testMode':'EXTERNAL' 
                                       });
                                       var options = {
                                          port: 443,
                                          host: 'https://eu-test.oppwa.com',
                                          path: path,
                                          method: 'POST',
                                          headers: {
                                          'Content-Type': 'application/x-www-form-urlencoded',
                                          'Content-Length': data.length,
                                          'Authorization':'Bearer OGE4Mjk0MTg1YTY1YmY1ZTAxNWE2YzhjNzI4YzBkOTV8YmZxR3F3UTMyWA=='
                                          }
                                       };
                                       var postRequest = https.request(options, function(res)
                                          res.setEncoding('utf8');
                                          res.on('data', function (chunk) {
                                           jsonRes = JSON.parse(chunk);
                                           return callback(jsonRes);
                                          });
                                       });
                                       postRequest.write(data);
                                       postRequest.end();
                                    }
                                    request(function(responseData) {
                                       console.log(responseData);
                                    });

Código básico en VB.net, función para obtener el CheckoutId

                                        
                                        Public Function Request() As Dictionary(Of String, Object) 
                                           Dim url As String = "https://eu-test.oppwa.com/v1/checkouts"
                                           Dim data As String = "entityId=8a8294175f113aad015f11652f2200a5" +
                                           "&amount=1.12" +
                                           "&currency=USD" +
                                           "&paymentType=DB" +
                                           "&customParameters[SHOPPER_MID]=1000000505" +
                                           "&customParameters[SHOPPER_TID]=PD100406" +
                                           "&customParameters[SHOPPER_PSERV]=17913101" +
                                           "&risk.parameters[USER_DATA2]=Sismetic" +
                                           "&customParameters[SHOPPER_VAL_BASE0]=0.00" +
                                           "&customParameters[SHOPPER_VAL_BASEIMP]=1.00" +
                                           "&customParameters[SHOPPER_VAL_IVA]=0.12"+
                                           "&customParameters[SHOPPER_VERSIONDF]=2"+
                                           "&merchantTransactionId=21112024_0138216822556"+
                                           "&customer.merchantCustomerId=999999"+
                                           "&testMode=EXTERNAL"
                                           Dim req As WebRequest = WebRequest.Create(url)
                                           req.Method = "POST"
                                           req.Headers.Add("Authorization", "Bearer OGE4Mjk0MTg1YTY1YmY1ZTAxNWE2YzhjNzI4YzBkOTV8YmZxR3F3UTMyWA==")
                                           req.ContentType = "application/x-www-form-urlencoded"
                                           Dim byteArray As Byte() = Encoding.UTF8.GetBytes(data)
                                           req.ContentLength = byteArray.Length
                                           Dim dataStream As Stream = req.GetRequestStream()
                                           dataStream.Write(byteArray, 0, byteArray.Length)
                                           dataStream.Close()
                                           Dim res As WebResponse = req.GetResponse()
                                           Dim resStream = res.GetResponseStream()
                                           Dim reader As New StreamReader(resStream)
                                           Dim response As String = reader.ReadToEnd()
                                           reader.Close()
                                           resStream.Close()
                                           res.Close()
                                           Dim jss As New System.Web.Script.Serialization.JavaScriptSerializer()
                                           Dim dict As Dictionary(Of String, Object) = jss.Deserialize(Of Dictionary(Of
                                           String, Object))(response)
                                           Return dict
                                        End Function

Generar CheckoutId

Authorization :

Generar Boton de Pagos

Ver estado de la transacción

Código básico en PHP, función de comprobación del estado de la transacción. Previamente ya se ha obtenido el parámetro $resourcePath basado en la URL en el atributo action del tag FORM

                                        
                                        function request() {
                                           $url = "https://eu-test.oppwa.com/v1/checkouts/{id}/payment";
                                           $url .= "?entityId=8a8294175f113aad015f11652f2200a5";
                                           $ch = curl_init();
                                           curl_setopt($ch, CURLOPT_URL, $url);
                                           curl_setopt($ch, CURLOPT_HTTPHEADER, array('Authorization:Bearer OGE4Mjk0MTg1YTY1YmY1ZTAxNWE2YzhjNzI4YzBkOTV8YmZxR3F3UTMyWA=='));
                                           curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'GET');
                                           curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);// this should be set to true in production
                                           curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
                                           $responseData = curl_exec($ch);
                                           if(curl_errno($ch)) {
                                              return curl_error($ch);
                                           }
                                           curl_close($ch);
                                           return $responseData;
                                        }

Código básico en JAVA, función de comprobación del estado de la transacción. Previamente ya se ha obtenido el parámetro String resourcePath basado en la URL en el atributo action del tag FORM

                                            
                                           private String request() throws IOException {
                                             URL url = new URL("https://eu-test.oppwa.com/v1/checkouts/{id}/payment?entityId=8a8294175f113aad015f11652f2200a5");
                                             HttpsURLConnection conn = (HttpsURLConnection) url.openConnection();
                                             conn.setRequestMethod("GET");
                                             conn.setRequestProperty("Authorization", "Bearer OGE4Mjk0MTg1YTY1YmY1ZTAxNWE2YzhjNzI4YzBkOTV8YmZxR3F3UTMyWA==");
                                             int responseCode = conn.getResponseCode();
                                             InputStream is;
                                             if (responseCode >= 400) is = conn.getErrorStream();
                                             else is = conn.getInputStream();
                                             return IOUtils.toString(is);    
                                            }

Código básico en C#, función de comprobación del estado de la transacción. Previamente ya se ha obtenido el parámetro String resourcePath basado en la URL en el atributo action del tag FORM

                                        
                                        public Dictionary<string, dynamic> Request() { 
                                         Dictionary<string, dynamic> responseData;string data="entityId=8a8294175f113aad015f11652f2200a5";
                                         string url = "https://eu-test.oppwa.com/v1/checkouts/{id}/payment?" + data;
                                         HttpWebRequest request = (HttpWebRequest)HttpWebRequest.Create(url);
                                         request.Method = "GET";
                                         request.Headers["Authorization"] = "Bearer OGE4Mjk0MTg1YTY1YmY1ZTAxNWE2YzhjNzI4YzBkOTV8YmZxR3F3UTMyWA==";
                                         using (HttpWebResponse response = 
                                         (HttpWebResponse)request.GetResponse())
                                         {
                                            Stream dataStream = response.GetResponseStream();
                                            StreamReader reader = new StreamReader(dataStream);
                                            var s = new JavaScriptSerializer();
                                            responseData = s.Deserialize<Dictionary<string, dynamic>>(reader.ReadToEnd());
                                            reader.Close();
                                            dataStream.Close();
                                         }
                                         return responseData;
                                        }

Código básico en Python, función de comprobación del estado de la transacción. Previamente ya se ha obtenido el parámetro String resourcePath basado en la URL en el atributo action del tag FORM

                                        
                                        import urllib, urllib2, json def request():
                                           url = "https://eu-test.oppwa.com/v1/checkouts/{id}/payment"
                                           url += '?entityId=8a8294175f113aad015f11652f2200a5'
                                           try:
                                              opener = urllib2.build_opener(urllib2.HTTPHandler)
                                              request = urllib2.Request(url, data='')
                                              request.add_header('Authorization', 'Bearer OGE4Mjk0MTg1YTY1YmY1ZTAxNWE2YzhjNzI4YzBkOTV8YmZxR3F3UTMyWA==')
                                              request.get_method = lambda: 'GET'
                                              response = opener.open(request)
                                              return json.loads(response.read());
                                              except urllib2.HTTPError, e:
                                              return e.code;

                                        
                                        var https = require('https'); 
                                           var querystring = require('querystring');
                                           function request(callback) {
                                              var path='/v1/checkouts/{id}/payment';
                                              path += ?entityId=8a8294175f113aad015f11652f2200a5';
                                              var options = {
                                               port: 443,
                                               host: 'https://eu-test.oppwa.com',
                                               path: path,
                                               method: 'GET',
                                               headers: {
                                               'Authorization':'Bearer OGE4Mjk0MTg1YTY1YmY1ZTAxNWE2YzhjNzI4YzBkOTV8YmZxR3F3UTMyWA=='
                                               }
                                              };
                                           var postRequest = https.request(options, function(res)
                                        {
                                              res.setEncoding('utf8');
                                              res.on('data', function (chunk) {
                                               jsonRes = JSON.parse(chunk);
                                               return callback(jsonRes);
                                              });
                                           });
                                           postRequest.end();
                                        }
                                        request(function(responseData) {
                                           console.log(responseData);
                                        });

Código básico en VB.net, función de comprobación del estado de la transacción. Previamente ya se ha obtenido el parámetro String resourcePath basado en la URL en el atributo action del tag FORM

                                        
                                        Public Function Request() As Dictionary(Of String, Object) 
                                           Dim url As String = "https://eu-test.oppwa.com/v1/checkouts/{id}/payment" +
                                           "?entityId=8a8294175f113aad015f11652f2200a5"
                                           Dim req As WebRequest = WebRequest.Create(url)
                                           req.Method = "GET"
                                           req.Headers.Add("Authorization", "Bearer OGE4Mjk0MTg1YTY1YmY1ZTAxNWE2YzhjNzI4YzBkOTV8YmZxR3F3UTMyWA==")
                                           req.ContentType = "application/x-www-form-urlencoded"
                                           Dim res As WebResponse = req.GetResponse()
                                           Dim resStream = res.GetResponseStream()
                                           Dim reader As New StreamReader(resStream)
                                           Dim response As String = reader.ReadToEnd()
                                           reader.Close()
                                           resStream.Close()
                                           res.Close()
                                           Dim jss As New System.Web.Script.Serialization.JavaScriptSerializer()
                                           Dim dict As Dictionary(Of String, Object) = jss.Deserialize(Of Dictionary(Of 
                                           String, Object))(response)
                                           Return dict
                                        End Function
                                        responseData = Request()("result")("description")

Ver estado de la transacción

Authorization :

Id de la transacción :

Entity Id:

Navegación

Introducción

Dataweb

Front-end

Back-end (Tecnologías)

Certificados

Ejemplos

Plugins

Transacciones y Monto

Esquema de Seguridad

Validación de Conexión al Gateway

Fases de Integración

Fase uno

Identificador de Pago (CheckoutId)

Formulario de Pago

Estado de Transacción

Fase dos

Nuevos Campos

Nombre

Segundo Nombre

Apellido

Dirección IP

Identificador del Cliente en el Comercio

Número de Transacción

Dirección de Correo Electrónico

Documento de Identificación del Usuario

Datos del producto

Teléfono del Cliente

Dirección de entrega

Dirección del Cliente

País de entrega

País del Cliente

Modo de Prueba

Parámetros Personalizados

Datos de Impuestos

% Base 0 (variable)

% Base imponible (variable)

Valor de impuesto (variable)

Ejemplo de compra

Datos del comercio (MID Y TID)

Datos de identificación

Identificador de Seguridad

Identificador del proveedor

Risk Parameters

Código de Mensajes

Códigos Generales

Códigos de Mensajes Detallados

Aprobación de la transacción (Banco adquirente)

Rechazo de la Transacción (Respuestas del Banco)

Opciones Avanzadas

Diferidos

Tipo de Crédito

Validación campos vacíos

Estilo del formulario

Optimización Móvil

Habilitar el diseño responsivo en el HTML

Mobile First (CSS)

Botones y Campos de texto (CSS)

OneclickCheckout (Pago con un click)

Preparación del pago

Eliminación del Token

Anulaciones

Otros Métodos de Integración

Personalización

Verificador de Transacciones

Verificar por identificador de la transacción

Verificar por el número de transacción del comercio

Paso a Producción

Ejemplos

PHP

Java

C#

Python

Node.js

Ejemplo Visual Basic.Net

Comprobación de Conectividad con el gateway de pagos

Requerimientos Tecnicos

Actualización de Código para el Paso a Producción

Preguntas Frecuentes

Change Log