Botón de pago e-Commerce

Módulo de integración del boton de pago e-Commerce

1 Transacción de pago

1.1 Descripción

Una transacción de pago corresponde a la solicitud de autorización de pago con Amipass, en donde quien realiza el pago, ingresa al sitio eCommerce, selecciona uno o mas productos, y el ingreso de los datos de pago, lo realiza de forma segura en el Botón de Pago de Amipass.

El flujo de páginas para la transacción es el siguiente:

1.2 Secuencia de pago

A continuación, se muestra el flujo que corresponde a la secuencia de pago entre el comercio socio de Amipass, comercio electrónico y botón de pago Amipass.

• El comercio inicia una transacción de pago, invocando el método de inicio de transacción.

• Botón de pago Amipass procesa el requerimiento y entrega como resultado de la operación el token de transacción y la url de redireccionamiento.

• Comercio redirecciona al botón de pago, con la URL generada al iniciar la transacción.

• El navegador Web realiza una petición HTTPS a botón de pago Amipass, en base al redireccionamiento generado.

• Botón de pago responde a la solicitud HTTPS desplegando el formulario de pago HTML, previa validación del token de inicio de transacción. Desde este punto, la comunicación es entre botón de pago y el cliente Amipass, sin interferir el comercio. El formulario de pago de Amipass despliega entre otras cosas el monto de la transacción.

• El usuario Amipass ingresa los datos de pago, código QR generado a través de la app amiPass y Rut del usuario, luego presiona el botón pagar en el formulario.

• Botón de pago procesa la solicitud de autorización (Se transfiera la petición al autorizador del BackOffice)

• Una vez resuelta la autorización, Botón de pago despliega la página de éxito o de error según sea el caso, luego retorna el control al comercio, a la url de éxito o de fracaso, realizando un redireccionamiento HTTP/HTTPS hacia la página de transición del comercio, en donde se envía por método POST la información de pago que entrego el autorizador al aceptar la transacción.

2 Método de implementación

A continuación, se detalla por tabla los métodos necesarios para el funcionamiento del botón de pago Amipass.

2.1 Api de Integración: Inicio de transacción de pago

{
    "usuarioPay": 1028909,
    "idLocal": 909,
    "idPedido": "14234561234511167",
    "monto": 1,
    "urlExito": "http://www.tucomercio.cl/success",
    "urlFracaso": "http://www.tucomercio.cl/error",
    "typePay": "Decrypt",
    "rut": "12412878-1",
    "email": "alvgutierr@gmail.com"
}

curl --location 'https://intecommerce.amipassqa.com/API_Ecommerce/ServicesInit/toInit' \
--header 'Authorization: Basic 1028901' \
--header 'Content-Type: application/json' \
--data-raw '{
    "usuarioPay": 1028909,
    "idLocal": 909,
    "idPedido": "14234561234511167",
    "monto": 1051,
    "urlExito": "http://www.tucomercio.cl/success",
    "urlFracaso": "http://www.tucomercio.cl/error",
    "typePay": "Decrypt",
    "rut": "12412878-1",
    "email": "alvgutierr@gmail.com"
}'

Body HTTP

Ejemplo

Ejemplo con sToken

2.2 Api de Integración: Validación

https://ecommerce.amipass.com/API_Ecommerce/ServicesValid/toValid?token=F78B55625&idpayment=36&idPedido=12345678

Parametros URL

Ejemplo

2.3 Api de Integración: Servicio de Anulación

{
    "NumeroTransaccion": "202711",
    "Rut": "124128781",
    "UsuarioPay": "1028909",
    "codLocal": "909",
    "monto": 1047,
    "codPromocion": ""
}

curl --location --request PUT 'https://intecommerce.amipassqa.com/API_Ecommerce/ServicesNullify/toNullify' \
--header 'Authorization: Basic 1028901' \
--header 'Content-Type: application/json' \
--data '{
    "NumeroTransaccion": "202711",
    "Rut": "124128781",
    "UsuarioPay": "1028909",
    "codLocal": "909",
    "monto": 1047,
    "codPromocion": ""
}'

Body HTTP

Ejemplo

Header:

2.4 Api de Integración: Servicio de Reversa

{
    "usuarioPay": 1028909,
    "idLocal": 909,
    "idPedido": "14234561234511167",
    "monto": 1051,
    "urlExito": "http://www.tucomercio.cl/success",
    "urlFracaso": "http://www.tucomercio.cl/error",
    "typePay": "Decrypt",
    "rut": "12412878-1",
    "email": "alvgutierr@gmail.com"
}

