Skip to main content

​
Back to Back

When the Enlace PSE/TRANSFIYA/BREB directo configuration is enabled in the admin TumiPay backoffice, you can execute PayIn transactions directly without redirecting the user to the checkout. The API will return a direct PSE link or a Transfiya confirmation depending on the payment method.

​
Required Fields

In addition to the standard body parameters of the POST /payin endpoint, provide the following parameters:

​
Example PSE

  • bank – Required only when payment_method is PSE.
  • person_type – Required only when payment_method is PSE (NATURAL or JURIDICA)
{
    "code": "01",
    "status": "SUCCESS",
    "message": "Pago generado correctamente",
    "data": {
        "ticket": "abc123",
        "payment_url": "https://registro.desarrollo.pse.com.co/PSENF/index.html?enc=abc123",
        "type": "pse_payment"
    }
}

​
Retrieve available banks

Use the GET /api/v1/pse/banks endpoint to fetch the list of financial institutions that the user can choose from. 
{
    "code": "01",
    "status": "SUCCESS",
    "data": [
        {
            "code": "1507",
            "name": "NEQUI",
            "image": "https://assets.tumipay.co/images/payment_method/nequi.webp"
        },
        {
            "code": "1551",
            "name": "DAVIPLATA",
            "image": "https://assets.tumipay.co/images/payment_method/daviplata.webp"
        },
        {
            "code": "1007",
            "name": "BANCOLOMBIA",
            "image": "https://assets.tumipay.co/images/payment_method/bancolombia.webp"
        }
    ]
}

​
Example Transfiya

  • phone_number – Must match the user’s registered Transfiya phone when using TRANSFIYA.
{
    "code": "01",
    "status": "SUCCESS",
    "message": "Pago generado correctamente",
    "data": {
        "confirmation": "La transacción ha sido creada y está pendiente de confirmación por parte del usuario",
        "type": "transfiya_confirmation"
    }
}

​
Example Bre-B

{
    "code":"01",
    "status":"SUCCESS",
    "message":"Pago generado exitosamente",
    "data":{
        "ticket": "abc123",
        "key_value":"@tumipaybreb",
        "type": "payment_reference"
    }
}