Crear una Cuenta Bancaria Virtual para On-Ramp de Fiat

curl --request POST \ --url https://api.spherepay.co/v2/virtual-account \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data ' { "customerId": "customer_b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7", "sourceCurrency": "usd", "destinationCurrency": "usdc", "network": "ethereum", "walletAddress": "0x4838B106FCe9647Bdf1E7877BF73cE8B0BAD5f97" } '

{ "id": "virtualAccount_a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6", "customer": "customer_b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7", "active": true, "depositInstructions": { "currency": "usd", "bankName": "Lead Bank", "bankAddress": "1801 Main St, Kansas City, MO 64108", "bankAccountNumber": "9876543210", "bankRoutingNumber": 21000089, "bankBeneficiaryName": "Bridge Financial Inc.", "bankBeneficiaryAddress": "123 Finance St, San Francisco, CA 94105", "iban": "DE89370400440532013000", "bic": "COBADEFFXXX" }, "destination": { "currency": "usdc", "walletAddress": "0x4838B106FCe9647Bdf1E7877BF73cE8B0BAD5f97", "network": "ethereum" }, "fee": { "totalBpsRate": "130", "integratorFee": { "bpsRate": "100" }, "platformFee": { "bpsRate": "30" } }, "created": "2025-01-15T10:30:00.000Z", "updated": "2025-01-15T12:00:00.000Z" }

Autorizaciones

Authorization

string

header

requerido

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Cuerpo

application/json

customerId

string

requerido

The customer who will own the virtual account.

Ejemplo:

"customer_b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7"

sourceCurrency

enum<string>

requerido

The fiat currency the virtual account accepts for deposits.

Opciones disponibles:

usd,

eur

Ejemplo:

"usd"

destinationCurrency

enum<string>

requerido

The crypto currency deposited funds are converted into. See Supported Rails & Currencies.

Opciones disponibles:

usdc,

usdt,

eurc

Ejemplo:

"usdc"

network

enum<string>

requerido

The blockchain network the destination wallet is on. See Supported Rails & Currencies.

Opciones disponibles:

arbitrum,

avalanche,

base,

ethereum,

polygon,

sol,

tron

Ejemplo:

"ethereum"

walletAddress

string

requerido

The on-chain wallet address where converted crypto is sent. Must be valid for the selected network.

Ejemplo:

"0x4838B106FCe9647Bdf1E7877BF73cE8B0BAD5f97"

integratorFeeBps

string

Integrator fee in basis points (1 bps = 0.01%). Defaults to 0 if not provided.

Ejemplo:

"100"

Respuesta

string

requerido

Unique identifier for the virtual account.

Ejemplo:

"virtualAccount_a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6"

active

boolean

requerido

Whether the virtual account is currently active and accepting deposits.

Ejemplo:

true

depositInstructions

object

requerido

Bank account details that depositors should use to send fiat funds into the virtual account.

Show child attributes

destination

object

requerido

The crypto destination where converted funds are sent after deposit.

Show child attributes

created

string

requerido

Timestamp when the virtual account was created (ISO 8601).

Ejemplo:

"2025-01-15T10:30:00.000Z"

updated

string

requerido

Timestamp when the virtual account was last updated (ISO 8601).

Ejemplo:

"2025-01-15T12:00:00.000Z"

customer

string

The customer ID who owns the virtual account.

Ejemplo:

"customer_b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7"

fee

object

Fee breakdown for the virtual account, including integrator and platform fees.

Show child attributes