GBP FPS Integration Guide (BETA)

To access GBP and the FPS payment rail, please reach out to our team at [email protected]

🇬🇧 What we support

Virtual Accounts - Accept GBP via Faster Payments from 1st and approved 3rd parties.
Transfers - Receive GBP via Faster Payments payins from 1st and approved 3rd parties, make payouts to any recipient.
Liquidation Addresses. - Offramps from stablecoin or crypto to GBP via Faster Payments.

Faster Payments Endorsement required to use the GBP currency and Faster Payments rail. If a customer already has the base endorsement, they should also have all of the info needed to grant the Faster Payments endorsement.
Create a GBP Virtual Account to onramp funds using a unique account number
Create a GBP External Account to use as a Transfer or Liquidation Address offramp destination.

Transaction Minimums and Limits

Onramp minimum 2 GBP
Offramp minimum 3 GBP
No maximum
1st and 3rd party payouts supported
1st party payins supported, 3rd party payins supported from approved 3rd parties.

Request / Response Examples

External Account
Virtual Account
Transfer Onramp
Transfer Offramp

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": "gbp",
  "account_owner_name": "First Last",
  "first_name": "First",
  "last_name": "Last",
  "account_owner_type": "individual",
  "account": {
    "sort_code": "123456",
    "account_number": "34567890"
  },
  "account_type": "gb"
}'

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",
  "bank_name": "Bank of England",
  "account_name": null,
  "account_owner_name": "Freddie Mercury",
  "active": true,
  "currency": "gbp",
  "account_owner_type": "individual",
  "account_type": "gb",
  "first_name": "Freddie",
  "last_name": "Mercury",
  "business_name": null,
  "account": {
    "sort_code": "123456",
    "account_number": "34567890"
  }

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": "gbp"
  },
  "destination": {
    "currency": "usdc",
    "payment_rail": "base",
    "bridge_wallet_id": "#{request.bridge_wallet_id}"
  }
}'

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": "gbp",
    "account_number": "34567890",
    "sort_code": "123456",
    "account_holder_name": "Bridge Building Sp. Z.o.o.",
    "bank_name": "Banking Circle S.A.",
    "bank_address": "2 Boulevard de la Foire, L-1528 Luxembourg",
    "bank_beneficiary_name": "Bridge Building Sp. Z.o.o.",
    "bank_beneficiary_address": "2 Boulevard de la Foire, L-1528 Luxembourg",
    "payment_rails": [
      "faster_payments"
    ]
  },
  "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": "2.01",
  "source": {
    "currency": "gbp",
    "payment_rail": "faster_payments"
  },
  "destination": {
    "currency": "usdc",
    "payment_rail": "base",
    "bridge_wallet_id": "#{request.bridge_wallet_id}"
  }
}'

Response

{
  "id": "6ccbd781-8859-4944-8d88-66d8a0ff277b",
  "client_reference_id": null,
  "state": "awaiting_funds",
  "on_behalf_of": "485c2b50-949c-412b-928a-f56fce42330d",
  "currency": "gbp",
  "amount": "2.01",
  "developer_fee": "0.0",
  "source": {
    "payment_rail": "faster_payments",
    "currency": "gbp",
    "external_account_id": null
  },
  "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": "2.01",
    "developer_fee": "0.0",
    "exchange_fee": "0.0",
    "subtotal_amount": "2.01",
    "gas_fee": "0.0"
  },
  "developer_fee_percent": "0.0",
  "source_deposit_instructions": {
    "payment_rail": "faster_payments",
    "currency": "gbp",
    "amount": "2.01",
    "deposit_message": "BRGTPU5UDJWN4KW5PJM6",
    "account_number": "34567890",
    "sort_code": "123456",
    "bank_name": "Banking Circle S.A.",
    "bank_address": "2 Boulevard de la Foire, L-1528 Luxembourg"
  }
}

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": {
    "currency": "usdc",
    "payment_rail": "bridge_wallet",
    "bridge_wallet_id": "#{request.bridge_wallet_id}"
  },
  "destination": {
    "amount": "3.00",
    "currency": "gbp",
    "payment_rail": "faster_payments",
    "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": "usd",
  "amount": "4.12",
  "developer_fee": "0.0",
  "source": {
    "payment_rail": "bridge_wallet",
    "currency": "usdc",
    "amount": "4.12",
    "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": "faster_payments",
    "currency": "gbp",
    "amount": "3.0",
    "external_account_id": "bce9dbe4-bca7-42e0-9cc1-7482069019f1"
  },
  "receipt": {
    "initial_amount": "4.12",
    "developer_fee": "0.0",
    "exchange_fee": "0.0",
    "subtotal_amount": "4.12",
    "gas_fee": "0.0"
  },
  "developer_fee_percent": "0.0"
}

Introduction

Guides

GBP FPS Integration Guide (BETA)

🇬🇧 What we support

Transaction Minimums and Limits

Request / Response Examples

Introduction

Guides

​🇬🇧 What we support

​Related APIs

​Transaction Minimums and Limits

​Request / Response Examples

🇬🇧 What we support

Related APIs

Transaction Minimums and Limits

Request / Response Examples