跳转到主要内容
POST
Master Wallet Get Quote
当存款属于现有客户且需要特定走廊的 KYC 时,请包含 customerId。提供方适配器会根据所选法币货币推断走廊。响应可能包含 data.additionalDataRequirements.schema,以及 data.additionalDataRequirements.data 中可复用的客户值。请将已保存的值用作表单默认值,然后在创建支付订单前填写并验证当前 schema。 有关 schema 的处理流程,请参见 Dynamic Forms。
有关客户身份、会话绑定、审核恢复与费用,请参阅 客户法币流程.

授权

x-api-key
string
header
必填

路径参数

id
string<uuid>
必填

Wallet identifier.

请求体

application/json

Supply sessionId, or all original routing fields. Repeated fields must match the session. Customer identity is inherited from the session.

sessionId
string<uuid>
必填

Existing deposit session. When supplied, the original route values are authoritative.

amountSide
enum<string>
默认值:target

source fixes the total fiat payable; target fixes the crypto amount to settle. Defaults to target.

可用选项:
source,
target
customerId
string<uuid>

Optional existing active customer owned by the authenticated business. Omit for the business-owned flow. Start a new session to change customer identity. For inline KYC, validate saved values against additionalDataRequirements.schema; customer onboarding cannot unlock an inactive business provider.

assetId
string<uuid>

Stablecoin asset identifier returned by the supported-assets endpoint.

示例:

"ae455f23-3824-4125-baab-d158315cbcbd"

currency
string

ISO 4217 fiat currency code.

Required string length: 3
示例:

"NGN"

amount
string

Decimal amount encoded as a string to preserve precision.

Pattern: ^\d+(\.\d+)?$
示例:

"100.00"

rail
enum<string>

Payment collection rail.

可用选项:
one_time_virtual_account,
payment_link,
qr_code
示例:

"one_time_virtual_account"

provider
string

Optional provider slug. Omit it to let Blockradar select an eligible provider.

示例:

"example-provider"

响应

Successful response.

message
string
必填

Human-readable result.

示例:

"Deposit quote fetched successfully"

data
object
必填
status
boolean
必填
示例:

true