COP Integration Guide (Beta)

To access COP and the Bre-b and Bank Transfer payment rail, please reach out to our team at sales@bridge.xyz

🇨🇴 What we support

Virtual Accounts - Deposit COP via Bre-B and receive payments from 3rd party businesses.
Transfers - Onramp COP via Bre-B and Bank Transfers as a 1st party or from 3rd party businesses, offramp to any recipient.
Liquidation Addresses - Offramps from stablecoin or crypto to COP via Bre-B and Bank Transfer
Supported Countries - We support COP on/offramps for customers in +100 countries.

COP Endorsement required to use the COP currency. If a customer already has the base endorsement, they should also have all of the info needed to grant the COP endorsement.
Coming Soon: a COP Virtual Account to onramp funds using a Bre-b key.
Create a COP External Account to use as a Transfer or Liquidation Address offramp destination.

Transaction Minimums, Limits, Times

Onramp minimum 100 COP
Offramp minimum 100 COP
No maximum
- Bre-B transactions greater than 11,552,000 COP will be sent as a Bank Transfer.
1st and 3rd party payouts supported
1st party payins supported, 3rd party payins supported from businesses.
COP Bre-b and Bank Transfers complete in ~3 minutes however may take up to 30 minutes for larger values.

Request / Response Examples

External Account (Bre-B)
Virtual Account (Bre-B)
Transfer Onramp (Bre-B)
Transfer Offramp (Bre-B)

Request

curl --request POST \
  --url https://api.bridge.xyz/v0/customers/#{request.customer_id}/external_accounts \
  --header 'Api-Key: #{api_key}' \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: #{request.idempotency_key}' \
  --data '
{
  "currency": "cop",
  "account_type": "bre_b",
  "account_owner_name": "First Last",
  "account_owner_type": "individual",
  "account": {
    "bre_b_key": "1234567890123456"
  }
}'

Response

