El propósito de este ejemplo es ilustrativo para aquellos interesados en la integración con el API de Nequi. Con este ejemplo podrá consumir algunos de los recursos ofrecidos por el API,y si lo desea podrá utilizar este código como base para el consumo del resto de recursos expuestos en el API. Para más información visite nuestro portal para desarrolladores https://conecta.nequi.com.co.
Asegúrese de tener las credenciales necesarias para hacer el consumo del API, los datos mínimos que debe tener son:
- Client Id
- Client Secret
- API Key
Los anteriores datos los podrá encontrar en la sección Credenciales en el siguiente enlace https://conecta.nequi.com/content/consultas.
En el archivo /app.example.env
podrá encontrar un ejemplo de las credenciales que debe proveer. Además también encontrará algunas definiciones adicionales que se usan en los ejemplos.
Tenga en cuenta que los ejemplos toman como premisa que las credenciales y las definiciones adicionales están almacenadas en variables de entorno.
Todos los ejemplos aquí proporciandos usan la librería Requests para hacer el consumo de los endpoints. Usted y su equipo de desarrollo es libre de usar cualquier librería que le provea una abstracción para el consumo de APIs Restful o de crear su propio código para dicha integración.
Recuerde que podrá encontrar el detalle de los recursos ofrecidos por el API en el siguiente enlace https://docs.conecta.nequi.com.co/.
En el archivo /src/AuthController.php
podrá encontrar el código necesario para autenticarse, el cual le permite obtener un token de acceso que deberá usar en las integraciones del API.
Esta sección cuenta con 3 ejemplos que podrá encontrar alojados en la carpeta /src/deposit_withdrawal/
.
-
Validar una cuenta: En el archivo
/src/deposit_withdrawal/ValidateClient.php
podrá encontrar el código para validar una cuenta. -
Recargar una cuenta: En el archivo
/src/deposit_withdrawal/ChargeAccount.php
podrá encontrar el código para recargar una cuenta. -
Verificar una solicitud de retiro: En el archivo
/src/deposit_withdrawal/CheckWithdrawalRequest.php
podrá encontrar el código para validar una cuenta.
Esta sección cuenta con 3 ejemplos que podrá encontrar alojados en la carpeta /src/payment/
.
-
Generar pago: En el archivo
/src/payment/GenerateQR.php
podrá encontrar el código para generar un pago con código QR. -
Consultar estado del pago: En el archivo
/src/payment/GetStatusPayment.php
podrá encontrar el código para consultar el estaddo un pago con código QR. -
Reversar la transacción: En el archivo
/src/payment/ReverseTx.php
podrá encontrar el código para reversar una transacción.
Esta sección cuenta con 1 ejemplo que podrá encontrar alojados en la carpeta /src/payment_push/
.
- Solicitu de pago: En el archivo
/src/payment_push/UnregisteredPaymentRequest.php
podrá encontrar el código para solicitar un pago mediante notificación push.
Para ver en funcionamiento de los ejemplos, descargue los fuentes, desplieguelos en cualquier servidor donde corra PHP(7.x), puede ser Apache, y acceda al archivo /src/index.php
desde un navegador web.
Si lo desea también puede desplegar estos ejemplos usando docker y docker-compose, ejecutando el siguiente comando en la raíz del proyecto:
docker-compose up
: Este comando puede tomar unos minutos mientras se descargan los recursos necesarios, al final quedará la terminal de comandos en modo activo, lo cual le permitirá detener el despliegue presionandoCtrl + c
. Ahora podrá acceder desde un navegador alocalhost:8000
.
- Carpeta
/src/utils/
: Aquí podrá encontrar funciones que se reusan en los ejemplos de integración, y constantes para validar resultados del API. - Carpeta
/src/lib/
: Carpeta destinada para guardar las librerías de externos, por ejemplo la librería 'Requests'.
Made with ♥ at Nequi