创建代收

请求地址

method	url
POST	/api/pay/payment/create/v1

头部信息（header）

header 参数	入参参数描述
timestamp	请求时间戳
nonce	随机值
country	PE
app_code	app 编号

支持支付方式列表（paymentType）

支付方式名称	PaymentType (入参参数)
CHECKOUT（聚合支付链接收银台）	101
CASH（线下）	102
BCP	105
INTERBANK	106
BBVA	107
SCOTIABANK	108
WALLET(包含YAPE、PLIN)	109

收银台样式

请求参数

字段	类型	必需	长度	描述
merchantOrderNo	String	yes	32	商户订单号
paymentType	Int	yes		支付方式: 101 ：checkout（支付链接收银台）
amount	String	yes	20	代收金额(索尔)
expirationTime	Long	no		过期时间,毫秒级时间戳 eg:1735660800000
realName	String	yes	64	用户姓名
email	String	yes	50	用户邮箱：满足正则表达式即可
phone	String	yes	9	电话号码 9 位数不包含区号
sign	String	yes		签名
callbackUrl	String	no	200	回调地址

请求示例

{
    "merchantOrderNo": "OrderNoExample",
    "paymentType": 101,
    "amount": "10.00",
    "realName": "TeemoPay",
    "email": "TeemoPay@example.com",
    "phone": "900000000",
    "callbackUrl": "https://www.callbackexample.com",
    "sign": "YOUR_SIGN"
}

返回参数

字段	类型	必需	长度	描述
merchantOrderNo	String	yes	32	商户订单号
tradeNo	String	yes	32	平台订单号
amount	String	yes	32	交易金额
paymentType	Int	yes	10	支付方式,101:checkout
paymentInfo	String	yes	32	主要付款信息,收银台链接
additionalInfo	JSONObject	no		附加信息
status	Int	yes		代收状态, 1:成功 3:失败
errorMsg	String	no		错误信息,失败时返回

不同支付方式的响应示例：

当 PaymentType 为 101 ：checkout（支付链接收银台）时：

{
  "msg": "success",
  "traceId": "747bbf80261844ed85b809212aab0d81.85.17422898158610299",
  "code": 200,
  "data": {
    "amount": "10.00",
    "tradeNo": "TS2501010001PE0000000000000000",
    "merchantOrderNo": "OrderNoExample",
    "paymentType": 101,
    "additionalInfo": {
      "thirdOrderNum": "12345678901"
    },
    "paymentInfo": "https://www.paymentLinkExample.com",
    "status": 1
  }
}

errorMsg 说明：

errorMsg	说明
Channel request error, technicians will fix ASAP.	渠道维护
Unstable network, kindly retry later.	渠道网络波动