{
  "id": "bce9dbe4-bca7-42e0-9cc1-7482069019f1",
  "customer_id": "485c2b50-949c-412b-928a-f56fce42330d",
  "created_at": "2026-01-05T23:54:57.715Z",
  "updated_at": "2026-01-05T23:54:58.201Z",
  "account_owner_name": "Freddie Mercury",
  "active": true,
  "currency": "cop",
  "account_owner_type": "individual",
  "account_type": "bre_b",
  "account": {
    "bre_b_key": "1234567890123456"
  }

Request

curl --request POST \
  --url https://api.bridge.xyz/v0/customers/#{request.customer_id}/virtual_accounts \
  --header 'Api-Key: #{api_key}' \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: #{request.idempotency_key}' \
  --data '
{
  "developer_fee_percent": "0.0",
  "source": {
    "currency": "cop"
  },
  "destination": {
    "currency": "usdc",
    "payment_rail": "base",
    "address": "0xd0f43e6c8ee12ae4fe9d892c66c80dcb925f5d7c"
  }
}'

Response

{
  "id": "65e93b85-ccf7-4c0b-a327-0cf80749e360",
  "status": "activated",
  "developer_fee_percent": "0.0",
  "customer_id": "485c2b50-949c-412b-928a-f56fce42330d",
  "created_at": "2026-01-03T00:23:23.724Z",
  "source_deposit_instructions": {
    "currency": "cop",
    "payment_rails": [
      "bre_b"
    ]
    "breb_key": "12345678901234567890",
    "account_holder_name": "Bridge Developer Name",
    "deposit_message": "COP7depositmessage"
  },
  "destination": {
    "currency": "usdc",
    "payment_rail": "base",
    "address": "0xd0f43e6c8ee12ae4fe9d892c66c80dcb925f5d7c"
  }
}'

Request

curl --request POST \
  --url https://api.bridge.xyz/v0/transfers \
  --header 'Api-Key: #{api_key}' \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: #{request.idempotency_key}' \
  --data '
{
  "developer_fee_percent": "0.0",
  "on_behalf_of": "#{request.customer_id}",
  "amount": "20000",
  "source": {
    "currency": "cop",
    "payment_rail": "bre_b"
  },
  "destination": {
    "payment_rail": "base",
    "currency": "usdc",
    "to_address": "0xd0f43e6c8ee12ae4fe9d892c66c80dcb925f5d7c"
  }
}'

Response

{
  "id": "6ccbd781-8859-4944-8d88-66d8a0ff277b",
  "client_reference_id": null,
  "state": "awaiting_funds",
  "on_behalf_of": "485c2b50-949c-412b-928a-f56fce42330d",
  "currency": "cop",
  "amount": "20000",
  "developer_fee": "0.0",
  "source": {
    "payment_rail": "bre_b",
    "currency": "cop",
  },
  "created_at": "2026-01-05T19:38:43.480Z",
  "updated_at": "2026-01-05T19:38:43.780Z",
  "destination": {
    "payment_rail": "base",
    "currency": "usdc",
    "to_address": "0xd0f43e6c8ee12ae4fe9d892c66c80dcb925f5d7c"
  },
  "receipt": {
    "initial_amount": "20000",
    "developer_fee": "0.0",
    "exchange_fee": "0.0",
    "subtotal_amount": "20000",
    "gas_fee": "0.0"
  },
  "developer_fee_percent": "0.0",
  "source_deposit_instructions": {
    "payment_rail": "bre_b",
    "currency": "cop",
    "amount": "20000",
    "deposit_message": "COP7depositmessage",
    "breb_key": "34567890",
    "account_holder_name": "Bridge Developer Name"
  }
}

Request

curl --request POST \
  --url https://api.bridge.xyz/v0/transfers \
  --header 'Api-Key: #{api_key}' \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: #{request.idempotency_key}' \
  --data '
{
  "developer_fee_percent": "0.0",
  "on_behalf_of": "#{request.customer_id}",
  "source": {
    "amount": "100",
    "currency": "usdc",
    "payment_rail": "bridge_wallet",
    "bridge_wallet_id": "#{request.bridge_wallet_id}"
  },
  "destination": {
    "currency": "cop",
    "payment_rail": "bre_b",
    "external_account_id": "#{request.external_account_id}"
    "reference": "abcdefghijklmnopqr" // maximum 18 characters 
  }
}'

Response

{
  "id": "e94b1961-cf77-44db-a66f-07981f03fb1f",
  "client_reference_id": null,
  "state": "payment_submitted",
  "on_behalf_of": "485c2b50-949c-412b-928a-f56fce42330d",
  "currency": "usdc",
  "amount": "100",
  "developer_fee": "0.0",
  "source": {
    "payment_rail": "bridge_wallet",
    "currency": "usdc",
    "amount": "100",
    "from_address": "0xd0f43e6c8ee12ae4fe9d892c66c80dcb925f5d7c",
    "bridge_wallet_id": "d017bf1d-8372-4294-94ac-afd0cbc6357d"
  },
  "created_at": "2026-01-06T17:29:22.796Z",
  "updated_at": "2026-01-06T17:29:22.874Z",
  "destination": {
    "payment_rail": "bre_b",
    "currency": "cop",
    "amount": "370000",
    "external_account_id": "bce9dbe4-bca7-42e0-9cc1-7482069019f1"
  },
  "receipt": {
    "initial_amount": "100",
    "developer_fee": "0.0",
    "exchange_fee": "0.0",
    "subtotal_amount": "100",
    "gas_fee": "0.0",
    "final_amount": "370000",

  },
  "created_at": "2020-01-01T00:00:00.000Z",
  "updated_at": "2020-01-02T00:00:00.000Z"
}

Introduction

Guides

COP Integration Guide (Beta)

🇨🇴 What we support

Transaction Minimums, Limits, Times

Request / Response Examples

Introduction

Guides

​🇨🇴 What we support

​Related APIs

​Transaction Minimums, Limits, Times

​Request / Response Examples

🇨🇴 What we support

Related APIs

Transaction Minimums, Limits, Times

Request / Response Examples