Introducción al SDK Javascript / Node.JS
Usando el SDK de Javascript / NodeJs de Pago Fácil para acceder al API
Algunos ejemplos en Javascript para demostrar el uso del SDK.
📝 Table of Contents
La idea de este proyecto es minimizar la puesta en marcha de los desarrolladores e integradores que quieran usar el API de Pago Fácil para poder desarrollar sus productos y servicios usando nuestra tecnología.
Estas instrucciones harán que obtengas una copia local del proyecto para que puedas hacer pruebas con la API. La idea es que los uses de referencia para poder crear tu proyecto.
Una vez descargado tendrás una carpeta similar a esta:
Requisitos
Los ejemplos usan distintas librerías que hacen más sencillo el desarrollo, sin embargo las dos librerías que se requieren para poder usar nuestras APIs y el firmado de los mensajes son las siguientes :
npm install @pagofacil/api_pago_facil @pagofacil/sdk-apis-javascript-signature --save
Los ejemplos usan variables de entorno para la configuración. El SDK de Pago Fácil revisa si existe la variable de entorno STAGE, y si su valor es dev apuntará al servidor de desarrollo. Cualquier otro valor o si no existe apuntará por defecto al servidor de producción.
Clonando el repositorio
git clone [email protected]:PSTPAGOFACIL/pagofacil-sdk-javascript-examples.git
Descargando la última versión
Puedes descargar siempre la última versión del tutorial haciendo click en el siguiente link : https://github.com/PSTPAGOFACIL/pagofacil-sdk-javascript-examples/archive/master.zip
Para bajarlo desde una consola Unix puedes ejecutar el siguiente comando
wget https://github.com/PSTPAGOFACIL/pagofacil-sdk-javascript-examples/archive/master.zip
Instalando dependencias
Ejecutamos el siguiente comando en el root del proyecto.
Para ejecutar los ejemplos debes haber copiado antes el archivo .env.examples al archivo .env y llenar con tus datos para ejecutar los siguientes scripts
Authenticar el usuario
Retorna las credenciales necesarias para poder generar las consultas futuras
node examples/login.js
Acá se puede ver el Token jwt resultante.
Crear una transacción
Genera una transacción con los datos del servicio asociado. Retorna las distintas urls para pagar con los distintos medios de pago.
node examples/createTrx.js
En la imagen anterior se aprecia el statuas 400 al efectuar la transacción con la autenticación correctamente configurada en el archivo .env.
Luego la API retorna el ID de la Transacción y un payUrl que incluye las posibles URL's que puedes utilizar en tu proceso de pago.
Puedes elegir mostrar el Gateway de Pago Fácil con todas las opciones de Pago o alguna de ellas de manera directa.
En el caso que elijas mostrar solo una de las formas de pago;es importante destacar, que esto sólo ocurrirá en la primera iteración de la transacción. Si por cualquier razón el intento de pago no se lleva a cabo y el cliente lo vuelve a intentar, el sistema volverá por defecto al link del Gateway de Pago Fácil con todas las opciones de pago.
- NodeJs - Server Environment
- Pago Fácil Javascript SDK - Librería / SDK de Pago Fácil para javascript/NodeJS
- Pago Fácil Signature Library - Librería / SDK de Pago Fácil para firmar las consultas para javascript/NodeJS
Author
- Luis Marcelo Poblete Sandoval (Collaborator)
Updated 11 months ago