虚拟账户

概述

虚拟账户（VA）是为您的付款客户（如主要经销商或买方）创建并设置的一个指定账户，从而帮助公司区分每笔付款的付款来源。付往主账户的资金会根据不同的付款来源映射到不同的虚拟账户，便于您进行对账。

虚拟账户收款是我们提供的一项高效、安全的跨境支付解决方案，旨在简化您的收款流程，并优化资金管理效率。通过使用虚拟账户收款，您可以轻松地接收来自全球范围内客户的支付，无论是单笔交易还是大宗交易，都能够实现快速结算。

服务优势

全球覆盖： 通过我们的虚拟账户收款系统接收来自世界各地客户的支付。
即时创建： 按照所需，随时创建及更改付款客户的指定VA账号。
尽在掌握： 轻松管理主要客户的日常汇入款项。
安全可靠： 我们的系统采用了多重安全措施，确保您的交易数据和资金安全可靠。

注意事项

合规要求： 请确保您的交易活动符合所在国家和地区的法律法规，以及国际支付行业的合规要求，避免不必要的法律风险。
保护账户安全： 请妥善保管您的账户信息，不要将账户密码透露给他人，定期更改密码以确保账户安全。

如有任何问题或需要进一步帮助，请随时联系我们的客户支持团队。

创建虚拟账户

端点目标 URL

请求地址：POST /api/v1/virtual-account/create

字段说明

调用的特定输入参数

字段名称	必填	类型	描述
`merchantReference`	M	string	商户请求流水号，不能重复
`currency`	M	string	收款币种
`businessTypeId`	M	string	业务类型id(业务类型参考)
`mccCode`	O	string	(MCC代码参考)，若businessTypeId不为10000001（IBAN），该值必传
`countryCode`	O	string	收款国家的国际标准化组织（ISO）国家代码（如US代表美国，CN代表中国 ISO 3166-1 标准），若businessTypeId不为10000001（IBAN），该值必传
`paymentType`	O	string	收款方式(LOCAL 、SWIFT)，若businessTypeId不为10000001（IBAN），该值必传
`email`	O	string	邮箱，若businessTypeId不为10000001（IBAN），该值必传
`bankId`	O	string	收款银行id(收款银行参考)，若businessTypeId不为10000001（IBAN），该值必传
`accountHolderId`	O	string	账户持有人id，若businessTypeId为10000001（IBAN），该值必传
`nickname`	M	string	账户昵称，若businessTypeId为10000001（IBAN），该值必传
`accountNum`	M	string	开户数量，若businessTypeId为10000001（IBAN），该值必传

响应data参数

字段名	类型	说明
`merchantReference`	String	商户请求流水号
`accountStatus`	String	账户状态，SUCCESS(开户成功) 、PENDING(处理中) 、FAILED(开户失败)、REJECT（开户拒绝）、CLOSED（已关闭）

集成

创建虚拟账户调用输入

{
    "merchantReference":"zzxczxcxczxczxczxc",
    "countryCode":"NG",
    "currency":"NGN",
    "email":"[email protected]",
    "mccCode":"5139",
    "paymentType":"LOCAL",
    "bankId":"12",
    "businessTypeId":"184"
    
}

创建虚拟账户调用输出

{
    "code": "0",
    "msg": "succeeded",
    "serverTime": 1761809752879,
    "data": {
        "merchantReference": "zzxczxcxczxczxczxc",
        "accountStatus": "PENDING"
    },
    "success": true
}

查询虚拟账户状态

端点目标 URL

请求地址：POST api/v1/virtual-account/get-status

字段说明

调用的特定输入参数

字段名称	必填	类型	描述
`merchantReference`	M	string	创建付款方时商户提交的请求流水号

响应data参数

字段名	类型	说明
`merchantReference`	String	商户请求流水号
`accountStatus`	String	账户状态，SUCCESS(开户成功) 、PENDING(处理中) 、FAILED(开户失败)、REJECT（开户拒绝）、CLOSED（已关闭）
`accountNo`	String	账户号码
`accountName`	String	账户名称
`accountCcy`	String	账户币种
`countryCode`	String	账户收款国家的国际标准化组织（ISO）国家代码（如US代表美国，CN代表中国 ISO 3166-1 标准）
`errorMsg`	String	失败原因
`openBankCode`	String	开户银行编码
`openBankName`	String	开户银行名称
`openBankCountry`	String	开户银行国家
`openBankAddress`	String	开户银行地址
`openBankSwiftCode`	String	开户银行swiftCode
`openBankAchCode`	String	开户银行achCode
`openBankFedWireCode`	String	开户银行fedWireCode
`openBankSortCode`	String	开户银行sortCode
`accountOpenTime`	String	账户开始时间

集成

查询虚拟账户调用输入

{
    "merchantReference": "zzxczxcxczxczxczxc"
}

查询虚拟账户调用输出

{
    "code": "0",
    "msg": "succeeded",
    "serverTime": 1761816176184,
    "data": {
        "merchantReference": "zzxczxcxczxczxczxc",
        "accountStatus": "SUCCESS",
        "accountNo": "3891110341",
        "accountName": "Government of Singapore Investment Corp",
        "accountCcy": "NGN",
        "countryCode": "NG",
        "errorMsg": "",
        "openBankCode": null,
        "openBankName": "",
        "openBankCountry": "NG",
        "openBankAddress": "",
        "openBankSwiftCode": null,
        "openBankAchCode": "",
        "openBankFedWireCode": null,
        "openBankSortCode": null,
        "accountOpenTime": "2025-10-30 09:22:21"
    },
    "success": true
}

虚拟账户WEBHOOK

{
    "merchantId": "1929723739654762496", 
    "notificationItems": [
        {
            "openBankCountry": "NG", 
            "accountName": "Government of Singapore Investment Corp", 
            "openBankSwiftCode": "", 
            "openBankFedWireCode": "", 
            "openBankCode": "", 
            "accountStatus": "SUCCESS", 
            "eventCode": "VIRTUAL_ACCOUNT_NOTIFY", 
            "accountCcy": "NGN", 
            "openBankAchCode": "", 
            "accountOpenTime": "2025-10-30 10:06:13", 
            "countryCode": "NG", 
            "accountNo": "8950939081", 
            "openBankSortCode": "", 
            "merchantReference": "zzxczxcxczxczxczxc", 
            "openBankAddress": "", 
            "eventDate": 1761818772990
        }
    ]
}

Updated about 14 hours ago