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.

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

  • GUID: Este dato es un identificador único global, este valor usualmente tiene una longitud de 36 caracteres.
  • PSI: GreyPhillips Cloud, o Plataforma de Servicios Integrados (PSI)
  • Fecha y Hora en Formato Universal: Las fechas se representan en formato de texto, organizadas con el formato YYYYMMdd HHmmss

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.

Interface de la pasarela de pagos:

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.