whalet
首页
开放API
  • 收款
  • 鲸卡
  • 收单
首页
开放API
  • 收款
  • 鲸卡
  • 收单
  1. 提现(Payout)
  • 接入指南
  • Integration Guidelines
  • 附录
  • Appendix
  • 用户入网(User Onboarding)
    • 用户入网申请(User Onboarding Apply)
      POST
    • 入网结果通知(User Onboarding Result Notification)
      POST
  • 持有人(Card Holder)
    • 持有人申请(Card Holder Apply)
      POST
    • 持有人结果通知(Card Holder Result Notification)
      POST
    • 持有人查询(Card Holder Query)
      POST
    • 持有人银行账户申请(Card Holder Beneficary Apply)
      POST
    • 持有人银行账户结果通知(Card Holder Beneficary Result Notify)
      POST
    • 持有人银行账户查询(Card Holder Beneficary Query)
      POST
  • 开卡(Virtual Account)
    • 外贸收款(B2B)
      • 申请收款卡(Virtual Account Apply for B2B)
      • 获取外贸收款渠道(Channel Banks Query for B2B)
    • 电商收款(B2C)
      • 申请收款卡(Virtual Account Apply for B2C)
      • 获取收款卡平台配置(Platform Query for B2C)
      • 获取开通收款卡持有人(Card Holder Query for B2C)
      • 查询开卡数(Card number Query for B2C)
      • 绑定/添加店铺(Bind/Unbind Shop for B2C)
      • 注销收款卡((Card Cancel for B2C))
      • 查询收款卡详情(Card Detail Query for B2C)
      • 注销收款卡结果通知(Card Cancel Result Notify for B2C)
      • 查询店铺(Shop Query for B2C)
      • 查询收款卡(Card Query for B2C)
      • 绑定/添加店铺结果通知(Shop Bind/Unbind/Add Result Notify for B2C)
      • 申请银行证明信（Bank Letter Apply For B2C）
    • 申请收款卡结果通知(Virtual Account Notify for B2C)
      POST
  • 收款(Collections)
    • 收款到账通知(Collection Received Notify)
      POST
    • 关联外贸订单(Trade Order Bind Apply for B2B)
      POST
    • 关联外贸订单结果通知(Trade Order Bind Notify for B2B)
      POST
  • 订单(Order)
    • 外贸收款(Trade Order)
      • 订单申请(Trade Order Apply for B2B)
      • 订单详情(Trade Order Query Detail for B2B)
      • 分页查询(Trade Order Query List for B2B)
    • 电商收款(Shop Order)
      • 上传订单(Shop Order Upload for B2C)
  • 提现(Payout)
    • 申请提现/付款(Payout Apply)
      POST
    • 确认提现/付款(Payout Confirm)
      POST
    • 申请提现/付款结果通知(Payout Result Notify)
      POST
    • 查询汇率(Rate Inquiry)
      POST
    • 查询受益人银行账户字段信息(Beneficiary Account Fields Query)
      POST
    • 绑定受益人银行账户(Benificiary Account Apply)
      POST
    • 绑定受益人银行账户结果通知(Benificiary Account Result Notify)
      POST
    • 删除受益人银行账户(Benificiary Account Delete)
      POST
    • 查询支持的受益人银行账户国家/地区(Beneficiary Account Country Query)
      POST
  • 支付(Pay)
    • 申请支付(Pay Apply)
    • 确认支付(Pay Confirm)
    • 申请支付结果通知(Pay Result Notify)
  • 钱包(Wallet)
    • 币种余额(Currency Balance)
    • 平台余额(Platform Balance)
  • 交易查询(Trade Query)
    • 收款记录(Collection Query)
    • 提现记录(Withdraw Query)
    • 付款记录(Payment Query)
    • 支付记录(Pay Query)
  • 补充资料(ReMaterials)
    • EDD补充资料通知(Edd Replenish Notify)
    • EDD补充资料查询(Edd Replenish Query)
    • EDD补充资料提交(Edd Replenish Submit)
    • EDD补充资料结果通知(Edd Replenish Result Notify)
    • 交易补充资料通知(Trade Replenish Notify)
    • 交易补充资料提交(Trade Replenish Submit)
    • 交易补充资料结果通知(Trade Replenish Result Notify)
  • Connectivity
    • 连通性验证(connectivity)
    • 连通性验证通知(connectivityNotify)
  • Mock
    • 入账通知Mock(mockPayeeNotify)
  1. 提现(Payout)

