1.3 Virtual Account 批量更新接口

简要描述

• 商户还款码-批量更新接口

请求URL

• /api/v1/batch/paymentCode/{mchOrderId}/update

请求方式

• POST

*注意：在获取VA链接时，mchOderId对应一个付款用户，该用户所须使用的每一个支付渠道都有不同的VA链接, 需要以channelCode参数请求获取VA链接。链接一旦获取后永久有效，无须重复请求

请求参数

参数名	必选	类型	长度限制	示例	说明
appId	是	string	-	-	应用APPID
channelCode	是	string	-	GCASH_STATIC_VA,PAYMAYA_STATIC_VA	静态渠道VA Code: 多个channelCode字符串，以逗号做分隔
sign	是	string	-	45eebd745dcf0b5f6d6f9fcde28cd9fe8116a892	签名

响应参数

参数名	类型	示例	说明
code	int	1000	状态码， 参考列表
message	String	success	状态码信息
data	Object	-	返回具体信息
- shortLink	String		还款指引短链
- paymentVaList	List		还款码集合
-- mchOrderId	String	LT000000216	商户订单号
-- channelCode	String	GCASH_STATIC_VA	还款渠道
-- referenceNumber	String	PC003752	还款码
-- biller	String	Dragon Loans	支付网关
-- guideUrl	String	-	单个渠道的还款指引链接

返回示例

{
    "code":1000,
    "message":"success",
    "data":{
        "shortLink":"https://a.api-dev.paycools.com/1L9zOOL",
        "paymentVaList":[
            {// GCASH_STATIC_VA
                "mchOrderId": "CCP2022111405068111",
                "channelCode": "GCASH_STATIC_VA",
                "guideUrl": "https://api-dev.paycools.com/repayment/static/guide/R2VtMG5GejRtYmZFZkZlK0V2SnBzeXJjYTZUanZydHgyWXM4dUptakgrUT0=",
                "referenceNumber": "PC0000710000024",
                "biller": "PAYCOOLS LOAN"
            },
            {//PAYMAYA_STATIC_VA
                "mchOrderId": "CCP2022111405068111",
                "channelCode": "PAYMAYA_STATIC_VA",
                "guideUrl": "https://api-dev.paycools.com/repayment/static/guide/bCtvVVJobVVtdWNtQW8zSXhaMWRUa2FaN2YxZ0d3ZlJ1OTZDczdmc2xpaz0=",
                "referenceNumber": "PC0088A0",
                "biller": "Dragon Loans"
            }
        ]
    }
}

返回失败案例 code参考列表 参考列表

{
    "code":1002,
    "message":"merchant white ip forbidden",
}