代付回调
回调地址
| method | url |
|---|---|
| POST | 商户提供的回调地址 |
头部信息(header)
| header参数 | 入参参数描述 |
|---|---|
| timestamp | 请求时间戳 |
| nonce | 随机值 |
| country | PK |
| appCode | 应用编码 |
回调参数
| 参数 | 类型 | 必需 | 长度 | 描述 |
|---|---|---|---|---|
| merchantOrderNo | String | yes | 32 | 商户订单号 |
| tradeNo | String | yes | 平台订单号 | |
| amount | String | yes | 交易金额 | |
| serviceAmount | String | yes | 服务费用 eg:18.02 | |
| status | Int | yes | 代付状态,2:成功 3:失败 | |
| errorCode | number | yes | 订单失败状态错误码 | |
| errorMessage | String | yes | 订单失败错误信息,详见下方说明 | |
| completeTime | String | yes | 完成时间 当前国家时区 yyyy-MM-dd HH:mm:ss格式 | |
| sign | String | yes | 签名 |
{ "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"
}错误信息说明
| errorCode | errorMessage | 补充说明 |
|---|---|---|
| 1003 | Multiple failures within 30 minutes. Kindly refer to the previous reason, contact the user to change the card or retry later. | 前述原因是指,最近两次的失败原因,需要根据此原因决定改卡或重试 |
| 1004 | Wallet limit exceeded, kindly contact user to upgrade or restore limit. | EP/JZ超过日/月/年限额 |
| 1005 | Transaction amount exceeds limit, kindly retry within allowed range. | 请求金额100-50000超限 |
| 1006 | Wallet account frozen, kindly contact user to change card and retry. | 用户钱包被风控(冻结、休眠、临时管控) |
| 1007 | Wallet account abnormal, kindly contact user to verify account and retry. | 用户钱包信息错误(卡号或CNIC填错、未激活、未通过认证) |
| 1008 | Request field error, kindly verify and retry. | 上传技术参数有误,未按文档要求 |
| 1009 | Channel request error, technicians will fix ASAP. | 维护 |
| 1010 | Unstable network, kindly retry later. | 网络波动 |
| 1011 | Parameter validation error, kindly verify and retry. | 上传技术参数有误,未按文档要求 |
| 1012 | Payment method error, kindly select the right way and try again. | 注意区分钱包账户和银行账户 |
| 1013 | Invalid receiver information, kindly verify and retry. | 请求用户参数问题,用户信息无效 |
| 1014 | Account inexist or CNIC mismatch, kindly verify or register wallet then retry. | 用户钱包信息错误(卡号或CNIC填错、未激活、未通过认证) |
| 1015 | Insufficient balance, kindly contact user to recharge and retry. | 余额不足 |
| 9999 | Others | 由于银行端给定信息不足而导致的其他不明因素 |
回调返回
| 参数 | 类型 | 必需 | 长度 | 描述 |
|---|---|---|---|---|
| SUCCESS | String | yes | 必须返回”SUCCESS”否则会重复回调 |
SUCCESS