Skip to main content

Documentation Index

Fetch the complete documentation index at: https://apidocs.bridge.xyz/llms.txt

Use this file to discover all available pages before exploring further.

You can issue a virtual or physical card that spends directly from a Bridge-managed wallet or external crypto wallet. Here’s how to set that up.
1

Step 1: Prepare a Bridge wallet

​
Create a wallet

First, create a Bridge wallet (optional if you’re using an external wallet). Use the wallet’s address when issuing a card.
Request
curl --request POST \
  --url https://api.bridge.xyz/v0/customers/<customer_id>/wallets \
  --header 'Api-Key: <API Key>' \
  --header 'Idempotency-Key: <idempotency-key>' \
  --header 'Content-Type: application/json' \
  --data '{
    "chain": "solana"
  }'
Response
{
  "id": "wallet_abc123",
  "address": "4oG1sWkP8vcrnhbkzZc1m9RTT2VUjZHKx92qiVFK7FuZ",
  "chain": "solana"
}
Keep note of the wallet ID and address as you will need this in the next step.

​
Fund the wallet

The below example uses Bridge’s transfer API to fund the wallet. There are a variety of methods to fund the wallet using Bridge’s orchestration APIs (virtual accounts, transfers, or liquidation addresses). Learn more at Bridge Wallets.
curl --location --request POST 'https://api.bridge.xyz/v0/transfers' \
--header 'Api-Key: <API Key>' \
--header 'Idempotency-Key: <Unique Idempotency Key>' \
--data-raw '{
  "on_behalf_of": "cust_alice",
  "source": {
    "payment_rail": "ach_push",
    "currency": "usd",
  },
  "destination": {
     "payment_rail": "solana",
     "currency": "usdb",
     "bridge_wallet_id": "wallet_abc123"
     }
     "features": {
       "flexible_amount": true // allows for any deposit amount
 		 }
}'
2

Step 2: Provision a card

Now create a card account tied to a Bridge wallet.
curl --request POST \
     --url https://api.bridge.xyz/v0/customers/customerID/card_accounts \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '{
  "currency": "usdb",
  "chain": "solana",
  "crypto_account": {
    "type": "bridge_wallet",
    "address": "4oG1sWkP8vcrnhbkzZc1m9RTT2VUjZHKx92qiVFK7FuZ"
  }
}'

​
Retrieve card details

Access card metadata, expiration, and access a secure image of the card.
Request
curl -X GET 'https://api.bridge.xyz/v0/customers/<customerID>/card_accounts/<cardAccountID>' \
--header 'Api-Key: <API Key>'
Response
{
  "id": "XXX-YYY",
  "status": "active",
  "card_image_url": "https://...",
  "card_details": {
    "last_4": "1264",
    "expiry": "10/24",
    "bin": "44325280"
  }
}
You can now share these card details with your customer to start spending!
3

Step 3: Make a transaction

Now that you have the details for your card, you can use it to make transactions! Use your Bridge issued card like any normal card in e-commerce checkout flows.
4

Step 4: Monitor transactions

Subscribe to the card_transaction.created webhook to see newly created transactions.
{
  "event_type": "card_transaction.created",
  "event_object": {
    "status": "approved",
    "amount": "-10.25",
    "merchant_name": "ROCKET RIDES",
    "authorized_at": "2025-02-04T05:19:25.000Z"
  }
}
Subscribe to the card_transaction.updated.status_transitioned webhook to see settled transactions.
{
  "event_type": "card_transaction.updated.status_transitioned",
  "event_object": {
    "status": "settled",
    "settled_amount": "-10.25",
    "posted_at": "2025-02-06T03:01:30.000Z"
  },
  "event_object_changes": {
    "status": ["approved", "settled"],
    "settled_amount": [null, "-10.25"],
    "posted_at": [null, "2025-02-06T03:01:30.000Z"]
  }
}
Or you can fetch transactions via the Retrieve card transactions API.

​
Money Movement Overview

​
Resources

Check out the Cards section for more in depth details!