Skip to main content
POST

授权

Authorization
string
header
必填

会话 JWT(来自注册/登录)或 API key(pk_...)。 也接受 X-API-Key: <token> 作为替代请求头。

请求头

Idempotency-Key
string

idempotency_key 请求体字段的替代方式。

请求体

application/json
currency
string
必填
示例:

"USD"

type
enum<string>
必填
可用选项:
TRANSFER,
WITHDRAW
sourceRequisit
object
必填
destinationRequisit
object
必填
amount
object
必填
paymentType
string

TRANSFER 时为空;WITHDRAW 时为通道代码(例如 SEPA_CT)。

comment
string
source_virtual_iban_id
string<uuid>

用于 EUR SEPA Banking 提现的 active banking_eur 虚拟 IBAN,可选。只有一个 active 来源时可省略;多个来源时必须发送该 UUID。平台从 vIBAN registrant 写入 payer。

source_instrument_id
string<uuid>

用于 BO/BOB QR payout 的活跃 banking 工具 UUID。

beneficiary_type
enum<string>

EUR SEPA 提现必填;个人使用 individual,企业使用 corporate。其他银行通道可选。

可用选项:
individual,
corporate
beneficiary_given_name
string

结构化 EUR SEPA 个人受益人必填,并且必须与 beneficiary_first_surname 同时提供;其他银行通道可选。

beneficiary_first_surname
string

结构化 EUR SEPA 个人受益人必填,并且必须与 beneficiary_given_name 同时提供;其他银行通道可选。

beneficiary_middle_name
string

EUR SEPA 个人受益人的可选中间名;其他银行通道可选。

beneficiary_name
string

EUR SEPA 企业受益人的公司名称必填;多词值也可作为个人姓名兼容 fallback。其他银行通道可选。

idempotency_key
string

响应

既有操作的幂等重放(不产生新扣费)。

The response is of type object.