1.1 QrCode合并包裹创建接口

请求地址

• /api/v2/qrcode/merge

请求方式

• POST

请求参数

参数名	必选	类型	长度	说明	description
appId	是	string	-	-	应用APPID
appName	是	string	1-100	-	商户对接应用名称, 格式：字母+空格，1-100位
aggregateOrderId	是	string	1-32	CCP20220428011068111	商户-聚合订单号, 格式：字母+数字，1-32位, 如：CCP20220428011068111
channelCode	是	string	-	-	渠道编码，如：QRPH_HYBRID_QR
items	是	string	text	-	子订单详情
aggregateAmount	是	int	-	聚合金额，多单COD总金额	金额必传(单位为分, 最小金额20peso）例如PHP:500.10, 需要设置
remark	否	string	-	-	二维码备注
callbackUrl	否	string	-	-	终端支付成功后的回调地址，存在则使用该回调地址，否则走统一配置的回调地址
businessType	否	int	-	1:外场COD类型, 2:驿站寄件类型, 3:转寄类型, 4:驿站自提COD类型	1:外场COD类型, 2:驿站寄件类型, 3:转寄类型, 4:驿站自提COD类型(默认为1:COD类型)
feeSplitType	否(驿站寄件、转寄、驿站自提COD类型必填)	int	-	1:商户承担, 2:用户承担	1:商户承担, 2:用户承担(默认为2:用户承担)
sign	是	string	-	45eebd745dcf0b5f6d6f9fcde28cd9fe8116a892	签名

item 参数说明

参数名	必选	类型	长度	说明	description
subOrderId	是	string	1-32	CCP20220428011068111	子订单编号 格式：字母+数字，1-32位
customerName	否	string	1-100	-	用户姓名，格式：字母+空格，1-100位, "firstName middleName lastName" (middleName 非必填)
customerMobile	否	11	string	-	用户手机号(长度11位 09 开头)
amount	是	int	-	-	金额必传(单位为分, 最小金额20peso）例如PHP:500.10, 需要设置50010分
email	否	string	1-50	-	用户邮箱
regionNo	是	string	1-50	SEL	大区名称(1-50 位,字母*缺失影响结算提现功能 ); 示例: SEL
regionCode	是	string	1-50	907	大区编码(1-50 位,数字,唯一); 示例: 907
branchNo	否	string	1-100	F604602	网点编码(1-100 位, *缺失影响后台查询功能) ; 支持大小写字母和数字
courierNo	否	string	1-100	F6046024088	快递员编码(1-100 位, *缺失影响后台查询现功能) ; 支持大小写字母和数字
courierName	否	string	1-50	-	快递员姓名(1-50 位)
stationNo	否(驿站寄件、驿站自提COD类型必传)	string	1-100	F6046024088	驿站名称(1-100 位,字母) ; 示例: SEL
stationCode	否(驿站寄件、驿站自提COD类型必传)	string	1-100	F6046024088	驿站编码(1-100 位,数字) ; 示例: 907
courierMobile	否	string	11	-	快递员手机号(长度11位 09 开头)

请求示例

{
    "appId":"f7146e62b****************bae34bf156",
    "appName":"MocaMoca",
    "aggregateOrderId":"PCW000000000046067",
    "aggregateAmount": 140000,
    "channelCode":"QRPH_HYBRID_QR",
    "items":"[{\"subOrderId\":\"PCW00000000003249\",\"customerName\":\"Customer Name\",\"customerMobile\":\"09123456789\",\"amount\":60000,\"email\":\"pay@paycools.com\",\"regionNo\":\"001\",\"regionCode\":\"001\",\"branchNo\":\"F604602\",\"courierNo\":\"F6046024088\",\"courierName\":\"Courier Name\",\"courierMobile\":\"09123456789\"},{\"subOrderId\":\"PCW00000000003250\",\"customerName\":\"Customer Name\",\"customerMobile\":\"09123456789\",\"amount\":80000,\"email\":\"pay@paycools.com\",\"regionNo\":\"001\",\"regionCode\":\"001\",\"branchNo\":\"F604602\",\"courierNo\":\"F6046024088\",\"courierName\":\"Courier Name\",\"courierMobile\":\"09123456789\"}]",
    "remark":"remark",
    "callbackUrl":"https://wwww.paycools.ph",
    "businessType": 1,
    "sign":"ouo4si4bVis***************8isUevNZ38="
}

成功响应示例

{
	"code":1000,
	"message":"success",
	"data":{
      "mchOrderId": "E34302809202827219113",
      "qrcodeId": "QR1007656756764275140",
      "qrcodeContent": "00020101021228770011ph.ppmi.p2m0111OPDVPHM1XXX031632948137239463980416329481372394639805030015204601653036085406500.005802PH5921Paycools John Cyril B6015City Of Mandalu62310010ph.allbank05062110000803***88310012ph.ppmi.qrph0111OPDVPHM1XXX6304E56C",
      "channelCode": "QRPH_HYBRID_QR",
      "callbackUrl": "https://www.paycools.com.ph",
      "createTime": "2022-07-02 18:12:46",
      "updateTime": "2022-07-02 18:14:05",
      "remark": "test static qrcode",
      "status": "ACTIVE",
      "qrLink": "https://a.api-dev.paycools.com/1L9zOb5",
      "aggregateAmount": 10000, // Unit: cent
      "aggregateFee": 2000, // Unit: cent
      "totalAggregateAmount": 12000, // Unit: cent
      "businessType": 1,
      "items": [
            {
            "subOrderId":"123456",
            "customerName":"Customer Name",
            "customerMobile":"09123456789",
            "channelCode":"QRPH_HYBRID_QR",
            "amount":50000,
            "fee":70,
            "totalAmount":50070,
            "email":"pay@paycools.com",
            "regionNo":"001",
            "regionCode":"001",
            "branchNo":"F604602",
            "courierNo":"F6046024088",
            "courierName":"Courier Name",
            "courierMobile":"09123456789"
            },
            {
            "subOrderId":"456789",
            "customerName":"Customer Name",
            "customerMobile":"09123456789",
            "channelCode":"QRPH_HYBRID_QR",
            "amount":80000,
            "fee":70,
            "totalAmount":80070,
            "email":"pay@paycools.com",
            "regionNo":"001",
            "regionCode":"001",
            "branchNo":"F604602",
            "courierNo":"F6046024088",
            "courierName":"Courier Name",
            "courierMobile":"09123456789"
      }],
      "warning": ""
	}
}

错误响应事例. 错误码 see reference (opens new window)

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