curl --location 'https://intecommerce.amipassqa.com/API_Ecommerce/ServicesReverse/toReverse' \
--header 'Authorization: Basic 1028901' \
--header 'Content-Type: application/json' \
--data-raw '{
    "usuarioPay": 1028909,
    "idLocal": 909,
    "idPedido": "14234561234511167",
    "monto": 1051,
    "urlExito": "http://www.tucomercio.cl/success",
    "urlFracaso": "http://www.tucomercio.cl/error",
    "typePay": "Decrypt",
    "rut": "12412878-1",
    "email": "alvgutierr@gmail.com"
}'

Body HTTP

Ejemplo

Header:

3 Como generar un código QR

1. Ingrese a: https://intsocios.amipassqa.com/login.aspx

◦ Usuario/RUT: 12412878-1/ clave: 2019


2. En el menú de la izquierda seleccione la opción “Modo móvil”

3. Ingrese a la opción “Pago Smartphone”

4. Ingrese monto (Ej. 100)

5. Ingrese clave: 1674

6. La aplicación mostrará el código QR que necesitamos para realizar el Pago, junto con el usuario (RUT):

Integracion con cajas y totem

La API de Amipass es un conjunto de interfaces HTTP para integrar el punto de venta comercio con AMIPASS. Las API reciben los parámetros de entrada por medio de método GET y la respuesta es en formato JSON.

Vías de Acceso

Ambiente productivo

Ambiente Integración

• El Token es individual por razón social del comercio
• Cada local debe tener un código identificador

Venta

Permite realizar una venta basada en un monto pre aprobado por el cliente.

El cliente comienza el pago desde su APP de Amipass en su Smartphone:

1. Ingresa a Pago Smartphone
2. Ingresa monto
3. Ingresa su clave de pago
4. La aplicación genera un código y su representación en QR

El código es ingresado al punto de venta (por lectura de QR o digitado) por parte del cajero.

5. El punto de venta se conecta a la API Amipass para solicitar la aprobación de la transacción.

PAYPAP

{
'CodRespuesta':'1',
'DesRespuesta':'APROBADO',
'CodAutorizacionz':'5270496',
'Fecha':'2016-09-06 17:05:04.210',
'Monto':'1000',
'TokenAN':'465464'
}

Llamada

Parametros de entrada

Ejemplo

Parametros de salida

Codigos de Respuesta

Los códigos de respuesta de una transacción de venta son los siguientes. Los códigos que sean iguales o mayores a 10 son restricciones propias de la empresa para un empleado. Solamente las transacciones que respondan con código 1 son las transacciones aprobadas.

Generar Código QR

Private Sub btnTestPay_Click(sender As Object, e As EventArgs)
    Dim sCodigoQR = "78411803"
    Dim sMonto = "0"
    Dim sCodLocal = "6665590"
    CallAmipassPay(sCodigoQR, sMonto, sCodLocal)
End Sub

Private Sub CallAmipassPay(sCodigoQR As String, sMonto As String, sCodLocal As String, sPromo as string)

    Dim TokenAutenticacion = "1028938"
    Dim respuesta = ""

    Dim sParametros As String = String.Format("?NumeroTransaccion={0}&Monto={1}&CodLocal={2}&CodPromocion={3}", sCodigoQR, sMonto, sCodLocal, sPromo)
    Dim url As String = Convert.ToString("https://intpay.amipassqa.com/wspay/PayPAP") & sParametros
    Dim request As HttpWebRequest = DirectCast(HttpWebRequest.Create(New Uri(url)), HttpWebRequest)
    request.ContentType = "application/json"
    request.Headers("Authorization") = String.Format("Basic {0}", TokenAutenticacion)
    Using response As WebResponse = request.GetResponse()
        Using stream As New StreamReader(response.GetResponseStream())
            Dim content = stream.ReadToEnd()
            respuesta = JsonConvert.DeserializeObject(Of String)(content)
        End Using
    End Using
    Dim resp As RespuestaTransaccionPA = JsonConvert.DeserializeObject(Of RespuestaTransaccionPA)(respuesta)
    If resp.CodRespuesta = "1" Then
        'Venta Aprobada
    Else
        'Venta Rechazada
    End If
End Sub
Public Class RespuestaTransaccionPA
    Public CodRespuesta As String
    Public DesRespuesta As String
    Public CodAutorizacion As String
    Public Fecha As String
    Public Monto As String
End Class

