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.
<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>
Importar la colección de POSTMAN mediante este enlace 🔗
Declarar las variables de colección entregadas por el equipo de integración de ETpay
Asignar en **CURRENT VALUE
****las variables sin considerar “session_token”
Realizar una llamada con los datos de prueba pre-configurados
Observar respuesta del request
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
Utilizar la URL en el resultado “TEST”
<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>
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+'/hites/'+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.'''