Account Linkeage
Understanding primary and secondary accounts
Valid combinations
Colombia
Mexico
| Secondary account | Secondary allowed type | Secondary allowed provider | Primary account | Primary allowed type | Primary allowed provider | MM Flow | MM type generated |
|---|---|---|---|---|---|---|---|
| account_id | cobre_balance | pr_col_cobre | counterparty_id or account_id | checking (cc), saving (ch), electronic deposit (dp), or Cobre Balance | Any | PUSH | ACH, fast_pay or Bre-B |
Money Movement Flow for Linkage Accounts
1.
2.
transaction_id of the initial credit transaction. If succesful, the following transactions will be posted:Allowed Actions on Account Linkage
🔗 Configure linked accounts
✍️ Assign or change primary accounts
⛓️💥 Unlink primary account
Description: When creating a Cobre Balance account and a primary account is set in the matadata section, the link with the primary account is automatically generated.What to expect after the action: Funds received in the Cobre Balance account will be redirected to the primary account associated during the Cobre Balance creation. 📘 Learn more: 🔗 Create a Cobre Balance
How to Get Started
primary account to a secondary account. This can be done by declaring it within the metadata upon account creationBefore using this API
Select a primary account with a valid provider
This is the Cobre Balance or Counterparty that will automatically receive the funds credited to the Cobre Balance linking it.
Configure, change, or unlink a primary account for the first time
Create a new Cobre Balance whose primary account is the Cobre Balance or Counterparty designated for such purpose.
Subscribe to transaction notifications
Subscribe to the required events to receive notifications about transaction credits or money movement status, such as
accounts.balance.credit or money_movements.status.completedWhat to expect after using this API
Transaction Reception
When transaction is received on the secondary account (e.g., PSE payment in Colombia or a SPEI transfer in Mexico), it will be reflected as a credit transaction (i.e., col_credit in Colombia, spei_credit in Mexico)
Money Movement Processing
After the transaction reception, the secondary account will initiate a Money Movement to the primary account. This money movement will include the
transaction_id of the initial credit transaction (i.e., external_id = transaction_id).2.1 Debit Transaction Posting
A debit transaction will be posted in the secondary account once the money movement is processed. (i.e., col_cb_debit in Colombia Cobre Balances, spei_debit in Mexico Cobre Balances)
2.2 Credit Transaction Posting
A credit transaction will be posted in the primary account reflecting the transfer of funds. (i.e., col_cb_credit in Colombia Cobre Balances, spei_credit in Mexico Cobre Balances)
Modified at 2026-01-09 01:35:43