por Jesús en 2022-05-27 API

Para quienes no lo sepan, Wompi es una pasarela de pagos del Banco Agricola con varias cosas interesantes, una de ellas es la facilidad con la que puedes crear una cuenta y por supuesto tener acceso a su API que nos permite aceptar pagos en nuestra aplicación. Pero antes de empezar a jugar con el API, es buena idea revisar la documentación para orientarnos y que el trabajo sea más tranquilo. Una vez hayamos entendido las reglas del juego, te recomiendo echarle un vistazo a sus endpoints que tiene varias cosas bastante interesantes que no se mencionan en la documentación, puede que por tratarse de algunas novedades o por desactualización de la misma, como fuera el caso, los endpoint nos ayudarán bastante.

Muy bien, fin de la intro y vamos al tutorial.

Paso 1 – Crea una cuenta (importante)

Paso 2 – Crea una aplicación en el panel de administración, no es nada difícil, le pones un nombre y después marcas donde dice «Enviar email por transacción» y colocas un correo válido, obviamente tienes muchos más datos que puedes rellenar según convenga, pero con estos se puede empezar.

Paso 3 – Si todo ha salido bien, ahora en nuestra aplicación aparece una nueva sección dedicada a las credenciales de nuestra API. Debemos guardar esos datos porque son muy importantes para interactuar con el servicio.


Ahora sí, abrimos Postman o cualquier otra herramienta que uses para trabajar con APIs. Para este paso vamos a obtener nuestro token usando las credenciales que previamente hemos obtenido en el #paso3. Para más información puedes consultar en este link donde nos explica el proceso.

Haremos la petición POST a la siguiente ruta y en el body pasarle los parámetros que nos solicita.

https://id.wompi.sv/connect/token
grant_type:client_credentials 
audience:wompi_api
client_id: tu App Id
client_secret: tu App Secret 

Si todo ha ido bien, deberías obtener una respuesta como la siguiente. Copia el token, es importante para seguir interactuar con el resto de endpoints .

Obteniendo toke


Ahora es momento de usar nuestro token para probar que funciona sin problemas, haremos una petición GET para conocer los datos de nuestra aplicación a la siguiente ruta, en el header le pasaremos los datos requeridos, es decir, nuestro token previamente obtenido. Puedes checar el siguiente link para orientarte.

https://api.wompi.sv/Aplicativo
authorization:Bearer AQUI_TU_TOKEN
content-type:application/json


Hasta este punto no hemos hecho mucho, pero ahora se pone más interesante. Haremos nuestra primera transacción de prueba 🙂

Haremos una petición de tipo POST a la siguiente ruta y siempre debemos pasar en el header nuestro token y el content-type.

https://api.wompi.sv/TransaccionCompra
authorization:Bearer AQUI_TU_TOKEN 
content-type:application/json

Nuestra petición debería verse como en la imagen y si todo ha salido bien, obtendremos una respuesta 200 con datos que corresponden a la transacción que hemos hecho. Recuerda que en el body, debes enviar los datos que corresponden a los datos de la tarjeta, monto, un correo y un nombre. Puedes ver más info en el siguiente link.


¿Si queremos consultar nuestra transacción?, calma, también tenemos disponible una ruta GET que nos ayuda con eso, solo debemos pasarle el id, como el que obtuvimos en la anterior petición. Siempre debes mandar en el header el token y el content-type, que no se te olvide.

https://api.wompi.sv/TransaccionCompra/idTransaccion


Para terminar, probaremos las transacciones con Bitcoin, puede que a más de uno esto le pueda resultar útil o al menos interesante. Para trabajar con la ruta que maneja transacciones con bitcoin es necesario conocer el idRegion y idTerritorio que hasta el momento desconocemos, para ello, primero necesitamos obtener esos datos en la siguiente ruta de tipo GET, como con las otras rutas, no olvides pasar el token y el content-type.

https://api.wompi.sv/api/Regiones

Ahora ya tenemos acceso a idRegion y idTerritorio para usarlos en nuestra petición para trabajar con bitcoin. La ruta es la siguiente y es de tipo POST y como lo hemos venido haciendo, siempre pásale el token y el content-type en el header para no tener problemas.

https://api.wompi.sv/TransaccionCompra/Bitcoin

Debemos pasar en el body los siguientes datos, son importantes para no tener errores. En la respuesta nos devolverán una URL que nos muestra un código QR que podemos escanear sin problemas y mas información importante.


Y como dijo mi ex, ¡hasta aquí llegamos!, puede que en otra entrega revisemos otros endpoints que me parecen interesantes, pero de momento espero que esta pequeña guía te sirva para orientarte.