Disponemos de una colección en POSTMAN preconfigurada para agilizar el entendimiento del funcionamiento básico de la API, en este apartado podrás encontrar cómo configurar este entorno de pruebas que te permitirá inicializar intentos de pago para tu comercio.

Colección POSTMAN

<aside> <img src="/icons/info-alternate_blue.svg" alt="/icons/info-alternate_blue.svg" width="40px" /> Para poder hacer uso de la colección se necesita que tengas acceso a POSTMAN ya sea en su formato aplicación o sitio web, puedes acceder a este servicio en postman.com

</aside>


  1. Importar la colección de POSTMAN mediante este enlace 🔗

    https://s3-us-west-2.amazonaws.com/secure.notion-static.com/c61a8627-b836-43f1-ba63-f5c7df147059/image-20220603-162042.png

  2. Declarar las variables de colección entregadas por el equipo de integración de ETpay

    Asignar en ** ****las variables sin considerar “session_token”

    Asignar en **CURRENT VALUE ****las variables sin considerar “session_token”

  3. Realizar una llamada con los datos de prueba pre-configurados

    https://s3-us-west-2.amazonaws.com/secure.notion-static.com/076cd006-a51b-4358-b80f-ba86a01be443/image-20220603-154113.png

  4. Observar respuesta del request

    Untitled

    Observar que en este apartado de inicio rápido solo utilizaremos el token, sin embargo considerar que el signature token es sumamente importante y de uso obligatorio para el paso a producción

  5. Utilizar la URL en el resultado “TEST”

    https://s3-us-west-2.amazonaws.com/secure.notion-static.com/723cc71c-4143-49e4-af63-1433ad04e47a/image-20220603-154500.png

    <aside> ⚠️ El QR_URL contiene la URL del intento de pago en formato QR, este es para que puedas probar con mayor facilidad el sistema de pagos desde un smartphone, sin embargo, utiliza una API externa para transformar la URL en QR. Recomendamos usarlo solo a modo de prueba

    </aside>

  6. Replicar llamada en tu lenguaje de programación

    El siguiente código en Python ejecuta el POST request anteriormente descrito, y con el “session_token” obtenido redirecciona a la URL que inicia la sesión del cliente.

    import requests
    import webbrowser
    
    '''
    Request simple a la API,
    que redirecciona a la pagina de pago.
    '''
    
    #Variables globales entregadas por ETpay
    API_URL = r'valid_url'
    PTM_URL = r'valid_url'
    INIT_API = r'/session/initialize'
    MERCHANT_CODE = "valid_code"
    MERCHANT_API_TOKEN = "valid_api_key"
    
    request_data = {
        "merchant_code": MERCHANT_CODE,
        "merchant_api_token": MERCHANT_API_TOKEN,
        "merchant_order_id": "order-1992", #id de orden de compra propio del comercio
        "order_amount" : 1,
    }
    
    #Obtención de session token
    resp = requests.post(API_URL+INIT_API, json=request_data)
    token = resp.json()['token']
    
    #Se lanza sesión del cliente
    webbrowser.open(PTM_URL+'/session/'+token)
    '''Notar que en este código no se guarda el valor del signature_token**.** Más adelante se explicará en detalle su utilidad, pero se debe tener en cuenta que es necesario obtener el valor de este.'''
    

    Volver a Integración con API Rest