Notificación
El proceso de notificación para las ordenes de suscripción es el mismo proceso utilizado para todas las notificaciones. El único cambio es que se agregaran 2 nuevos campos:
Last updated
El proceso de notificación para las ordenes de suscripción es el mismo proceso utilizado para todas las notificaciones. El único cambio es que se agregaran 2 nuevos campos:
Last updated
subscription_customer_id
subscription_plan_id
Este es el proceso de notificación que utiliza payvalida para notificar el pago o la expiración de una orden creada.Se debe construir un servicio REST para ser consumido por Payvalida. A través de este servicio se hace el proceso de notificación.La URL de notificación se configura en nuestro módulo de comercios, en el perfil de cuenta. Puedes encontrar los pasos a seguir aquí.Al momento de registrar una orden, ésta se crea en estado PENDIENTE. La orden puede cambiar de estado por diversas razones:
Se ha recibido el pago correspondiente -> Cambia de PENDIENTE a APROBADA y se notifica con estatus approved.
No se ha recibido el pago correspondiente antes de la fecha de vencimiento -> Cambia de PENDIENTE a VENCIDA y se notifica con estatus cancelled.
El sistema notifica de forma automática en el momento del cambio de estado de la orden, pero es posible que exista más de una notificación de la misma orden. Es responsabilidad del comercio evitar entregar mas de una vez el producto adquirido por el cliente en caso de que haya más de una notificación.
Esta notificación se realizara a la URL proporcionada por el comercio.Request (Realiza Payvalida)Request (ejemplo)Respuesta (Esperada)Cabeceras
Campo
tipo
Descripción
pv_po_id
int
Identificación de la orden de Payvalida
po_id
string
Identificación de la orden del comercio
status
string
Estado de la orden. Puede ser approved o cancelled.
pv_checksum
string
Cadena de comprobación calculada con SHA256(po_id + status + NOTIFICATION_HASH)
amount
string
Monto de la orden
iso_currency
string
Moneda con la que se registra la orden
pv_payment
string
Medio de pago con el que se registra ó se aprueba la orden
subscription_id
string
id de suscripción
subscription_customer_id
string
customer id usado para crear la orden de suscripción.
subscription_plan_id
string
plan id usado para crear la suscripción.
De lado del comercio por motivos de seguridad se recomienda hacer la construcción del pv_checksum con la credencial NOTIFICATION_HASH entregada en el registro. Para validar que sea payvalida la que realiza la notificación al compararlas.