绑定受益人银行账户(Benificiary Account Apply)

POST
applyBeneficiaryBankAccount

Request

Body Params application/json
userId
string 
用户ID
required
beneficiaryAccountId
string 
受益人账户ID
optional
修改时必需
beneficiaryAccountType
enum<string> 
受益人账户类型
required
Allowed values:
WithdrawPayment
beneficiaryAccountCategory
enum<string> 
required
受益人银行账户种类
Allowed values:
BankAccountNumberDigitalWallet
accountEntityType
enum<string> 
银行账户类型
required
Allowed values:
PersonEnterprise
currency
string 
币种
required
supplier
object 
供应商
optional
beneficiaryAccountType = Payment时必需
supplierType
enum<string> 
供应商类型
required
Allowed values:
SupplierRelatedCompanyExportAgentLogisticsProviderGoodsProcurementLogisticsFeeAdvertisementServiceFeeLawServiceFeeHouseRentFeeTechnologyServiceFeeOperateForOwnerServiceFeeOther
supplierRegion
enum<string> 
供应商地区
required
Allowed values:
CNHKUSUKFRCAJPDEITESSG
supplierName
string 
供应商名称
required
<= 120 characters
aliasName
string 
供应商备注名称
required
<= 200 characters
cooperateLongTerm
enum<string> 
是否长期合作，Y:是, N:否
required
Allowed values:
YN
cooperateEnd
string 
合作结束时间，格式为 YYYY-MM-DD
optional
时间结束后，系统将自动移除供应商
tradeRelationImages
array[object (StorageFile) {3}] 
贸易关系文件
required
请上传体现您与该供应商贸易关系的材料，文件中须包含：
*该供应商的基本信息+银行账号信息
*交易内容+总金额
*日期+盖章+签字
>= 1 items<= 6 items
memo
string 
备注
required
请填写转账说明和第三方企业中文名称（如有）、供货商对外经
营网站，仅供内部审核使用
>= 1 characters<= 256 characters
beneficiary
object (BeneficiaryBankAccount) 
受益人信息
required
来源于查询受益人银行账户字段信息
preMobile
string 
预留手机号
optional
<= 32 characters
phoneAreaCode
string 
optional
预留手机号对应的国际电话区号
Example:
86
branchName
string 
支行名称
optional
<= 40 characters
bankBranchCode
string 
optional
支行Code
businessAccountFile
array[object (StorageFile) {3}] 
企业开户证明文件
optional
>= 1 items<= 1 items
bankCountry
string 
开户行所在国家/地区
optional
ISO国家地区二字编码
bankProvince
string 
开户行所在地(省)
optional
<= 32 characters
bankCity
string 
开户行所在地(城市)
optional
<= 32 characters
bankDistrict
string 
开户行所在地 (区县)
optional
<= 32 characters
bankAddress
string 
银行详细地址
optional
<= 256 characters
bankCode
string 
银行Code
optional
Examples:
ICBCABCBOCCCB
bankName
string 
银行名称
optional
<= 100 characters
swiftCode
string 
BIC
optional
位数不够时，使用X填充
>= 11 characters<= 11 characters
legalEntityName
string 
法人名称
optional
<= 100 characters
legalEntityCertNo
string 
法人证件号
optional
<= 40 characters
bankAcctNo
string 
银行账号
optional
<= 30 characters
bankAcctName
string 
银行账户名
optional
<= 40 characters
firstName
string 
optional
银行账户英文名称 - 名
middleName
string 
optional
银行账户英文名称 - 中间名
lastName
string 
optional
银行账户英文名称 - 姓
bankAcctType
enum<string> 
optional
银行账户类型
Allowed values:
Saving_AccountCheque_Account
beneficiaryCertType
enum<string> 
optional
受益人证件类型
Allowed values:
Identity_CardPassportHK_IdUniform_Social_Credit_CodeEnterprise_Registration_CertificateITINCPFCNPJ
beneficiaryCertNo
string 
受益人证件号
optional
<= 20 characters
issueDate
string 
optional
证件开始日期
expiryDate
string 
optional
证件结束日期
beneficiaryAddress
string 
受益人地址
optional
<= 255 characters
beneficiaryAddress2
string 
optional
地址2
beneficiaryAddress3
string 
optional
地址3
authorizationFile
array[object (StorageFile) {3}] 
代收款授权书文件
optional
>= 1 items<= 1 items
walletId
string 
optional
钱包ID（电子钱包时必须）
postalCode
string 
optional
邮政编码
email
string 
optional
邮箱
iBan
string 
optional
IBAN账号
beneficiaryCountry
string 
optional
受益人所在地(国家/地区二字码)
Example:
US
beneficiaryProvince
string 
optional
受益人所在地(省名称)
beneficiaryCity
string 
optional
受益人所在地(城市名称)
beneficiaryDistrict
string 
optional
受益人所在地 (区县名称)
bankRoutingNumber
string 
optional
Routing Number
bankSortCode
string 
optional
Sort Code
zenginCode
string 
optional
Zengin Code
Example
{
    "userId": "string",
    "beneficiaryAccountId": "string",
    "beneficiaryAccountType": "Withdraw",
    "beneficiaryAccountCategory": "BankAccountNumber",
    "accountEntityType": "Person",
    "currency": "string",
    "supplier": {
        "supplierType": "Supplier",
        "supplierRegion": "CN",
        "supplierName": "string",
        "aliasName": "string",
        "cooperateLongTerm": "Y",
        "cooperateEnd": "string",
        "tradeRelationImages": [
            {
                "fileId": "string",
                "fileName": "string",
                "fileUrl": "string"
            }
        ],
        "memo": "string"
    },
    "beneficiary": {
        "preMobile": "string",
        "phoneAreaCode": "86",
        "branchName": "string",
        "bankBranchCode": "string",
        "businessAccountFile": [
            {
                "fileId": "string",
                "fileName": "string",
                "fileUrl": "string"
            }
        ],
        "bankCountry": "string",
        "bankProvince": "string",
        "bankCity": "string",
        "bankDistrict": "string",
        "bankAddress": "string",
        "bankCode": "ICBC",
        "bankName": "string",
        "swiftCode": "stringstrin",
        "legalEntityName": "string",
        "legalEntityCertNo": "string",
        "bankAcctNo": "string",
        "bankAcctName": "string",
        "firstName": "string",
        "middleName": "string",
        "lastName": "string",
        "bankAcctType": "Saving_Account",
        "beneficiaryCertType": "Identity_Card",
        "beneficiaryCertNo": "string",
        "issueDate": "string",
        "expiryDate": "string",
        "beneficiaryAddress": "string",
        "beneficiaryAddress2": "string",
        "beneficiaryAddress3": "string",
        "authorizationFile": [
            {
                "fileId": "string",
                "fileName": "string",
                "fileUrl": "string"
            }
        ],
        "walletId": "string",
        "postalCode": "string",
        "email": "string",
        "iBan": "string",
        "beneficiaryCountry": "US",
        "beneficiaryProvince": "string",
        "beneficiaryCity": "string",
        "beneficiaryDistrict": "string",
        "bankRoutingNumber": "string",
        "bankSortCode": "string",
        "zenginCode": "string"
    }
}

Responses

🟢200成功
application/json
Body
beneficiaryAccountId
string 
受益人账户ID
required
Example
{
    "beneficiaryAccountId": "string"
}
Modified at 2025-02-13 01:12:06
Previous
查询受益人银行账户字段信息(Beneficiary Account Fields Query)
Next
绑定受益人银行账户结果通知(Benificiary Account Result Notify)
Built with