Prefunded Accounts

Prefunded accounts enable you to pre-load funds by depositing funds into a wallet. You may then send funds out to your users using this balance without waiting for source funds to post effectively speeding transaction time.

Viewing a Prefunded Account

# REQUEST
curl --request GET \
     --url 'https://api.bridge.xyz/v0/prefunded_accounts' \
     --header 'Api-Key: <Api-Key>' \
     --header 'accept: application/json'

// RESPONSE
{ 
  "data": [
    "id": "f3782fe6-7478-4bab-b472-f1b9628ddc90"
    "available_balance": "100000.0",
    "currency": "usd",
    "name": "human-readable-name"
  ]
}

Check the balance of a specific PrefundedAccount

curl --request GET  
     --url '<https://api.bridge.xyz/v0/prefunded_accounts/><ID>'  
     --header 'Api-Key: <Api-Key>'  
     --header 'accept: application/json

// REPSONSE
{
  "id": "f3782fe6-7478-4bab-b472-f1b9628ddc90"
  "available_balance": "100000.0",
  "currency": "usd",
  "name": "human-readable-name"
}

Using for a Transfer

To use the PrefundedAccount as a source of a transfer, simply reference the prefunded account ID in the source data of the API.

Additional context can be found on bridges public documentation for transfers. https://apidocs.bridge.xyz/docs/fitat-to-stablecoin-crypto-on-ramp

Use the PrefundedAccount for sending to a wallet

// REQUEST
curl --location --request POST 'https://api.bridge.xyz/v0/transfers' \
--header 'Api-Key: <API Key>' \
--header 'Idempotency-Key: <Unique Idempotency Key>' \
--header 'accept: application/json' \
--header 'Content-Type: application/json' \
--data-raw '{
  "amount": "10.0",
  "on_behalf_of": "54120594-f1f8-46da-bc30-ffffea042272",
  "developer_fee": "0.5",
  "source": {
    "payment_rail": "prefunded",
    "currency": "usd",
    "prefunded_account_id": "f3782fe6-7478-4bab-b472-f1b9628ddc90"
  },
  "destination": {
    "payment_rail": "ethereum",
    "currency": "usdc",
    "to_address": "0xdeadbeef"
  },
}'

// RESPONSE
{
  "id": "ddcfbccb-b708-4461-8330-a02d9b5e8818",
  "state": "in_review",
  "on_behalf_of": "54120594-f1f8-46da-bc30-ffffea042272",
  "amount": "10.0",
  "developer_fee": "0.5",
  "source": {
    "payment_rail": "prefunded",
    "currency": "usd"
    "prefunded_account_id": "f3782fe6-7478-4bab-b472-f1b9628ddc90"
  },
  "destination": {
    "payment_rail": "polygon",
    "currency": "usdc",
    "to_address": "0xdeadbeef"
  },
  "receipt": {
    "initial_amount": "10.0",
    "developer_fee": "0.5",
    "exchange_fee": "0.0",
    "subtotal_amount": "9.5",
    "final_amount": "9.5"
  },
  "created_at": "2023-05-05T19:39:14.316Z",
  "updated_at": "2023-05-05T19:39:15.231Z"
}