创建收款账户

报错："message": "Va account beyond limit error"

报错："message": "The user account application has been submitted. If you need to hurry, please contact customer service"

报错："message": "The shop not exist"

报错："message": "System error,please contact us later"

提示

在机构模式下，如果需要为子商户创建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"

错类型申请，先确认是否申请的是支持的类型，如果都正确，请联系我们进行排查。

← 入账退回放号流程→