API CashOut
Buscar…
Notificación
Este es el proceso de notificación que utiliza Payvalida para notificar el retiro o la expiración de una orden de desembolso.
Para esta etapa del proceso de integración el comercio debe construir un servicio REST que será consumido por Payválida para realizar el proceso de notificación. Cuando esté construido, se debe comunicar a Payválida para que se realice el registro de la URL de dicho servicio.
Al momento de registrar una orden de desembolso, ésta se crea en estado PENDIENTE. La orden de desembolso puede cambiar por diversas razones:
  1. 1.
    El cliente ha efectuado el desembolso -> Cambia de estado PENDIENTE a APROBADO y se notifica con status APROBADA.
  2. 2.
    No se ha efectuado el desembolso antes de la fecha de vencimiento -> Cambia de estado PENDIENTE a CANCELADA y se notifica con status VENCIDA.
El sistema notifica de forma automática en el momento del cambio de estado de la orden.
La notificación se envía por el método HTTP POST con un body de tipo json.
Request (Lo ejecuta Payvalida)
Response
Campo
Tipo
Descripción
amount
float64
Monto de la orden de desembolso
document
string
Documento de identidad asociado a la orden de desembolso
operation
string
Identificador generado por el comercio para la orden de desembolso
currency
string
Moneda con la que se registra la orden de desembolso
status
string
Estado de la orden del desembolso (El valor que se envía es APROBADA)
checksum
string
Cadena de comprobación calculada con SHA512(operation+document+amount+currency+status+FIXED_HASH_CASH). El amount para el cálculo del checksum debe ser transformado a entero.
location_code
string
Información código de localización, en Colombia se envía el código dane de la operación. Para los demás países, se envía el location_code que proveen las redes de recaudo.
Campo
Tipo
Descripción
code
int
El valor 0 lo tomamos como ejecución correcta. Si se retorna un valor diferente lo tomamos como un error.
text
string
Descripción de la ejecución al momento de responder.
Última actualización 6d ago
Copiar enlace