跳转到内容

代付回调

回调地址

methodurl
POST商户提供的回调地址

头部信息(header)

header参数入参参数描述
timestamp请求时间戳
nonce随机值
countryPK
appCode应用编码

回调参数

参数类型必需长度描述
merchantOrderNoStringyes32商户订单号
tradeNoStringyes平台订单号
amountStringyes交易金额
serviceAmountStringyes服务费用 eg:18.02
statusIntyes代付状态,2:成功 3:失败
errorCodenumberyes订单失败状态错误码
errorMessageStringyes订单失败错误信息,详见下方说明
completeTimeStringyes完成时间 当前国家时区 yyyy-MM-dd HH:mm:ss格式
signStringyes签名
成功回调示例
{
"merchantOrderNo": "OrderNoExample",
"tradeNo": "TF2501010001PK0000000000000000",
"amount": "1000.00",
"serviceAmount": "25.50",
"status": 2,
"errorCode": null,
"errorMessage": null,
"completeTime": "2025-05-01 00:00:00",
"sign": "TEEMO_SIGN"
}
失败回调示例
{
"merchantOrderNo": "OrderNoExample",
"tradeNo": "TF2501010001PK0000000000000000",
"amount": null,
"serviceAmount": null,
"status": 3,
"errorCode": 1004,
"errorMessage": "Wallet limit exceeded, kindly contact user to upgrade or restore limit.",
"completeTime": "2025-05-01 00:00:00",
"sign": "TEEMO_SIGN"
}

错误信息说明

errorCodeerrorMessage补充说明
1003Multiple failures within 30 minutes. Kindly refer to the previous reason, contact the user to change the card or retry later.前述原因是指,最近两次的失败原因,需要根据此原因决定改卡或重试
1004Wallet limit exceeded, kindly contact user to upgrade or restore limit.EP/JZ超过日/月/年限额
1005Transaction amount exceeds limit, kindly retry within allowed range.请求金额100-50000超限
1006Wallet account frozen, kindly contact user to change card and retry.用户钱包被风控(冻结、休眠、临时管控)
1007Wallet account abnormal, kindly contact user to verify account and retry.用户钱包信息错误(卡号或CNIC填错、未激活、未通过认证)
1008Request field error, kindly verify and retry.上传技术参数有误,未按文档要求
1009Channel request error, technicians will fix ASAP.维护
1010Unstable network, kindly retry later.网络波动
1011Parameter validation error, kindly verify and retry.上传技术参数有误,未按文档要求
1012Payment method error, kindly select the right way and try again.注意区分钱包账户和银行账户
1013Invalid receiver information, kindly verify and retry.请求用户参数问题,用户信息无效
1014Account inexist or CNIC mismatch, kindly verify or register wallet then retry.用户钱包信息错误(卡号或CNIC填错、未激活、未通过认证)
1015Insufficient balance, kindly contact user to recharge and retry.余额不足
9999Others由于银行端给定信息不足而导致的其他不明因素

回调返回

参数类型必需长度描述
SUCCESSStringyes必须返回”SUCCESS”否则会重复回调
回调示例
SUCCESS