账号申请

POST /v1/mid-open-api/va/create
需要验证签名

接口描述

异步接口，根据渠道、大账号等向指定收款渠道或银行申请收款账户。接口接受请求并同步校验参数，最终结果通过异步回调通知业务方，业务方也可以根据账号申请结果查询来获取。

提示

1. 账号用途(purpose)和收款币种(currency)，需提前联系PingPong产品进行沟通确认，由PingPong配置。
2. 账号用途若为电商收款且平台为亚马逊，则在申请收款账户前必须先添加一张收款卡且审核成功。

请求头

Parameter	Type	Required	Description
Authorization	string	M	access_token
Content-Type	string	M	application/json

请求参数

Parameter	Type	Required	Description
partner_order_id	string(64)	M	合作伙伴请求单号,唯一幂等。
client_id	string(64)	M	注册PingPong返回的客户ID
purpose	enum	M	账号用途，可传输多个，以英文逗号分隔。具体值有:01-电商收款/02-一般贸易收款/03-充值收款/04-代扣付款/05-服务贸易（应用平台）/06-服务贸易（国际物流）/07-服务贸易（广告营销）/08-服务贸易（在线教育）/09-服务贸易（留学缴费）/10-服务贸易（交通出行）/11-服务贸易（创作者出海）
currency	enum	M	支持的币种，一次仅传输一个。支持币种列表见附录。每个合作方找PingPong提前配置。
bank_location	enum	M	账号支持的地区，匹配关系见附录。
platform	enum	C	PP平台编码，电商收款必填 见店铺平台及授权取值说明
extra_info	string(1024)	O	其他的信息,json

返回响应

Parameter	Type	Required	Description
partner_order_id	string(64)	M	M
status	string(64)	M	M

返回示例

成功

{
    "code": 200,
    "data": {
    "partner_order_id": "PO20220620151628",
    "status": "PROCESSING"
},
    "message": "SUCCESS"
}

失败

{
    "code": 901000,
    "data": null,
    "message": "user kyc not exist or kyc status not passed"
}

错误码

返回码	描述	解决方案
900000	system error	系统错误，请联系PingPong技术人员核查
900002	illegal param	参数有误，请根据提示更正信息
900001	repeated request	重复单号请求,请查询订单是否已存在
911002	user kyc not exist or kyc status not passed	KYC审核通过状态下允许提交账号申请
930001	va route not support,please contact us!	暂无可用VA路由列表，请联系PingPong技术或运营人员
970000	beneficiary withdraw card in passed status does not exist!	申请账号前，请绑定审核通过的提现卡（亚马逊收款场景）