Introducción al SDK Javascript / Node.JS

Usando el SDK de Javascript / NodeJs de Pago Fácil para acceder al API

Pago Fácil SpA ExamplesPago Fácil SpA Examples

StatusStatus
GitHub IssuesGitHub Issues
GitHub Pull RequestsGitHub Pull Requests
LicenseLicense


Algunos ejemplos en Javascript para demostrar el uso del SDK.

📝 Table of Contents

🧐 About

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.

🏁 Instrucciones

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.

Instalación de los ejemplos de manera local.

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.

🎈 Ejecutando los ejemplos

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.

⛏️ Construido usando

Author

  • Cristian Tala Sánchez
  • Luis Marcelo Poblete Sandoval (Collaborator)