Create a Cross Boder Money Movement

Creating cross-border money movements allows you to transfer funds between accounts located in different geographies.

To do this, follow the steps below:

FX Quote

You must have previously created an FX quotation using the currency pair of your interest.

Funding the operation

You must fund the operation if required (this applies to static quotes).

Create the money movement

Link the source account (which already has funds or will be funded later) with the destination account that will receive the funds.

Valid account combinations

Below are the valid source and destination account combinations supported to create cross-border money movements.

🇺🇸 USD

🇲🇽 MXN

🇨🇴 COP

FX Quote Currency Pair	Source	Source type	Destination	Destination type
`USD/COP`	account_id	Cobre Balance Global – USD (type: `cobre_balance`)	account_id	Cobre Balance Colombia (type: `cobre_balance`)
`USD/MXN`	account_id	Cobre Balance Global – USD (type: `cobre_balance`)	account_id	Cobre Balance Mexico (type: `clabe`)

Status Transitions (How to reason about the lifecycle)

Static Quotes

Rolling Quotes

Here is the conceptual state diagram (simplified):

initiated → processing

initiated → pending_approval (checker_approval = true)

pending_approval → processing (decision: approved)

pending_approval → canceled (decision: denied)

processing → completed

processing → failed / rejected

Actions performed on a Cross-Border Money Movement

📌 Create

🔍 Retrieval

Description: Create Cross-Border Money Movement
What to expect: A cross-border money movement object is created for the amount defined in the previously generated FX quote.

Don’t forget to subscribe to the required events to always stay informed about money movement status changes.

How to Get Started

Before using this API

Create an FX Quote

Create either a static_quote or rolling_quote.
See FX Quotation API

Create Cobre Balance accounts

Create the source and destination accounts using a valid combination.
See Cobre Balance API.

Create a Cross-Border Money Movement

Using the FX quote ID created in the previous step, provide the source and destination accounts to create a cross-border money movement.
See Cross-Border API.

What to expect after using this API

Cross-border money movement creation

A cross-border money movement object will be created in initiated status, including FX quote instructions and linked source and destination account details.
See Cross-Border API.

Transaction creation

Once the movement reaches completed status, the following transactions are created:

cbmm_debit on the source account

cbmm_credit on the destination account
See Account Transactions API.

Create a Cross Boder Money Movement

Valid account combinations#

Status Transitions (How to reason about the lifecycle)#

Actions performed on a Cross-Border Money Movement#

How to Get Started#

Before using this API#

What to expect after using this API#

Valid account combinations

Status Transitions (How to reason about the lifecycle)

Actions performed on a Cross-Border Money Movement

How to Get Started

Before using this API

What to expect after using this API