Monitoreo de Pagos

Deberás desarrollar un modelo que te permita monitorear los pagos que se realizan por medio del widget de la empresa.

Contamos con tres opciones:

  1. Webhook de notificación

  2. Obtener listado de transferencias realizadas (vía API)

  3. Webhook de notificación + Detalle de transferencia (vía API) recomendada

Webhook de notificación

Contar con una URL a la escucha de las notificaciones que enviará Prometeo a la hora de detectar un pago. Con este servicio podrá esperar a que Prometeo le notifique cada vez que se genere un evento por medio de su widget, para hacer uso de este, deberá disponibilizar una URL la cual estará escuchando los POST que le enviará Prometeo con información del pago a modo de notificación.

También deberá generar un token de verificación, el cual será enviado por Prometeo en la notificación, para que usted pueda controlarlo. Para más detalles vea nuestra documentación sobre Webhook de notificación.

{  
    "verify_token":"44db8d17360dfbe03f813384ac1459aa",  
    "events":[  
        {  
            "event_type":"payment.success",  
            "event_id":"dd74697b-2cea-46db-9e8c-395022994fb7",  
            "timestamp":"2022-11-11T02:42:36.888648",  
            "payload":{  
                "amount":"532",  
                "concept":"CI:49979841",  
                "currency":"UYU",  
                "origin_account":"12345678",  
                "destination_account":"12345679",  
                "destination_institution":"0",  
                "branch":"0",  
                "destination_owner_name":"Zeus",  
                "destination_account_type":"None",  
                "document_type":"None",  
                "document_number":"None",  
                "destination_bank_code":"test",  
                "request_id":"af138fd585404dbd8327cbd475da3562"  
            }  
        }  
    ]  
}

Obtener listado de transferencias realizadas (vía API)

Este mecanismo, básicamente se trata de contar un cron / script que esté consultando cada X tiempo el endpoint /transfer/logs de nuestra API Bancaria, para detectar desde el back un nuevo pago. Para más detalles vea nuestra documentación sobre “Obtener listado de transferencias realizadas” y “Detalle de transferencia”.

Webhook de notificación + Detalle de transferencia (vía API) -Recomendada

Este método es un híbrido entre las notificaciones y el consumo vía API, consta en tener una URL escuchando las notificaciones provistas por Prometeo, tomar el request_id del pago notificado y consultar el detalle de dicho pago con el endpoint /transfer/logs/{request_id}/ de nuestra API Bancaria.

{  
    "verify_token":"44db8d17360dfbe03f813384ac1459aa",  
    "events":[  
        {  
            "event_type":"payment.success",  
            "event_id":"dd74697b-2cea-46db-9e8c-395022994fb7",  
            "timestamp":"2022-11-11T02:42:36.888648",  
            "payload":{  
                "amount":"532",  
                "concept":"CI:49979841",  
                "currency":"UYU",  
                "origin_account":"12345678",  
                "destination_account":"12345679",  
                "destination_institution":"0",  
                "branch":"0",  
                "destination_owner_name":"Zeus",  
                "destination_account_type":"None",  
                "document_type":"None",  
                "document_number":"None",  
                "destination_bank_code":"test",  
                "request_id":"af138fd585404dbd8327cbd475da3562"  
            }  
        }  
    ]  
}

Ejemplo de request a detalle de una transferencia:

curl --request GET  
     --url <https://banking.prometeoapi.net/transfer/logs/af138fd585404dbd8327cbd475da3562/>  
     --header 'X-API-Key: TU_API_KEY'  
     --header 'accept: application/json'