跳转到内容

创建代收

请求地址

methodurl
POST/api/pay/payment/create/v1

头部信息(header)

header 参数入参参数描述
timestamp请求时间戳
nonce随机值
countryCL
app_codeapp 编号

支持支付方式列表(paymentType)

支付方式名称PaymentType
All-In-One Checkout601
WEBPAY602
KHIPU603
PAGO46604
BANK_TRANSFER605
WALLET606
FINTOC607
HITES608
SERVIFACIL609

聚合收银台checkout 包含:

KHIPU WEBPAY BANK TRANSFER MACH PAGO46 FINTOC HITES
SERVIFACIL

请求参数

字段类型必需长度描述
merchantOrderNoStringyes32商户订单号
paymentTypeIntyes支付方式,详见上方支付方式列表
amountStringyes20代收金额,仅支持整数,比索
expirationTimeLongno过期时间,毫秒级时间戳 eg:1735660800000
realNameStringyes64用户姓名
emailStringyes50用户邮箱:满足正则表达式即可
phoneStringyes50电话号码7位数,不包含区号
idCardNumberStringno50身份证号码 详情请到银行列表中最下方有对应规则
signStringyes签名
callbackUrlStringno200回调地址
请求示例
{
"realName": "TeemoPay",
"amount": "10000",
"phone": "1234567890",
"callbackUrl": "https://www.callbackexample.com",
"merchantOrderNo": "OrderNoExample",
"email": "TeemoPay@example.com",
"paymentType": 601,
"sign": "YOUR_SIGN"
}

返回参数

字段类型必需长度描述
merchantOrderNoStringyes32商户订单号
tradeNoStringyes32平台订单号
amountStringyes32交易金额
paymentTypeIntyes3支付方式
paymentInfoStringyes32主要付款信息,返回的是实际用于付款的信息,例如:付款编号
additionalInfoJSONObjectno扩展信息
statusIntyes代收状态, 1:成功 3:失败
errorMsgStringno错误信息,失败时返回
{
"msg": "success",
"traceId": "747bbf80261844ed85b809212aab0d81.85.17422898158610299",
"code": 200,
"data": {
"amount": "10000",
"tradeNo": "TS2501010001CO0000000000000000",
"merchantOrderNo": "OrderNoExample",
"paymentType": 601,
"additionalInfo": {
},
"paymentInfo": "https://www.paymentLinkExample.com",
"status": 1
}
}