交易确认
实体电商类商户业务系统通过交易确认接口,对物流商品订单发起交易收货确认,以实现交易资金的到账。
接口说明
适用对象:普通商户 特约商户
请求URL:https://pay.tengjukeji.com/api/pay/delaytrans/confirm
请求方式:POST
请求类型:application/json 或 application/x-www-form-urlencoded
请求参数
| 字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述 |
|---|---|---|---|---|---|
| 商户号 | mchNo | 是 | String(64) | M1621873433953 | 商户号 |
| 应用ID | appId | 是 | String(64) | 60cc09bce4b0f1c0b83761c9 | 应用ID |
| 支付订单号 | payOrderId | 是 | String(30) | P20160427210604000490 | 支付中心生成的订单号,与mchOrderNo二者传一即可 |
| 商户订单号 | mchOrderNo | 是 | String(64) | 20160427210604000490 | 商户生成的支付订单号,与payOrderId二者传一即可 |
| 请求时间 | reqTime | 是 | long | 1622016572190 | 请求接口时间,13位时间戳 |
| 接口版本 | version | 是 | String(3) | 1.0 | 接口版本号,固定:1.0 |
| 签名 | sign | 是 | String(32) | C380BEC2BFD727A4B6845133519F3AD6 | 签名值,详见签名算法 |
| 签名类型 | signType | 是 | String(32) | MD5 | 签名类型,目前只支持MD5或RSA2方式 |
请求示例数据
{"payOrderId": "P1899289092710080514","mchOrderNo": "M17416582138528047","sign": "2762CDB48D5179281DB6C0995E4EEDE0","reqTime": "1624007315","version": "1.0","appId": "60cc09bce4b0f1c0b83761c9","signType": "MD5","mchNo": "M1623984572",}
| 字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述 |
|---|---|---|---|---|---|
| 返回状态 | code | 是 | int | 0 | 0-处理成功,其他-处理有误,详见错误码 |
| 返回信息 | msg | 否 | String(128) | 签名失败 | 具体错误原因,例如:签名失败、参数格式校验错误 |
| 签名信息 | sign | 否 | String(32) | CCD9083A6DAD9A2DA9F668C3D4517A84 | 对data内数据签名,如data为空则不返回 |
| 返回数据 | data | 否 | String(512) | {} | 返回下单数据,json格式数据 |
data数据格式
| 字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述 |
|---|---|---|---|---|---|
| 支付订单号 | payOrderId | 是 | String(30) | P20160427210604000490 | 交易确认退款时传入,原样返回;示例值:P20160427210604000490 |
| 商户订单号 | mchOrderNo | 是 | String(64) | 20160427210604000490 | 交易确认退款时传入,原样返回;示例值:20160427210604000490 |
| 业务流水号 | channelOrderNo | 是 | String(30) | 00470topac132fef00000 | 示例值:00470topac132fef00000 |
| 支付公司业务返回码 | code | 是 | String(30) | 00000000 | 业务返回码;示例值:00000000 |
| 支付公司业务返回描述 | msg | 是 | String(30) | 交易成功 | 业务返回描述;示例值:交易成功 |
| 交易结果 | state | 是 | String | S | 状态;示例值:S P:处理中 S:成功 F:失败 |
返回示例数据
{"code": 0,"data": {"channelOrderNo": "P1899401435662186497","code": "00000000","delayTransAt": "20250311","delayTransNo": "P1899400646885176321","mchOrderNo": "M17416873745406186","msg": "交易成功","payOrderId": "P1899400646885176321","state": "S"},"msg": "SUCCESS","sign": "F4DA202C516D1F33A12F1E547C5004FD"}
返回示例数据二
{"code": 0,"data": {"channelOrderNo": "002900TOP3B250311103947P562ac13603800000","code": "23000001","msg": "原交易不存在""payOrderId": "M17416582138528047","mchOrderNo": "P1899289092710080514""state": "F"},"msg": "SUCCESS","sign": "F4DA202C516D1F33A12F1E547C5004FD"}
交易确认退款
实体电商类商户业务系统通过交易确认退款接口,对物流商品订单发起收货后的退款申请,以实现客户交易完成后的退款请求。
注意,调用完交易确认退款接口后还需再调用退款接口
接口说明
适用对象:普通商户 特约商户
请求URL:https://pay.tengjukeji.com/api/pay/delaytrans/confirmrefund
请求方式:POST
请求类型:application/json 或 application/x-www-form-urlencoded
请求参数
| 字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述 |
|---|---|---|---|---|---|
| 商户号 | mchNo | 是 | String(64) | M1621873433953 | 商户号 |
| 应用ID | appId | 是 | String(64) | 60cc09bce4b0f1c0b83761c9 | 应用ID |
| 支付订单号 | payOrderId | 是 | String(30) | P20160427210604000490 | 支付中心生成的订单号,与mchOrderNo二者传一即可 |
| 商户订单号 | mchOrderNo | 是 | String(64) | 20160427210604000490 | 商户生成的支付订单号,与payOrderId二者传一即可 |
| 请求时间 | reqTime | 是 | long | 1622016572190 | 请求接口时间,13位时间戳 |
| 接口版本 | version | 是 | String(3) | 1.0 | 接口版本号,固定:1.0 |
| 签名 | sign | 是 | String(32) | C380BEC2BFD727A4B6845133519F3AD6 | 签名值,详见签名算法 |
| 签名类型 | signType | 是 | String(32) | MD5 | 签名类型,目前只支持MD5或RSA2方式 |
请求示例数据
{"payOrderId": "P1899289092710080514","mchOrderNo": "M17416582138528047","sign": "2762CDB48D5179281DB6C0995E4EEDE0","reqTime": "1624007315","version": "1.0","appId": "60cc09bce4b0f1c0b83761c9","signType": "MD5","mchNo": "M1623984572",}
| 字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述 |
|---|---|---|---|---|---|
| 返回状态 | code | 是 | int | 0 | 0-处理成功,其他-处理有误,详见错误码 |
| 返回信息 | msg | 否 | String(128) | 签名失败 | 具体错误原因,例如:签名失败、参数格式校验错误 |
| 签名信息 | sign | 否 | String(32) | CCD9083A6DAD9A2DA9F668C3D4517A84 | 对data内数据签名,如data为空则不返回 |
| 返回数据 | data | 否 | String(512) | {} | 返回下单数据,json格式数据 |
data数据格式
| 字段名 | 变量名 | 必填 | 类型 | 示例值 | 描述 |
|---|---|---|---|---|---|
| 业务流水号 | channelOrderNo | 是 | String(30) | P1899289482566443010 | 示例值:P1899402872794349569 |
| 支付公司业务返回码 | code | 是 | String(30) | 00000000 | 业务返回码;示例值:00000000 |
| 支付公司业务返回描述 | msg | 是 | String(30) | 交易成功 | 业务返回描述;示例值:交易成功 |
| 支付订单号 | payOrderId | 是 | String(30) | P20160427210604000490 | 交易确认退款时传入,原样返回;示例值:P20160427210604000490 |
| 商户订单号 | mchOrderNo | 是 | String(64) | 20160427210604000490 | 交易确认退款时传入,原样返回;示例值:20160427210604000490 |
| 交易结果 | state | 是 | String | S | 状态;示例值:S P:处理中 S:成功 F:失败 |
返回示例数据
{"code": 0,"data": {"channelOrderNo": "P1899402872794349569","code": "00000000","msg": "交易成功""payOrderId": "P1899400648085176351",,"delayTransNo": "P1899400648085176369""delayTransAt": "20250311""mchOrderNo": "M17416873744406369""state": "S"},"msg": "SUCCESS","sign": "F4DA202C516D1F33A12F1E547C5004FD"}
返回示例数据二
{"code": 0,"data": {"channelOrderNo": "002900TOP3B250311103947P562ac13603800000","code": "23000001","msg": "原交易不存在""payOrderId": "M17416582138528047","mchOrderNo": "P1899289092710080514""state": "F"},"msg": "SUCCESS","sign": "F4DA202C516D1F33A12F1E547C5004FD"}
返回码
| code | 描述 |
|---|---|
| 0 | 成功 |
| 9999 | 异常,具体错误详见msg字段 |
