虚拟账户

概述

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

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

服务优势

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

注意事项

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

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

创建虚拟账户

端点目标 URL

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

字段说明

调用的特定输入参数

字段名称	必填	类型	描述	若业务类型为B2B贸易，以下为必填	若业务类型为IBAN，以下为必填	其他
`merchantReference`	M	string	商户请求流水号，不能重复	M	M	M
`currency`	M	string	收款币种	M	M	M
`businessTypeId`	M	string	业务类型id(业务类型参考)	M	M	M
`mccCode`	O	string	(MCC代码参考)，	M		M
`countryCode`	O	string	收款国家	M		M
`paymentType`	O	string	收款方式(LOCAL 、SWIFT)	M		M
`email`	O	string	邮箱	M		M
`bankId`	O	string	收款银行id(收款银行 )	M		M
`accountHolderId`	O	string	店铺持有人id(店铺持有人 )		M	M
`nickname`	O	string	账户昵称		M
`accountNum`	O	string	开户数量		M

响应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
`openBankSwiftCodeMemo`	String	该值若不为空,交易对手如使用Swift支付方式，需要备注该附言
`openBankAchCode`	String	开户银行achCode
`openBankAchCodeMemo`	String	该值若不为空，交易对手如使用Ach支付方式，需要备注该附言
`openBankFedWireCode`	String	开户银行fedWireCode
`openBankFedWireCodeMemo`	String	该值若不为空，交易对手如使用FedWire支付方式，需要备注该附言
`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", 
        "openBankSwiftCodeMemo": "", 
        "openBankAchCodeMemo": "", 
        "openBankFedWireCodeMemo": ""
    }, 
    "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": "", 
            "openBankSwiftCodeMemo": "", 
            "openBankAchCodeMemo": "", 
            "openBankFedWireCodeMemo": "", 
            "eventDate": 1761818772990
        }
    ]
}

Updated 9 days ago