{
"operation_id": "7e8a9b0c-1d2e-3f4a-5b6c-7d8e9f0a1b2c",
"provider_id": "BNK-OP-90213",
"status": "pending",
"idempotency_key": "platform:9b1deb4d:acme-payment-0071",
"data": {
"type": "WITHDRAW",
"paymentType": "SEPA_CT"
},
"idempotency_hit": true
}{
"operation_id": "7e8a9b0c-1d2e-3f4a-5b6c-7d8e9f0a1b2c",
"provider_id": "BNK-OP-90213",
"status": "pending",
"idempotency_key": "platform:9b1deb4d:acme-payment-0071",
"data": {
"type": "WITHDRAW",
"paymentType": "SEPA_CT"
},
"banking_fee": "2.000000",
"banking_fee_asset": "BANK_EUR"
}{
"error": "idempotency_key_required",
"message": "provide idempotency_key (body or Idempotency-Key header)"
}{
"error": "unauthorized",
"message": "invalid or missing credentials"
}{
"error": "insufficient_funds",
"message": "account balance is not enough for this operation"
}{
"error": "no_banking_customer",
"message": "create your banking customer first (POST /v1/banking/customer)"
}{
"error": "funding_account_required",
"message": "an active EUR funding account is required to send to Europe"
}{
"error": {
"code": "banking_request_failed",
"message": "request rejected"
}
}发送银行付款
执行 TRANSFER(你自己的银行账户之间)或 WITHDRAW(至已登记的受益人)。必须提供幂等键;使用相同键重试会返回原始操作而不重复扣费。按固定 banking_operation 费用计费;若通道拒绝则退款。最终状态通过 banking_operation_status_changed webhook 送达。 对于 EUR SEPA 提现,顶层 beneficiary_* 字段提供用于构建 provider payee 的结构化受益人身份。 这些字段对其他银行通道是可选的;如果 EU-SEPA 目的地没有可用的 payee 身份,API 返回 400 invalid_payload。
{
"operation_id": "7e8a9b0c-1d2e-3f4a-5b6c-7d8e9f0a1b2c",
"provider_id": "BNK-OP-90213",
"status": "pending",
"idempotency_key": "platform:9b1deb4d:acme-payment-0071",
"data": {
"type": "WITHDRAW",
"paymentType": "SEPA_CT"
},
"idempotency_hit": true
}{
"operation_id": "7e8a9b0c-1d2e-3f4a-5b6c-7d8e9f0a1b2c",
"provider_id": "BNK-OP-90213",
"status": "pending",
"idempotency_key": "platform:9b1deb4d:acme-payment-0071",
"data": {
"type": "WITHDRAW",
"paymentType": "SEPA_CT"
},
"banking_fee": "2.000000",
"banking_fee_asset": "BANK_EUR"
}{
"error": "idempotency_key_required",
"message": "provide idempotency_key (body or Idempotency-Key header)"
}{
"error": "unauthorized",
"message": "invalid or missing credentials"
}{
"error": "insufficient_funds",
"message": "account balance is not enough for this operation"
}{
"error": "no_banking_customer",
"message": "create your banking customer first (POST /v1/banking/customer)"
}{
"error": "funding_account_required",
"message": "an active EUR funding account is required to send to Europe"
}{
"error": {
"code": "banking_request_failed",
"message": "request rejected"
}
}授权
会话 JWT(来自注册/登录)或 API key(pk_...)。
也接受 X-API-Key: <token> 作为替代请求头。
请求头
idempotency_key 请求体字段的替代方式。
请求体
"USD"
TRANSFER, WITHDRAW Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
TRANSFER 时为空;WITHDRAW 时为通道代码(例如 SEPA_CT)。
用于 EUR SEPA Banking 提现的 active banking_eur 虚拟 IBAN,可选。只有一个 active 来源时可省略;多个来源时必须发送该 UUID。平台从 vIBAN registrant 写入 payer。
用于 BO/BOB QR payout 的活跃 banking 工具 UUID。
EUR SEPA 提现必填;个人使用 individual,企业使用 corporate。其他银行通道可选。
individual, corporate 结构化 EUR SEPA 个人受益人必填,并且必须与 beneficiary_first_surname 同时提供;其他银行通道可选。
结构化 EUR SEPA 个人受益人必填,并且必须与 beneficiary_given_name 同时提供;其他银行通道可选。
EUR SEPA 个人受益人的可选中间名;其他银行通道可选。
EUR SEPA 企业受益人的公司名称必填;多词值也可作为个人姓名兼容 fallback。其他银行通道可选。
响应
既有操作的幂等重放(不产生新扣费)。
The response is of type object.