创建 Settle Account 对象

你可以为一个用户创建一个用户结算账户,每个用户在一个渠道下最多支持创建一个用户结算账户。

请求参数描述
APP_ID required string对应 app 对象的 id,该参数仅需要填写在请求地址内,查看 如何获取App ID
USER_ID required string用户 ID ,64 位以内,首字母必须是英文、数字或者下划线,该参数仅需要填写在请求地址内。
channel required string结算账号渠道名称,目前支持:alipay(支付宝)、wx(微信 App)、wx_pub(微信公众号)、wx_lite(微信小程序)、bank_account(银行卡)。
recipient required object结算账号接收者信息,见下方各渠道 recipient 参数说明

recipient 参数说明

alipay 支付宝账户
参数描述
account required string接收者支付宝账号。
name required string接收者姓名。
type required string转账类型,分为两种:b2c:企业向个人付款,b2b:企业向企业付款。不传时默认为b2c类型。
account_type optional string收款方账户类型。默认值:"ALIPAY_LOGONID"。ALIPAY_USERID:支付宝账号对应的支付宝唯一用户号,以 2088 开头的 16 位纯数字组成;ALIPAY_LOGONID:支付宝登录号,支持邮箱和手机号格式。

wx、wx_pub、wx_lite 微信账户
参数描述
account required string接收者 open_id。点此参考如何获取open_id
name optional string收款人姓名。当该参数为空,则不校验收款人姓名。
force_check optional boolean是否强制校验收款人姓名。仅当 name 参数不为空时该参数生效。
type optional string转账类型。仅支持 b2c:企业向个人付款。默认值为b2c

bank_account 银行卡账户
参数描述
account required string接收者银行账号/卡号。
name required string接收者银行开户名。
type required string转账类型。b2c:企业向个人付款,b2b:企业向企业付款。
open_bank_code required string开户银行编号(针对 allinpay / unionpay 渠道使用),请根据渠道的不同参考 银联电子代付银行编号说明通联代付银行编号说明
open_bank optional string开户银行名称(针对 unionpay 渠道使用)。
card_type optional int银行卡号类型,0:银行卡;1:存折;2:信用卡;3:准贷记卡;4:其他。(jdpay 不支持 1:存折)
sub_bank conditional string开户支行名称,1~80位(针对 allinpay / unionpay 渠道使用)。若使用 allinpay 渠道且 type 为 b2b,则此参数必填,详情请下载 支付行号
sub_bank_code conditional string支付行号(仅针对 allinpay 渠道使用),1~12位,且在 type 为 b2b 时此参数必填,详情请下载 支付行号
prov conditional string开户银行所在省份,(针对 allinpay / unionpay 渠道使用)。若使用 allinpay 渠道且 type 为 b2b,则此参数必填,不带 “省” 或 “自治区”,需填写成:广东、广西、内蒙古等,详情请参考 中国邮政区号表 内的「省洲名称」列的内容填写。
city conditional string开户银行所在城市,(针对 allinpay / unionpay 渠道使用)。若使用 allinpay 渠道且 type 为 b2b,则此参数必填,不带 “市”,需填写成:广州、南宁等。如果是直辖市,则填区,如北京(市)朝阳(区),详情请参考 中国邮政区号表 内的「地区名称」列的内容填写。

返回

返回一个 settle_account 对象,或者返回一个错误,详见 错误

定义

POST https://api.pingxx.com/v1/apps/{APP_ID}/users/{USER_ID}/settle_accounts
 
待补充
待补充
待补充
待补充
待补充
待补充
待补充

请求示例

curl https://api.pingxx.com/v1/apps/app_1Gqj58ynP0mHeX1q/users/user_test_003/settle_accounts \
-H "Pingplusplus-Signature: SIGNATURE" \
-H "Pingplusplus-Request-Timestamp: 1475029155" \
-H "Content-Type: application/json" \
-u sk_test_ibbTe5jLGCi5rzfH4OqPW9KC:
-d '{
  "channel": "alipay",
  "recipient": {
    "account": "account01@gmail.com",
    "name": "李雷",
    "type": "b2c"
  }
}'
待补充
待补充
待补充
待补充
待补充
待补充
待补充

返回示例

{
  "id": "320217022818035400000601",
  "object": "settle_account",
  "created": 1488276234,
  "livemode": true,
  "channel": "alipay",
  "recipient": {
    "account": "a***@gmail.com",
    "name": "***雷",
    "type": "b2c"
  }
}