Consultar entidades bancarias

Obtén las entidades bancarias habilitadas para realizar intentos de pago. Es importante tener el cuenta la moneda y el tipo de proceso que vas a realizar.

Ruta

GET /v1/merchant/payment/intent/entities

Encabezado

Name	Type	Description
x-auth-token*	String	Es el código generado a partir del proceso de autenticación.
Content-Type	String	Es el tipo de contenido que se está enviando en la solicitud. Ejemplo: application/json

Cuerpo

Name	Type	Description
type	string	Es el tipo de intento del que se requiere el listado de bancos. PSE | CASH
currency	string	Código que identifica la divisa de la dispersión en formato ISO 4217. COP | USD Por defecto es COP

Respuesta

200 PSE

{
    "entities": [
        {
            "code": 1815,
            "name": "Alianza Fiduciaria",
            "logos": {
                "default": "https://content.trazo.co/payments/logos/1815.png",
                "circle": "https://content.trazo.co/payments/logos/1815-circle.png",
                "horizontal": "https://content.trazo.co/payments/logos/1815-horizontal.png"
            }
        },
        {...}
    ]
}

200 CASH

{
    "entities": [
        {
            "id": 2001,
            "name": "Cajero Bancolombia",
            "type": "atm",
            "logo": "https://content.trazo.co/logos/2001.png",
            "logo_circle": "https://content.trazo.co/logos/2001-circle.png",
            "instructions": "Puedes realizar el pago en cualquier cajero multifuncional de Bancolombia, la confirmación puede tardar entre 5 y 7 minutos, y no reinicies la transacción una vez hecho el pago",
            "agreement": {
                "code": 8790,
                "bar_code": "7709998888999",
                "name": "Recaudo Logístico Trazo",
                "min_amount": 0,
                "max_amount": 9999999,
                "reference": {
                    "type": "pin",
                    "format": "numeric",
                    "length": 6
                }
            }
        },
        {...}
    ]
}

400

{
    "error": "No bank was found with the provided parameters. Please try again with a different type (type)."
}

---

Ejemplo

cURL

curl --location --request GET '{{base_url}}/v1/merchant/payment/intent/entities' \
--header 'x-auth-token: {{token}}' \
--data '{
    "currency": "COP",
    "type": "PSE"
}'

NodeJS(Axios)

const axios = require('axios');

let data = JSON.stringify({
  "currency": "COP",
  "type": "pse"
});


let config = {
  method: 'get',
  maxBodyLength: Infinity,
  url: `${base_url}/v1/merchant/payment/intent/entities`,
  headers: { 
    'x-auth-token': token //Añadir token
  },
  data : data
};

axios.request(config)
.then((response) => {
  console.log(JSON.stringify(response.data));
})
.catch((error) => {
  console.log(error);
});

Python

import requests

url = f"{base_url}/v1/merchant/payment/intent/entities"

payload = json.dumps({
  "currency": "COP",
  "type": "pse"
})

headers = {
  'x-auth-token': token #Añadir token
}

response = requests.request("GET", url, headers=headers, data=payload)

print(response.text)