Counterparties

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

Colombia:

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

Mexico:

CLABE: Standard 18-digit Mexican bank account identifier

SPEI Card: Card-based payment system for retail transactions

Global

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.

Access Counterparties from the main sidebar. The home screen displays your complete counterparty list with key information at a glance.

Default View

By default, you'll see:

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.

To customize columns:

Click Edit columns in the top right of the table

Check or uncheck columns to show or hide:

Alias

Name

Account Type

Account Number

Key

Document (type and number)

Phone

Creation Date

Your selection is saved automatically and persists across sessions

Why customize columns?

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

Navigate to Counterparties in the sidebar

Click + Create counterparty in the top right

2. Enter Account Details

Account Alias (Optional)

Add a recognizable name (up to 256 characters)

Example: "Payroll Account" or "Supplier - ACME Corp"

This is for your internal reference only

Account Country

Select Colombia, México, or Global

This determines available account types

Account Type

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

Account Number

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

For Colombia and México:

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

Learn more in the Account Verification section.

5. Create

Review all information carefully

Click Create to finalize

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

Verification results:

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:

Navigate to Counterparties → Validations

Click Create Validation

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

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

Timing:

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

Locate the counterparty in Counterparties Home

Click the kebab menu (⋮) beside the counterparty's name

Select Delete Counterparty

Confirm the deletion

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

Counterparties

Key Concepts#

What is a Counterparty?#

Supported Account Types#

Counterparties Home#

Navigation#

Default View#

Customizing Your View#

Search and Filters#

Creating a Counterparty#

Step-by-Step Creation#

1. Initiate Creation#

2. Enter Account Details#

3. Add Counterparty Details#

4. Account Validation (Mexico Only)#

5. Create#

Important Notes#

Account Verification#

Why Verify Accounts?#

How Verification Works#

Creating a Verification#

Verification Status Tracking#

Operating Hours#

Best Practices#

Important Considerations#

Deleting Counterparties#

Deletion Process#

Important Considerations#

Frequently Asked Questions#

General#

Global Counterparties#

Account Verification#

Getting Support#

Key Concepts

What is a Counterparty?

Supported Account Types

Counterparties Home

Navigation

Default View

Customizing Your View

Search and Filters

Creating a Counterparty

Step-by-Step Creation

1. Initiate Creation

2. Enter Account Details

3. Add Counterparty Details

4. Account Validation (Mexico Only)

5. Create

Important Notes

Account Verification

Why Verify Accounts?

How Verification Works

Creating a Verification

Verification Status Tracking

Operating Hours

Best Practices

Important Considerations

Deleting Counterparties

Deletion Process

Important Considerations

Frequently Asked Questions

General

Global Counterparties

Account Verification

Getting Support