El sistema IPGBDV cuenta con su integración en PHP para poder generar pagos en sistemas realizados en dicho lenguaje.
Consideraciones previas
Si bien el método de creación y verificación de pagos es muy similar, ha sufrido pequeños cambios para mejorar el proceso. A continuación, lo guiaremos para poder integrarse a la nueva aplicación..
Cambios en la autenticación
El método de autenticación de IPG2 es diferente al de IPG1.
IPG2 requiere autenticación previa a la operación, obteniendo un token con una vida de 1 hora para ser utilizado. por lo que será necesario hacer una petición de token para poder incluir en el encabezado de la llamada.
Api RestURLs
Las URLs de la nueva API son las siguientes:
Accion | POST/GET | IPG1 | IPG2 |
Crear solicitud pago | POST | https://{baseUrl}/api/Payment | https://{baseUrl}/api/Payments |
Verificar pago | GET | https://{baseUrl}/api/Payment?id= | https://{baseUrl}/api/Payments/{paymentId} |
Procesar el pago | POST | https://{baseUrl}/api/ProcessPayment?id=&paymentMethod=&smsCode= | https://{baseUrl}/api/Payments/{paymentId}/process |
Envio de token | POST | https://{baseUrl}/api/SendToken?id=&paymentGroup= | https://{baseUrl}/api/SendTokens |
Obtención de metodos y grupos de pagos disponibles | GET | - | https://{baseUrl}/api/PaymentGroups?personType={personTypeId} |
Cambios en la creación del pago
Se agregaron dos campos nuevos para personas júridicas
RifLetter | Letra del rif. | String (J,G o V) |
RifNumber | Número del rif | Number |
Header
En IPG1, la autenticación se creaba a base de pasar los parámetros username y password en el Header del Request.
En IPG2 se debe agregar el Token generado en el Header del Request como Bearer token al campo Authorization.
Cambios en la verificación del estado de un pago
Se cambio el campo Id por el campo Code para identificar el pago
Cambios en el procesamiento de un pago
Mientras que en IPG1 solo se necesitaban los parametros: id, paymentMethod y smsCode. En IPG2 los parametros son los siguientes: paymentMethodId, paymentGroupId, authenticationToken y authenticationMethodId
Cambios en el envio de token de un pago
Mientras que en IPG1 se necesitaban los parametros: id y paymentGroup. En IPG2 los parametros son los siguientes: paymentId, paymentGroupId y authenticationMethodId