1. 收款下单接口

简要描述

• 商户代付-收单接口

请求URL

• {domain}/open-api/payment/generate

请求方式

• POST

请求头

参数名	必选	类型	说明
Content-Type	是	string	application/json

请求体参数

参数名	必选	类型	说明
appId	是	string	应用APPID
param	是	string	参数体
sign	是	string	签名

param参数

参数名	必填	类型	长度限制	示例	说明
timestamp	是	long	-	1677495496979	当前时间戳
mchOrderId	是	string	1-32	CCP20220428011068111	商户订单id, 格式：字母+数字，1-32位
amount	是	long	-	-	收款金额 (单位为分, 当国家为印尼时，单元为元)
countryCode	是	string	-	-	国家编码 (PH, ID, MY, TH)
currency	是	string	-	-	标价币种 (PHP, IDR, MYR, THB)
channelType	是	string	-	-	渠道类型 (QR, ONLINE_BANKING, EWALLET, BANK_TRANSFER, CARD)
channelCode	是	string	-	参考列表	Platform收单渠道Code
customerName	是	string	1-100	-	付款人姓名
email	是	string	1-150	-	付款人邮箱
mobile	是	string	10-13	-	付款人电话
terminalType	是	string	-	-	设备类型 (WEB, WAP, APP)
osType	否	string	-	-	操作系统 (IOS, ANDROID, OTHER)
notifyUrl	是	string	1-200	-	商户交易通知 URL
redirectUrl	否	string	1-500	-	重定向 URL, channelType为ONLINE_BANKING, EWALLET, CARD时必填
remark	否	string	1-250	-	收单备注

请求示例

请求体

{
   "appId": "733b887a4a784708bb369524db5b6ded",
   "sign": "A5Vd8NcQvU3QT41Yee2jCIK58jDAKZ6kP5gEE4q7Yu92hUCY3k00FKTSlCNU+CcZm0LSrGbEMFMID3p7uvXaqy5khNv3kPndrgp7MIRHUmQnMgRK+g1XG7PzWdnrqlXc3g+L+kqVja+qrFRz+uVS6GLKLR1P4AtgTa9dok6NU7YTWOnG9r/FwIVx/At4czfEpI10pvg2TptVpiANmseGmz4G30hkaYTTNahkcOMQJn6PDFjivHvjNLZNJVOqHQzVUa+kca1yZZMPHtgxR647KjoY2oAjjl0Y45GL6zP9qHD/eVwcPPAPrRZ4K2o05OJnPf67fAcWNVqpnu6ZGQIXhQ==",
   "param": "{\"timestamp\":1715595802,\"mchOrderId\":\"10e5595801938341100\",\"currency\":\"PHP\",\"countryCode\":\"PH\",\"channelType\":\"QR\",\"channelCode\":\"PH_QRPH_DYNAMIC\",\"customerName\":\"name\",\"email\":\"test@email.com\",\"mobile\":\"09123456789\",\"amount\":10000,\"remark\":\"remark\",\"notifyUrl\":\"https://www.test.com\",\"redirectUrl\":\"https://www.test.com\",\"terminalType\":\"WEB\"}"
}

如何构造请求体

---

响应参数

参数名	类型	说明
code	integer	响应码
message	string	响应信息
data	Object	数据

data参数

参数名	类型	说明
mchOrderId	string	商户订单号
transactionId	string	交易编号
payData	string	支付信息(VA、跳转URL或者QR Content)
channelType	string	渠道类型
channelCode	string	收单渠道Code
cashierUrl	string	支付指引链接

响应示例

{
  "code": 10000,
  "message": "Success",
  "data": {
    "mchOrderId": "10e051066810618100",
    "transactionId": "CU510579106014826496",
    "payData": "00020101021128760011ph.ppmi.p2m0111OPDVPHM1XXX03157771480000000170416529481372394713405030005204601653036085802PH5908PayCools6015City Of Mandalu62310010ph.allbank05062110000803***88310012ph.ppmi.qrph0111OPDVPHM1XXX630476F2",
    "channelType": "QR",
    "channelCode": "PH_QRPH_DYNAMIC"
  }
}

响应码集合

返回失败案例

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