Cómo obtener los bancos PSE activos

Obtén la lista de bancos habilitados en PSE desde el anchor del ledger y puebla el selector de bancos en tu formulario de checkout.

Prerequisitos

Antes de comenzar:

  • Tienes un JWT Bearer token válido para autenticar la solicitud. Consulta Autenticación para obtener o renovar el token.
  • Leíste Conceptos Clave y entiendes el ciclo de vida del intent PSE.

Obtener la lista de bancos

La lista de bancos está disponible a través del endpoint List Anchors con el filtro kind=pse. Requiere un JWT Bearer token en el header Authorization.

GET https://<ledger-url>/api/v2/anchors?kind=pse
Authorization: Bearer <jwt>
x-ledger: <ledger-handle>

Respuesta:

{
    "data": [
        {
            "data": {
                "handle": "Accion Fiduciaria",
                "target": "pse-bank",
                "custom": {
                    "financialInstitutionCode": "1831",
                    "financialInstitutionName": "Accion Fiduciaria"
                }
            },
            "hash": "b8d9e213711d56e4f298ceef13727f70e81890a794cf661edeb51a95309ac670",
            "meta": { "proofs": [ ... ] }
        },
        {
            "data": {
                "handle": "ADDI CF",
                "target": "pse-bank",
                "custom": {
                    "financialInstitutionCode": "1829",
                    "financialInstitutionName": "ADDI CF"
                }
            },
            "hash": "00d886cd899134ec031095934ff201d167418a44e325f9b7fd805335713a583a",
            "meta": { "proofs": [ ... ] }
        },
        {
            "data": {
                "handle": "ALIANZA FIDUCIARIA",
                "target": "pse-bank",
                "custom": {
                    "financialInstitutionCode": "1815",
                    "financialInstitutionName": "ALIANZA FIDUCIARIA"
                }
            },
            "hash": "8684bd84776353c2b1cef74f2727fef4395becf58003f0137591eda2faee50d3",
            "meta": { "proofs": [ ... ] }
        }
    ],
    "hash": "ca3e2a2e2f23bbaa4a15ee38a9d603c4d3e2f4d45b338057364c68fba13e3c71",
    "meta": { "proofs": [ ... ] },
    "page": { "total": 63, "index": 0, "limit": 63 }
}

Cada entrada de data representa un banco. Los códigos PSE están en data[i].data.custom.financialInstitutionCode y los nombres en data[i].data.custom.financialInstitutionName. El campo data[i].data.handle también contiene el nombre del banco. Itera sobre el array para poblar el selector.

Siguiente paso

Con esto ya tienes la lista de bancos activos lista para poblar el selector de instituciones financieras de tu checkout. En la siguiente sesión continuaremos con Cómo manejar webhooks PSE, donde configurarás los Effects y los handlers que recibirán las notificaciones de Kamin ante cada cambio de estado del intent.

Historial de cambios
1.1.1
  • Corregido• El filtro del endpoint es `kind=pse`
1.1.0
  • Cambiado• El filtro de la lista de bancos ahora es `kind=pse`
1.0.0
  • Agregado• Version inicial