Llaves de pago
Alias que identifican destinos en Bre-B.
Una llave de pago es un alias que identifica un destino en la red Bre-B. En lugar de usar números de cuenta (que son largos, propensos a error y específicos por banco), los participantes de Bre-B registran llaves contra sus cuentas en el directorio central: un número de celular (solo los 10 dígitos del número nacional, sin código de país), un número de documento, una dirección de email, un identificador alfanumérico emitido por Bre-B o un código de comercio. Cuando alguien quiere enviarte dinero, ingresa tu llave en su app bancaria, y Bre-B la busca y enruta el pago a tu cuenta.
Vas a usar llaves de pago de dos formas: registrando llaves para tus cuentas tenant para que puedan recibir pagos, y enviando llaves para resolución cuando tu tenant quiera enviar un pago.
Tipos de llave
| Tipo | Ejemplo | Notas |
|---|---|---|
| Cellphone | 3001234567 | Solo número celular colombiano. Exactamente 10 dígitos, empieza con 3. Sin código de país, sin +, sin espacios. Regex ^3\d{9}$. |
| Document | 21482961 | Solo el número de identificación — sin prefijo CC/CE/NIT, sin separadores. 1–18 caracteres alfanuméricos (pasaportes aceptados). Regex ^[A-Za-z0-9]{1,18}$. |
| user@example.com | Parte local 1–30 caracteres (sin espacios, sin @); dominio 1–61 caracteres de [A-Za-z0-9.-]. Regex ^[^\s@]{1,30}@[A-Za-z0-9.-]{1,61}$. | |
| Alphanumeric | @user123 | Identificador emitido por Bre-B. Empieza con @, seguido de 5–20 caracteres alfanuméricos. Útil cuando el usuario no quiere revelar datos personales. Regex ^@[A-Za-z0-9]{5,20}$. |
| Merchant code | 0012345678 | 10 dígitos, empieza con 00. Identifica comercios registrados en Bre-B. Regex ^00\d{8}$. |