void btnTestPay_Click(object sender, EventArgs e)
        {
            var sCodigoQR = "78411803";
            var sMonto = "0";
            var sCodLocal = "6665590";
            CallAmipassPay(sCodigoQR, sMonto, sCodLocal);
        }

        private void CallAmipassPay(string sCodigoQR, string sMonto, string sCodLocal, string sPromo)
        {

            var TokenAutenticacion = "1028938";
            var respuesta = "";

            string sParametros = string.Format("?NumeroTransaccion={0}&Monto={1}&CodLocal={2}&CodPromocion={3}", sCodigoQR, sMonto, sCodLocal, sPromo);
            string url = "https://intpay.amipassqa.com/wspay/PAYPAP" + sParametros;
            HttpWebRequest request = (HttpWebRequest)HttpWebRequest.Create(new Uri(url));
            request.ContentType = "application/json";

            request.Headers["Authorization"] = string.Format("Basic {0}", TokenAutenticacion);
            using (WebResponse response = request.GetResponse())
            {
                using (StreamReader stream = new StreamReader(response.GetResponseStream()))
                {
                    var content = stream.ReadToEnd();
                    respuesta = JsonConvert.DeserializeObject<string>(content);
                }
            }
            RespuestaTransaccionPA resp = JsonConvert.DeserializeObject<RespuestaTransaccionPA>(respuesta);
            if (resp.CodRespuesta == "1")
            {
                //Venta Aprobada
                            }
            else
            {
                //Venta Rechazada
            }
        }
        public class RespuestaTransaccionPA
        {
            public string CodRespuesta;
            public string DesRespuesta;
            public string CodAutorizacion;
            public string Fecha;
            public string Monto;
        }

Datos ambiente de prueba

1. Ingrese a: https://intsocios.amipassqa.com/login.aspx
   Usuario: NNXXXXXX / clave: xxxxxxxxxx (por solicitar)
   
2. En el menú de la izquierda seleccione la opción “Modo móvil”
   
3. Ingrese a la opción “Pago Smartphone”
   
4. Ingrese monto (Ej. 100)
   
5. Ingrese clave: 7603
   
6. La aplicación mostrará el código QR que necesitamos para realizar la venta:
   

Codigo de local

Para realizar las pruebas los códigos de local son los siguientes:

• *Solicitar

Transacciones

Listado de transacciones del comercio para un día dado.

TX

Llamada

Ejemplo: https://intpay.amipassqa.com/wspay/TX

Parametros de entrada

Parametros de salida

Verifica Transacciones

Retorna los datos de venta de un número de autorización.

VTX

Llamada

Ejemplo: https://intpay.amipassqa.com/wspay/VTX

Parametros de entrada

Parametros de salida

Anulación

Anula una transacción autorizada.

ANPAP

Llamada

Parametros de entrada

Ejemplo

Parametros de salida

{
    "CodRespuesta": "1",
    "DesRespuesta": "APROBADO",
    "CodAutorizacion": "5270496",
    "Fecha": "2016-09-06 17:05:04.210",
    "Monto": "1000"
}

Reversa

Reversa una transacción autorizada.

RVPAP

Llamada

Parametros de entrada

Ejemplo

Parametros de salida

{
    "CodRespuesta": "1",
    "DesRespuesta": "APROBADO",
    "CodAutorizacion": "5270496",
    "Fecha": "2016-09-06 17:05:04.210",
    "Monto": "1000"
}

Verifica Transacciones QR

Retorna los datos de venta de un número de autorización.

cTXQR

Llamada

Ejemplo: https://intpay.amipassqa.com/wspay/cTXQR

Parametros de entrada

Parametros de salida

Integracion con eCommerce

Las API de Amipass es un conjunto de interfaces HTTP para integrar el eCommerce del comercio con AMIPASS. Estas API reciben los parámetros de entrada por medio de método GET y la respuesta es en formato JSON.

Vías de Acceso eCommerce

Ambiente productivo

Ambiente Integración

• El Token es individual por cada local o vitrina
• Cada local debe tener un código identificador y ya debe ser parte como comercio Amipass
• Todos los llamados (a excepción de los GET) tendrán como respuesta 200 (OK), 400 (Error) o 500 (Error interno) con un mensaje estándar indicando un código y un mensaje

Producto

Permite agregar o actualizar la informacion base de un producto

Producto

Llamada

URl : PATH: /product TIPO : POST

Parametros de entrada

Parametros de salida

Stock

Permite asignar un nuevo stock a un producto

Stock

Llamada

URl : PATH: /product/stock TIPO : PUT

Parametros de entrada

Parametros de salida

Precio

Permite asignar un nuevo precio a un producto

Precio

Llamada

URl : PATH: /product/price TIPO : PUT

Parametros de entrada

Parametros de salida

Marca

Marca - Actualizar

Llamada

URl : PATH: : /product/brands TIPO : PUT

Permite actualizar el ID de las marcas

Parametros de entrada

Parametros de salida

Marca - Obtener

Llamada

URl : PATH: : /product/brands TIPO : GET

Permite actualizar el ID de las marcas

Parametros de entrada

Parametros de salida (arreglo)

Categoria

Categorias - Actualizar

Llamada

URl : PATH: : /product/categories TIPO : PUT

Permite actualizar el ID de las categorías, es requerido el match entre la categoría padre e hija

Parametros de entrada

Parametros de salida

Categorias - Obtener

Llamada

URl : PATH: : /product/categories TIPO : GET

Permite traer todas las categorías asociadas a un token

Parametros de entrada

Parametros de salida (arreglo)