The Counterparties module is your central hub for managing all entities involved in money movements through Cobre. Whether you're sending funds to suppliers, collecting from customers, or managing internal transfers, counterparties represent the individuals and businesses on the other side of every transaction.What makes Cobre's counterparty management powerful:Unified management across markets: Handle Colombian and Mexican accounts from a single interface
Pre-transaction validation: Verify account ownership before sending funds to reduce rejections
Automated collections: Set up direct debit authorizations for recurring payments
Flexible organization: Customize your view with dynamic columns to match your workflow
This guide covers everything you need to effectively manage counterparties, from basic creation through advanced features like account verification and direct debit registration.
Key Concepts#
What is a Counterparty?#
A counterparty is any entity—individual or company—that participates in your financial transactions. They can act as:Beneficiaries: Entities receiving funds from your organization
Sources: Entities providing funds to your organization
Every money movement in Cobre requires a counterparty, making proper management essential for smooth operations.Supported Account Types#
Ahorros (Savings): Personal savings accounts
Corriente (Checking): Business and personal checking accounts
Depósito Electrónico (Electronic Deposit): Digital wallet-style accounts
R2P (Request to Pay): Payment request system for collections
Cobre Balance: Internal Cobre accounts for instant transfers
CLABE: Standard 18-digit Mexican bank account identifier
SPEI Card: Card-based payment system for retail transactions
Global Deposit - Natural Person: Blockchain wallet accounts for individual recipients, containing all necessary wallet information for digital asset transfers
Global Deposit - Legal Entity: Blockchain wallet accounts for companies or organizations, designed for corporate digital asset transactions
Counterparties Home#
The Counterparties Home provides a unified table displaying all your counterparties with powerful search and filtering capabilities.Navigation#
Access Counterparties from the main sidebar. The home screen displays your complete counterparty list with key information at a glance.Default View#
Alias: Your custom name for the counterparty
Name: Legal or registered name
Account Type: The type of account (CLABE, Savings, R2P, etc.)
Account Number: The account identifier (when applicable)
ID: Cobre's unique counterparty identifier
Creation Date: When the counterparty was added
Customizing Your View#
Tailor the information displayed to match your workflow using dynamic columns.1.
Click Edit columns in the top right of the table
2.
Check or uncheck columns to show or hide:Document (type and number)
3.
Your selection is saved automatically and persists across sessions
Focus on information relevant to your role
Reduce visual clutter for faster navigation
Match your internal processes and reporting needs
Restore defaults: Click "Restore default columns" at the bottom of the column editor to return to the original view.
Search and Filters#
Search: Use the search bar to quickly find counterparties by alias, name, or account details.Filters: Apply filters by clicking the filter buttons:Account country: Colombia or Mexico
Account type: Filter by specific account types
Creating a Counterparty#
Create counterparties to establish entities you'll transact with regularly. Proper setup ensures smooth operations and reduces transaction failures.Step-by-Step Creation#
1. Initiate Creation#
1.
Navigate to Counterparties in the sidebar
2.
Click + Create counterparty in the top right
2. Enter Account Details#
Add a recognizable name (up to 256 characters)
Example: "Payroll Account" or "Supplier - ACME Corp"
This is for your internal reference only
Select Colombia, México, or Global
This determines available account types
Choose from geography-specific options:| Country | Available Account Types |
|---|
| Colombia | Checking (cc), Savings (ch), Electronic Deposit (dp), Cobre Balance, R2P |
| México | CLABE, SPEI Card |
| Global | Global Deposit - Natural Person, Global Deposit - Legal Entity |
For R2P and Cobre Balance, account numbers are auto-generated
For other types, you'll enter the account number manually
Enter the counterparty's account number
CLABE accounts require 18 digits
Other types vary by account format
For Global Counterparties (Additional Fields):Blockchain: Select the network for the wallet
Wallet Address: Enter the wallet address
Confirm Wallet Address: Re-enter to confirm
Description (Optional): Add context for the counterparty
3. Add Counterparty Details#
| Field | Description |
|---|
| Counterparty Name | Legal or registered name (must match banking records) |
| Document Type | CURP, RFC (Mexico) or Cédula, NIT (Colombia) |
| Document Number | Identification number exactly as registered |
| Phone Number (Optional) | Include country code |
| Email Address (Optional) | For transaction confirmations |
For Global Counterparties:| Field | Description |
|---|
| Nationality | Select the counterparty's nationality |
| Account Holder's First Name | Legal first name |
| Account Holder's Last Name | Legal last name |
| Document Type | See allowed identifications below |
| Document Number | Identification number exactly as registered |
| Date of Birth | Select date of birth |
| Account Country | Residence country |
| State/Province | Enter state or province |
| City | Enter city |
| Address | Street and number |
Allowed Identifications (Global)| Type | Description |
|---|
| CC | Colombia: Cédula de Ciudadanía |
| NIT | Colombia: Número de Identificación Tributaria |
| CE | Colombia: Cédula de Extranjería |
| PA | Passport |
| RFC | Mexico: Registro Federal de Contribuyentes |
| CURP | Mexico: Clave Única de Registro de Población |
| TIN | United States: Taxpayer Identification Number |
| CUIL | Argentina: Código Único de Identificación Laboral |
| CUIT | Argentina: Clave Única de Identificación Tributaria |
| CPF | Brazil: Cadastro de Pessoas Físicas |
| CNPJ | Brazil: Cadastro Nacional da Pessoa Jurídica |
4. Account Validation (Mexico Only)#
For Mexican CLABE accounts, you can enable "Validate account after creation":Cobre will verify the account details against financial institution records
Validation results appear in Account Validations
Reduces the risk of rejected transfers due to incorrect information
5. Create#
1.
Review all information carefully
3.
The counterparty becomes immediately available for transactions
Important Notes#
Immutable records: Once created, counterparty details cannot be edited. Create a new counterparty if changes are needed.
No creation limits: Add as many counterparties as your operations require.
Unique identifiers: Each counterparty receives a unique Cobre ID for tracking.
Idempotency: The system verifies the existence of the counterparty before creation by checking a combination of fields to prevent duplicates.
Account Verification#
Account verification helps you validate Mexican CLABE account ownership before initiating transfers, significantly reducing payment rejections and ensuring compliance.Available for: Mexican CLABE accounts only
Why Verify Accounts?#
Reduce rejections: Confirm account details match banking records before sending funds
Improve accuracy: Catch typos or outdated information early
Enhance compliance: Verify beneficiary identity for regulatory requirements
Save time: Avoid failed transactions and the delays they cause
How Verification Works#
When you submit a verification request, Cobre queries the financial institution to confirm:The CLABE account exists and is active
The account holder's name matches the provided information
The document number corresponds to the account holder
| Result | Description |
|---|
| Matched | Account details fully validated |
| Unmatched | Account exists but details don't match |
| Unresolved | Verification couldn't be completed (institution unavailable or timeout) |
Creating a Verification#
From the Counterparties module:1.
Navigate to Counterparties → Validations
3.
Enter the required information:Account Number: 18-digit CLABE
Document Type: CURP or RFC
Document Number: As registered with the bank
External Reference (Optional): Your internal tracking ID
4.
Submit the verification request
During counterparty creation:When creating a Mexican CLABE counterparty, check "Validate account after creation" to automatically verify the account once it's created.Verification Status Tracking#
All verification requests appear in the Validations list with their current status:| Status | Description |
|---|
| Pending | Verification in progress |
| Matched | Successfully verified |
| Unmatched | Details don't match banking records |
| Unresolved | Could not complete verification |
Operating Hours#
Account verification services follow Mexican banking hours:Business Days: 7:00 AM – 6:00 PM (Mexico City time)
Non-Business Days: 7:00 AM – 4:00 PM (Mexico City time)
Requests submitted outside these hours will be processed when services resume.Best Practices#
Verify accounts during peak banking hours for fastest response
Allow at least 1 hour between retry attempts for the same account
Excessive retries may result in more Unresolved responses
Handling unmatched results:Double-check the document number for typos
Confirm the account holder's legal name matches exactly
Contact the counterparty to verify their banking information
Create a new counterparty record with corrected information
Handling unresolved results:Wait for banking hours if outside operating times
Retry after 1-2 hours if during business hours
Contact Cobre support if issues persist
Important Considerations#
Geography limitation: Only available for Mexican CLABE accounts
Response times: Depend on the counterparty's financial institution
No guarantee: Verification success doesn't guarantee transfer success, but significantly improves odds
External reference tracking: Coming soon—external IDs will be visible in the main validations list
Deleting Counterparties#
Remove counterparties that are no longer needed to keep your list organized and current.Deletion Process#
1.
Locate the counterparty in Counterparties Home
2.
Click the kebab menu (⋮) beside the counterparty's name
3.
Select Delete Counterparty
Important Considerations#
Admin only: Only users with Admin role can delete counterparties
Permanent action: Deletions cannot be undone
Historical records: Past transaction records remain intact and visible
Active transactions: Ensure no pending or scheduled transactions reference the counterparty before deletion
Frequently Asked Questions#
General#
Can I modify counterparty details after creation?
No, counterparty information is immutable to maintain audit integrity. Create a new counterparty with the correct information if changes are needed.Are there limits to how many counterparties I can create?
No, there are no restrictions on the number of counterparties you can add.Can I export my counterparty list?
Export functionality is coming soon. Contact support if you need a counterparty export in the interim.What happens to transaction history if I delete a counterparty?
Historical transaction records remain intact and accessible. Only the counterparty record itself is removed from your active list.What's the difference between Name and Alias?Name: The legal or registered name that must match banking records
Alias: Your internal nickname or reference for easy identification
Global Counterparties#
What are Global counterparties?
Global counterparties are entities with blockchain wallet addresses that allow you to send and receive digital assets across borders without traditional banking infrastructure.What's the difference between Global Deposit Natural Person and Global Deposit Legal Entity?Global Deposit Natural Person: Used for individual recipients who hold personal wallets
Global Deposit Legal Entity: Used for companies or organizations that hold corporate wallets
What identification types are accepted for Global counterparties?
Global counterparties support a wide range of identification documents including: CC (Colombia), NIT (Colombia), CE (Colombia), Passport, RFC (Mexico), CURP (Mexico), TIN (United States), CUIL (Argentina), CUIT (Argentina), CPF (Brazil), and CNPJ (Brazil).What information is required to create a Global counterparty?
You'll need to provide: blockchain network, wallet address, the holder's full name, nationality, document type and number, date of birth, and complete address information (country, state/province, city, and street address).Why do I need to confirm the wallet address twice?
Double-entry confirmation helps prevent errors when entering wallet addresses. Blockchain transactions are irreversible, so verifying the address ensures funds are sent to the correct destination.Can I use Global counterparties for traditional bank transfers?
No, Global counterparties are specifically designed for blockchain-based transactions. For traditional bank transfers, create a counterparty with the appropriate country (Colombia or México) and account type.Account Verification#
Why can't I verify Colombian accounts?
Account verification is currently available only for Mexican CLABE accounts. Support for additional account types is planned for future releases.How long does account verification take?
Most verifications complete within seconds during banking hours. Unresolved responses typically indicate the institution is temporarily unavailable—wait 1-2 hours and retry.
Getting Support#
For assistance with counterparty management:Access the Help Center from the Portal
Contact the Cobre support team directly
Modified at 2026-01-15 15:13:50