跳转到主要内容
POST
Resolve Payment Method Requirements
请提交 sessionId、paymentMethod,以及根据要求 schema 收集的 paymentMethodData。如果要求包含 resolution 契约,请使用其中的 method、url、body 和 inputPath。 当 status 为 requires_action 时,请展示 nextStep.schema,并提交 continuation,其中包含返回的 resolutionId、作为 stepId 的 nextStep.id 以及所需数据。重复此流程,直到 status 为 resolved。 会话会保存完整的表单和解析结果。如果收款人信息发生变化,请重新解析支付方式,然后请求报价。

授权

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>
必填

Session ID returned by the v2 rates endpoint.

paymentMethod
string
必填

Payment-method id.

示例:

"bank_transfer"

paymentMethodData
object
必填

Current form values required by the x-resolution request.

示例:
customerId
string<uuid>

ID of an existing active customer owned by the authenticated business.

assetId
string<uuid>
已弃用

Stablecoin asset identifier.

示例:

"ae455f23-3824-4125-baab-d158315cbcbd"

currency
string
已弃用

ISO 4217 payout currency.

Required string length: 3
示例:

"NGN"

amount
string
已弃用

Withdrawal amount as a decimal string.

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

"100.00"

provider
string
已弃用

Provider slug selected earlier in the flow.

示例:

"example-provider"

amountSide
enum<string>
默认值:source

source fixes the total source-asset budget, with fees allocated inside it; target fixes the fiat payout before beneficiary deductions and derives the required source debit.

可用选项:
source,
target
continuation
object

Submit only after requires_action. Keep the original paymentMethodData unchanged.

响应

Successful response.

message
string
必填

Human-readable result.

示例:

"Payment method resolved successfully"

data
object
必填
status
boolean
必填
示例:

true