Pay
Pagos SiNPE
Aproveche todas las ventajas de nuestra plataforma, con los productos relacionados se puede obtener el máximo provecho y así conseguir de mejor manera cumplir con su tarea del día.
Aproveche todas las ventajas de nuestra plataforma, con los productos relacionados se puede obtener el máximo provecho y así conseguir de mejor manera cumplir con su tarea del día.
Conceptos
| Término | Descripción |
|---|---|
| Token | El token es una medida de seguridad estándar de la industria que permite un permiso temporal al uso de los métodos y acceso a los sistemas. |
| Interface de la pasarela de pagos | Interface de comprobación de pago que muestra la información referencial de la transacción y controla el tiempo disponible para completar el proceso de pago. |
| Transacción | La transacción se refiere a la transacción que el usuario esta pagando, ya sea que represente una factura, un recibo de dinero o cualquier transacción referenciada del lado del sistema del cliente. |
Métodos necesarios
Este documento contiene la información relacionada a las estructuras de datos necesarias para las funciones vinculadas al procesamiento pagos:
Consideraciones
URL Web Service
URL Pruebas
| Métodos | Descripción |
|---|---|
| getTokenT | Token necesario para la ejecución de los métodos o interfaces, Se recomienda al menos 5 minutos, es decir, 300 segundos para dar tiempo a que el usuario ingrese a su sistema de banco y haga la transferencia, ya que el tiempo total debe de incluir además del acceso a la aplicación del banco el tiempo del operador de telefonía para enviar la notificación por SMS. |
Escenario para la verificación de pagos
Según como sea configurado, nuestra pasarela puede funcionar con o sin interface, el escenario descrito aquí, es aquel con interface de usuario final.
La pasarela de pagos deberá de recibir vía POST los parámetros como se muestra en la siguiente tabla, de esta manera, la interface de la pasarela levantara con las indicaciones para los usuarios finales y regresara el respectivo resultado al sistema desde el que se hizo la llamada.
<form id='GreyPhillipsPay' name='GreyPhillipsPay' method='POST' action='https://whitelabel.greyphillips.com/requestPaycomService.aspx'>
<input name='token' type='hidden' value='dnlxc21r4oCgdnlxc21r4oCga2xuQW9ubm03PztrPjc+Pm87N0M/Qms3cD1CbjxvP3BCOz5v4oCgeXZ5a3PigJ5r4oCgPDo8PTs6Oj0qO0E8PT8+' id='token'>
<input name='currency' type='hidden' value='CRC' id='currency'>
<input name='amount' type='hidden' value='1000' id='amount'>
<input name='amount_min' type='hidden' value='500' id='amount_min'>
<input name='type' type='hidden' value='SMS' id='type'>
<input name='processor_id' type='hidden' value='88439843' id='processor_id'>
<input name='reference' type='hidden' value='FAC3452' id='reference'>
<input name='url_return' type='hidden' value='https://www.client.com/checkout.aspx' id='url_return'>
<input name='url_cancel' type='hidden' value='https://www.client.com/usercancel.aspx' id='url_cancel'>
</form>A continuación, se explican las variables que deben de utilizarse para la correcta ejecución de la pasarela de pagos.
| Variable | Descripción |
|---|---|
| token | Token obtenido de método referido arriba |
| currency | Código de la moneda, por ejemplo, CRC |
| amount | Monto de la transacción |
| amiount_min | Monto mínimo aceptado para la transacción (pagos parciales) |
| type | SMS |
| processor_id | Número destino de la transacción |
| reference | Referencia a la transacción interna |
| url_return | Cualquier retorno automático del proceso |
| url_cancel | Botón de CANCEL (presionado por el usuario) |
Si los parámetros son validos la interface de la pasarela de pagos que se mostrara al usuario es la siguiente:
Cuando la interface de la pasarela de pagos es ejecutada, esta actuara según los parámetros entregados vía POST, donde finalmente el sistema que hace la ejecución recibirá un código de respuesta, según la siguiente tabla.
| Código | Descripción |
|---|---|
| 00 | ACCEPTED&type=SMS&processor_id=88888888&amount={MONTORECIBIDO}&reference=FAC3252 |
| 80 | ERROR: xxxxx |
| 94 | Internal Server Error |
| 95 | Invalid data |
| 96 | Missing data |
| 97 | Invalid refresh |
| 98 | Invalid token (Expired) |
| 99 | Invalid token |
La plataforma registrara tanto las peticiones como los resultados de las peticiones en las bitácoras de control para permitir posterior auditoria o apoyo a la operación.