创建收款账户
提示
- 在 机构模式 下,如果需要为子商户 创建VA (opens new window),需要在请求头中带上子商户的
X-Unit-Id
。 B2C
类型的商户,只能使用平台收款(Collection
)和账户充值(Direct Payment
)。B2B
类型的商户,只能使用B2B收款(B2B Collection
)和账户充值(Direct Payment
)。Collection
类型创建VA之前需要先 创建店铺 或者 获取已创建的店铺ID (opens new window)。B2B Collection
创建VA必须指定贸易类型。
# 参数说明
参数名 | 说明 |
---|---|
partner_ga_id | 由商户生成的唯一ID。 |
biz_type | B2C 商户可以使用 Collection 和 Direct Payment ,而 B2B 商户可以使用 B2B Collection 和 Direct Payment 。 |
country | 国家,一般和币种相对应,比如 VN-VND,根据实际情况传。 |
currency | 币种,一般和国家对应,根据实际情况传。 |
platform | 平台,Collection 时必填。 |
shop_id | biz_type 为Collection 时必填。一个店铺ID只能被使用一次。 |
account_purpose | B2B Collection 时必填。 |
# 贸易类型
02
:一般贸易22
:服务贸易(国际物流)23
:服务贸易(广告营销)
# 请求示例
curl --location --request POST 'https://sandbox-api.pyvio.com/user/api/v1/va/apply' \
--header 'Request-Id: bcaaf79e-71f3-3abf-f719-4449143c' \
--header 'Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJhY2Nlc3NUb2tlbkV4cGlyZWQiOjE2NjM3MzQ2MjI1MDQsImFwcElkIjoiMTU2OTY0MTI3MDk1MzU4OTUwNCIsInNjb3BlIjoidXNlcl9yZWFkIiwidW5pdElkIjoiMTExIiwidG9rZW5Vbml0SWQiOiJVVDIyMDkwMjE1NzAwMTU2IiwiZ3JhbnRUeXBlIjoiYXV0aG9yaXphdGlvbl9jb2RlIn0.PuwMj5s4ljygYDoIvS_gNfriZDwUY0a7Zhrn0_zxU-4' \
--header 'Sign: DGhen+ndwMlmkTElnzyMlVa+H/YYG/UEF3uqFpgTVhEPEmApDPiqOyZQle6h/NmT39AO3KmQEjIRJuvXx5SzQtw6iYXbkdLX42SffNfjY/VOggcj2u6SGGyNoZbpm/Ttuux5Z48SUK0wnkvcSD8ht4luI++/iy5gnUHgM2AOHtQ=' \
--header 'X-Timestamp: 1666332361000' \
--header 'X-Unit-Id: UT1633650493875645186' \
--header 'Content-Type: application/json' \
--data-raw '{
"biz_type": "Collection",
"currency": "MYR",
"partner_ga_id": "p13451234123",
"platform": "Lazada",
"country": "MY",
"shop_id":"1640612294964712448"
}'
curl --location --request POST 'https://sandbox-api.pyvio.com/user/api/v1/va/apply' \
--header 'Request-Id: bcaaf79e-71f3-3abf-f719-4449143c' \
--header 'Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJhY2Nlc3NUb2tlbkV4cGlyZWQiOjE2NjM3MzQ2MjI1MDQsImFwcElkIjoiMTU2OTY0MTI3MDk1MzU4OTUwNCIsInNjb3BlIjoidXNlcl9yZWFkIiwidW5pdElkIjoiMTExIiwidG9rZW5Vbml0SWQiOiJVVDIyMDkwMjE1NzAwMTU2IiwiZ3JhbnRUeXBlIjoiYXV0aG9yaXphdGlvbl9jb2RlIn0.PuwMj5s4ljygYDoIvS_gNfriZDwUY0a7Zhrn0_zxU-4' \
--header 'Sign: DGhen+ndwMlmkTElnzyMlVa+H/YYG/UEF3uqFpgTVhEPEmApDPiqOyZQle6h/NmT39AO3KmQEjIRJuvXx5SzQtw6iYXbkdLX42SffNfjY/VOggcj2u6SGGyNoZbpm/Ttuux5Z48SUK0wnkvcSD8ht4luI++/iy5gnUHgM2AOHtQ=' \
--header 'X-Timestamp: 1666332361000' \
--header 'X-Unit-Id: UT1633650493875645186' \
--header 'Content-Type: application/json' \
--data-raw '{
"biz_type": "B2B Collection",
"currency": "US",
"partner_ga_id": "p13451234123",
"country": "USD",
"account_purpose": "02",
}'
curl --location --request POST 'https://sandbox-api.pyvio.com/user/api/v1/va/apply' \
--header 'Request-Id: bcaaf79e-71f3-3abf-f719-4449143c' \
--header 'Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJhY2Nlc3NUb2tlbkV4cGlyZWQiOjE2NjM3MzQ2MjI1MDQsImFwcElkIjoiMTU2OTY0MTI3MDk1MzU4OTUwNCIsInNjb3BlIjoidXNlcl9yZWFkIiwidW5pdElkIjoiMTExIiwidG9rZW5Vbml0SWQiOiJVVDIyMDkwMjE1NzAwMTU2IiwiZ3JhbnRUeXBlIjoiYXV0aG9yaXphdGlvbl9jb2RlIn0.PuwMj5s4ljygYDoIvS_gNfriZDwUY0a7Zhrn0_zxU-4' \
--header 'Sign: DGhen+ndwMlmkTElnzyMlVa+H/YYG/UEF3uqFpgTVhEPEmApDPiqOyZQle6h/NmT39AO3KmQEjIRJuvXx5SzQtw6iYXbkdLX42SffNfjY/VOggcj2u6SGGyNoZbpm/Ttuux5Z48SUK0wnkvcSD8ht4luI++/iy5gnUHgM2AOHtQ=' \
--header 'X-Timestamp: 1666332361000' \
--header 'X-Unit-Id: UT1633650493875645186' \
--header 'Content-Type: application/json' \
--data-raw '{
"biz_type": "Direct Payment",
"currency": "US",
"partner_ga_id": "p13451234123",
"country": "USD",
}'
// Make sure to add code blocks to your code group
# 常见错误
# 报错:"message": "Va account beyond limit error"
超出申请数量。
- Collection:每个国家币种最多可以申请10个。
- Direct Payment:每个国家币种最多可以申请1个。
- B2B Collection:每个国家币种最多可以申请1个。
# 报错:"message": "The user account application has been submitted. If you need to hurry, please contact customer service"
申请的类型填错,或暂时不支持,请联系我们进行排查。
# 报错:"message": "The shop not exist"
请先调用Create Shop (opens new window)接口,拿到shop_id
后再次调用Open a Global Account (opens new window)接口
# 报错:"message": "System error,please contact us later"
错类型申请,先确认是否申请的是支持的类型,如果都正确,请联系我们进行排查。