交易确认

实体电商类商户业务系统通过交易确认接口,对物流商品订单发起交易收货确认,以实现交易资金的到账。

接口说明

适用对象:普通商户 特约商户

请求URL:https://pay.tengjukeji.com/api/pay/delaytrans/confirm

请求方式:POST

请求类型:application/jsonapplication/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方式

请求示例数据

  1. {
  2. "payOrderId": "P1899289092710080514",
  3. "mchOrderNo": "M17416582138528047",
  4. "sign": "2762CDB48D5179281DB6C0995E4EEDE0",
  5. "reqTime": "1624007315",
  6. "version": "1.0",
  7. "appId": "60cc09bce4b0f1c0b83761c9",
  8. "signType": "MD5",
  9. "mchNo": "M1623984572",
  10. }
字段名 变量名 必填 类型 示例值 描述
返回状态 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:失败

返回示例数据

  1. {
  2. "code": 0,
  3. "data": {
  4. "channelOrderNo": "P1899401435662186497",
  5. "code": "00000000",
  6. "delayTransAt": "20250311",
  7. "delayTransNo": "P1899400646885176321",
  8. "mchOrderNo": "M17416873745406186",
  9. "msg": "交易成功",
  10. "payOrderId": "P1899400646885176321",
  11. "state": "S"
  12. },
  13. "msg": "SUCCESS",
  14. "sign": "F4DA202C516D1F33A12F1E547C5004FD"
  15. }

返回示例数据二

  1. {
  2. "code": 0,
  3. "data": {
  4. "channelOrderNo": "002900TOP3B250311103947P562ac13603800000",
  5. "code": "23000001",
  6. "msg": "原交易不存在"
  7. "payOrderId": "M17416582138528047",
  8. "mchOrderNo": "P1899289092710080514"
  9. "state": "F"
  10. },
  11. "msg": "SUCCESS",
  12. "sign": "F4DA202C516D1F33A12F1E547C5004FD"
  13. }

交易确认退款

实体电商类商户业务系统通过交易确认退款接口,对物流商品订单发起收货后的退款申请,以实现客户交易完成后的退款请求。 注意,调用完交易确认退款接口后还需再调用退款接口

接口说明

适用对象:普通商户 特约商户

请求URL:https://pay.tengjukeji.com/api/pay/delaytrans/confirmrefund

请求方式:POST

请求类型:application/jsonapplication/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方式

请求示例数据

  1. {
  2. "payOrderId": "P1899289092710080514",
  3. "mchOrderNo": "M17416582138528047",
  4. "sign": "2762CDB48D5179281DB6C0995E4EEDE0",
  5. "reqTime": "1624007315",
  6. "version": "1.0",
  7. "appId": "60cc09bce4b0f1c0b83761c9",
  8. "signType": "MD5",
  9. "mchNo": "M1623984572",
  10. }
字段名 变量名 必填 类型 示例值 描述
返回状态 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:失败

返回示例数据

  1. {
  2. "code": 0,
  3. "data": {
  4. "channelOrderNo": "P1899402872794349569",
  5. "code": "00000000",
  6. "msg": "交易成功"
  7. "payOrderId": "P1899400648085176351",,
  8. "delayTransNo": "P1899400648085176369"
  9. "delayTransAt": "20250311"
  10. "mchOrderNo": "M17416873744406369"
  11. "state": "S"
  12. },
  13. "msg": "SUCCESS",
  14. "sign": "F4DA202C516D1F33A12F1E547C5004FD"
  15. }

返回示例数据二

  1. {
  2. "code": 0,
  3. "data": {
  4. "channelOrderNo": "002900TOP3B250311103947P562ac13603800000",
  5. "code": "23000001",
  6. "msg": "原交易不存在"
  7. "payOrderId": "M17416582138528047",
  8. "mchOrderNo": "P1899289092710080514"
  9. "state": "F"
  10. },
  11. "msg": "SUCCESS",
  12. "sign": "F4DA202C516D1F33A12F1E547C5004FD"
  13. }

返回码

code 描述
0 成功
9999 异常,具体错误详见msg字段