¿Cómo funciona?

El Micrositio Personalizado permite a PlacetoPay realizar consultas a un servicio externo para obtener información de facturas y gestionar su pago, también permite el asentamiento de pagos cuando se procesan a través de la plataforma.

Funcionamiento del Servicio

1. Autenticación:

   • Se soportan dos tipos de autenticación:
     • Web Services Security (WSS): Usa UsernameToken Profile 1.1, donde las credenciales incluyen login, tranKey, nonce y seed.
     • JSON Web Token (JWT): Se basa en la autenticación básica con username y password, generando un access_token para las peticiones.
     • Para obtener mas información acerca de esto por favor dirigirse a la siguiente sección Autenticación.

2. Consultas de Facturas:

   • Se realiza mediante POST /invoice/search/.
   • Se pueden buscar facturas por referencia, documento del pagador o referencia alterna.
   • Se pueden aplicar filtros adicionales y definir restricciones de pago.
   • La respuesta incluye datos como estado de la factura, montos, impuestos y métodos de pago disponibles.
   • Para obtener mas información acerca de esto por favor dirigirse a la siguiente sección search.

3. Bloqueo y Liberación de Facturas:

   • Se pueden bloquear facturas (POST /invoice/hold) para evitar pagos mientras estén en proceso de validación.
   • Para desbloquearlas, se debe enviar una solicitud con el parámetro revoke: true.
   • Para obtener mas información acerca de esto por favor dirigirse a la siguiente sección hold.

4. Asentamiento de Pagos:

   • Una vez realizado el pago, enviamos una petición POST /invoice/settle/ con los detalles de la transacción.
   • Incluye datos como ID de la factura, código de autorización, monto, fecha, método de pago y referencia interna.
   • Para obtener mas información acerca de esto por favor dirigirse a la siguiente sección settle.

5. Manejo de Errores:

   • Se proporciona una estructura estándar de errores para casos como autenticación fallida, asentamiento ya realizado o factura inexistente.
   • Se pueden traducir los mensajes de error según el idioma Locale.
   • Para obtener mas información acerca de esto por favor dirigirse a la siguiente sección error.

6. Configuración de Métodos de Pago:

   • Se pueden definir los métodos de pago disponibles por factura.
   • Se permite la intersección o fusión de métodos cuando se pagan varias facturas en una sola transacción.
   • Para obtener mas información acerca de esto por favor dirigirse a la siguiente sección paymentMethod.

Este servicio web está diseñado para integrarse con cualquier sistema que soporte comunicación REST, permitiendo un flujo de pago seguro y eficiente.

Flujo de pago sin Hold

Flujo de pago con Hold

El uso del hold es un metodo opcional pero recomendado por parte de la pasarela.