Cómo resolver llaves en Bre-B

En esta guía aprenderás a resolver una Llave Bre-B usando el Ledger de Kamin para obtener los datos del destinatario (nombre y cuenta) y así poder realizar una dispersión B2P.

Requisitos previos

• Tienes un token Bearer válido para autenticar solicitudes GET.
• Handle del Ledger de tu entorno (x-ledger).

Llave Bre-B provista por el pagador/beneficiario puedes encontrar las llaves de prueba en Llaves de prueba

Para más información, consulta:

• Sobre la autenticación

Objetivo

Resolver una llave Bre-B y obtener la cuenta destino y datos del usuario que recibirán el pago, en Kamin la reolución de la llave es mapeada a traves de un Anchor.

Get Anchor

La API de Anchor permite obtener Anchors usando el endpoint GET /v2/anchors/:handle donde el handle es la llave a resolver.

Existen 5 tipo de llaves en Bre-B, para personas naturales solo 4 estan habilitadas: PHONE, ALPHANUM, NRIC (id) y EMAIL

Solicitud de ejemplo

GET <baseURL>/api/v2/anchors/{anchorHandle}

Accept: application/json, text/plain, */*
Authorization: Bearer eyJhbGciOiJFZER....
x-ledger: <ledger-handle>

Cuerpo de respuesta:

{
    "data": {
        "handle": "alphanum.@kaminTestKey",
        "wallet": "breb",
        "target": "signer:wcDHYmSJP8uJF5dVGXBEKNA3e5hBm1eQEn@breb",
        "schema": "breb-key",
        "custom": {
            "bankId": "901830825",
            "status": "ACTIVE",
            "firstName": "Alphanum",
            "lastName": "Key",
            "keyType": "ALPHANUM",
            "keyValue": "@kaminTestKey",
            "idType": "CC",
            "idValue": "1088432333",
            "targetSpbviCode": "TFY",
            "bankAccountType": "SVGS",
            "bankAccountNumber": "000202020"
        },
        "access": [
            {
                "action": "any",
                "signer": {
                    "$record": "owner"
                }
            }
        ]
    },
    "hash": "9f770c6e10299cbff78e25ee7a455e1ce5f6da00bd2ee0fdaa6b0c7a4852f720",
    "meta": {
        "proofs": []
    }
}

En la respuesta se encuentra la resolución de la llave, esta contiene dentro del objecto data.custom toda la data del dueño de la llave, finalmente la información de la cuenta destino, la cual debe ser usada para genere un intent (transferencia) se ecuentra en el campo data.target

Los valores que pueden tener los campos resultos son:

Tipos de cuenta bancaria

El campo bankAccountType retornado por la API de Anchor puede tomar cualquiera de los siguientes códigos, definidos por la regulación:

Errores comunes

¿Qué sigue?

Una vez que hayas recuperado un Anchor válido, puedes:

• Usar el valor data.target en intents tipo (B2P) SEND para un abono directo al beneficiario.
• Construir validaciones previas en tu interfaz para confirmar si un usuario puede enviar o recibir fondos.