> ## 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.
# GBP integration guide
> On and offramp with GBP using Faster Payments
To access GBP and the FPS payment rail, please reach out to our team at [sales@bridge.xyz](mailto:sales@bridge.xyz)
## 🇬🇧 What we support
* [Virtual Accounts](https://apidocs.bridge.xyz/platform/orchestration/virtual_accounts/virtual-account#gbp) - Deposit GBP via Faster Payments and receive payments from 3rd party businesses.
* [Transfers](https://apidocs.bridge.xyz/platform/orchestration/transfers/transfer#create-transfer) - Onramp GBP via Faster Payments as a 1st party or from 3rd party businesses, offramp to any recipient.
* [Liquidation Addresses](https://apidocs.bridge.xyz/platform/orchestration/liquidation_address/liquidation_address#multichain-%2B-multicurrency) - Offramps from stablecoin or crypto to GBP via Faster Payments.
* [Supported Countries](https://apidocs.bridge.xyz/platform/customers/compliance/supported-countries-list) - We support GBP on/offramps for customers in +100 countries.
## Related APIs
* [Faster Payments Endorsement](https://apidocs.bridge.xyz/platform/customers/customers/endorsements#pix-endorsement) required to use the GBP currency and Faster Payments rail. If a customer already has the SEPA endorsement, they should also have all of the info needed to grant the Faster Payments endorsement.
* Create a [GBP Virtual Account](https://apidocs.bridge.xyz/platform/orchestration/virtual_accounts/virtual-account#brl) to onramp funds using a unique account number
* Create a [GBP External Account](https://apidocs.bridge.xyz/platform/orchestration/external-accounts/external-accounts-api#gbp-fps) to use as a [Transfer](https://apidocs.bridge.xyz/platform/orchestration/transfers/transfer#create-transfer) or [Liquidation Address](https://apidocs.bridge.xyz/platform/orchestration/liquidation_address/liquidation_address#multichain-%2B-multicurrency) offramp destination.
## Logistics
* **Onramp minimum £2.00 GBP**
* **Offramp minimum 3.00 of the source currency**
* No maximum, transfers received or sent over £1M GBP will use the BACS payment rail.
* 1st and 3rd party payouts supported
* 1st party payins supported, 3rd party payins supported from businesses.
* Faster Payments complete in \~5 minutes however may take up to 30 minutes for larger values.
* BACS payments complete in 3 business days.
## **Request / Response Examples**
```bash Request expandable theme={null}
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",
"bank_name": "Bank of England",
"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"
}'
```
```json Response expandable theme={null}
{
"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"
}
```
```bash Request expandable theme={null}
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}"
}
}'
```
```curl Response theme={null}
{
"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"
}
}'
```
```bash Request expandable theme={null}
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}"
}
}'
```
```json Response expandable theme={null}
{
"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"
}
}
```
```bash Request expandable theme={null}
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
}
}'
```
```json Response expandable theme={null}
{
"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"
}
```