Consulta externa
Permite realizar una consulta de orden de pago al comercio
El servicio de consulta externa puede tener dos tipos de integración: código de convenio propio o referencia con prefijo (prefijo + identificación).
La integración con convenio propio es posible sólo con la red de recaudo efecty. Y la integración de referencia con prefijo debe de seguir el formato prefijo + número y garantizar una longitud mínima para ser considerada de 9 dígitos y una máxima de 16 dígitos. Queda a disposición de cada comercio decidir cómo rellenar los dígitos faltantes, pero se recomienda utilizar el número 0, por ejemplo: 326000034567
El servicio de consulta externa, permite que el comercio sea quien tenga el control de la orden a recaudar y el medio de pago que se utilizará para realizar el pago.
Campo | Requerido | Tipo | Longitud | Descripción |
reference | Si | Numérico | 16 | Número de referencia proporcionado por el usuario |
netname | Si | Alfanumérico | 40 | Nombre del medio de recaudo |
currency | Si | Numérico | 1 | Moneda asociada al monto de la orden de compra (Monedas) |
timestamp_start | Si | Numérico | 10 | Tiempo de inicio de la transacción en formato Unix Timestamp (Segundos) UTC |
checksum | si | Alfanumérico | 512 | Cadena de comprobación SHA512(reference + currency + netname + timestamp_start + FIXED_HASH) |
Los montos mix y max son obligatorios si el monto es CERO.
Es de suma importancia garantizar un tiempo de respuesta del servicio menor a 5 segundos, de lo contrario, nuestro sistema cerrará la conexión.
Es potestad de cada comercio realizar la validación del medio de recaudo, es decir, de rechazar o no la petición de detalles de la orden de compra de acuerdo al medio que se envía.
Checksum
Si los montos min y max no son enviados, el checksum se calcula sin tener estos campos en cuenta. Los dos escenarios para el cálculo de checksum son:
Sin límites: order + amount + timestamp_end + FIXED_HASH
Con límites: order + amount + min + max + timestamp_end + FIXED_HASH
Last updated