Payment keys
Aliases that identify destinations on Bre-B.
A payment key is an alias that identifies a destination on the Bre-B network. Instead of using account numbers (which are long, error-prone, and bank-specific), Bre-B participants register keys against their accounts in the central directory: a mobile phone number (the 10-digit national number only, no country code), a document ID, an email address, an alphanumeric Bre-B-issued identifier, or a merchant code. When someone wants to send you money, they enter your key in their banking app, and Bre-B looks it up and routes the payment to your account.
You will use payment keys in two ways: registering keys for your tenant accounts so they can receive payments, and submitting keys for resolution when your tenant wants to send a payment.
Key types
| Type | Example | Notes |
|---|---|---|
| Cellphone | 3001234567 | Colombian mobile number only. Exactly 10 digits, starts with 3. No country code, no +, no spaces. Regex ^3\d{9}$. |
| Document | 21482961 | Identification number only — no CC/CE/NIT prefix, no separators. 1–18 alphanumeric characters (passports accepted). Regex ^[A-Za-z0-9]{1,18}$. |
| user@example.com | Local part 1–30 chars (no whitespace, no @); domain 1–61 chars of [A-Za-z0-9.-]. Regex ^[^\s@]{1,30}@[A-Za-z0-9.-]{1,61}$. | |
| Alphanumeric | @user123 | Bre-B-issued identifier. Starts with @, followed by 5–20 alphanumeric chars. Useful when the user does not want to reveal personal data. Regex ^@[A-Za-z0-9]{5,20}$. |
| Merchant code | 0012345678 | 10 digits, starts with 00. Identifies registered merchants on Bre-B. Regex ^00\d{8}$. |