whalet
首页
开放API
  • 收款
  • 鲸卡
  • 收单
首页
开放API
  • 收款
  • 鲸卡
  • 收单
  1. 持有人(Card Holder)
  • 接入指南
  • 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. 持有人(Card Holder)

持有人银行账户申请(Card Holder Beneficary Apply)

POST
userHolderBankAccountApply

Request

Body Params application/json
userId
string 
用户ID
required
holderId
string 
持有人ID
required
accountType
enum<string> 
账户类型
required
持有人是个人时，仅支持个人；持有人是企业时，均支持。
Allowed values:
PersonEnterprise
country
string 
国家/地区
required
国家/地区ISO 二字简码
certNo
string 
证件号码
optional
地区为中国大陆必填； 个人持有人传持有人证件号； 企业持有人，accountType为个人时传法人证件号，accountType为企业时企业证件号。
accountNo
string 
银行账号
required
<= 100 characters
bankCode
enum<string> 
银行
optional
地区为中国时必须
Allowed values:
ICBCABCBOCCCBCMBPSBCCEBCITICCIBCMBCSPDBCOMMPINGANBKHXBCQRCBCZCB
bankName
string 
银行名称
optional
地区为非中国时必须
<= 100 characters
preMobile
string 
预留手机号
optional
地区为中国时必须
<= 20 characters
accountName
string 
账户名称
required
routingCodeType
enum<string> 
银行路由编码类型
optional
地区为非中国时必须
Allowed values:
Routing numberBICSort CodeBSBIFSC
routingCodeValue
string 
银行路由编码值
optional
地区为非中国时必须
<= 100 characters
businessAccountFile
array[object (StorageFile) {3}] 
企业银行开户信息
optional
地区为中国+类型为企业时必须
fileId
string 
文件ID
required
<= 32 characters
fileName
string 
文件名
required
<= 255 characters
fileUrl
string 
文件地址
required
<= 255 characters
phoneAreaCode
enum<string> 
国际区号
optional
持有人首次添加银行账户时必须
<= 8 characters
Allowed values:
8685265144
mobile
string 
手机号
optional
持有人首次添加银行账户时必须
email
string 
邮箱
optional
持有人首次添加银行账户时必须
Example
{
    "userId": "string",
    "holderId": "string",
    "accountType": "Person",
    "country": "string",
    "certNo": "string",
    "accountNo": "string",
    "bankCode": "ICBC",
    "bankName": "string",
    "preMobile": "string",
    "accountName": "string",
    "routingCodeType": "Routing number",
    "routingCodeValue": "string",
    "businessAccountFile": [
        {
            "fileId": "string",
            "fileName": "string",
            "fileUrl": "string"
        }
    ],
    "phoneAreaCode": "86",
    "mobile": "string",
    "email": "string"
}

Responses

🟢200成功
application/json
Body
holderBankAcctId
string 
持有人银行账户ID
required
status
enum<string> 
状态
required
Allowed values:
WAITPASSREJECT
Example
{
    "holderBankAcctId": "string",
    "status": "WAIT"
}
Modified at 2024-10-12 06:41:38
Previous
持有人查询(Card Holder Query)
Next
持有人银行账户结果通知(Card Holder Beneficary Result Notify)
Built with