统一下单

商户业务系统通过统一下单接口发起支付收款订单，支付网关会根据商户配置的支付通道路由支付通道完成支付下单。支付网关根据不同的支付方式返回对应的支付参数，业务系统使用支付参数发起收款。

接口说明

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

请求URL：https://pay.tengjukeji.com/api/pay/unifiedOrder

请求方式：POST

请求类型：application/json 或 application/x-www-form-urlencoded

请求参数

请求示例数据

{
"mchNo":"M1736343150",
"appId":"677e7e6ee4b05b10a3008d86",
"wayCode":"WX_JSAPI",
"mchOrderNo":"P1767599781229583",
"amount":100,
"currency":"cny",
"clientIp":"1.182.4.123",
"expiredTime":3600,
"divisionMode":0,
"reqTime":1767599781000,
"version":"1.0",
"signType":"MD5",
"subject":"初一学杂费",
"body":"初一学杂费",
"extParam":"feeType",
"channelExtra":{
    "openid":"用户的微信openid或支付宝userid",
    "subAppId":"小程序appid"
},
"notifyUrl":"回调地址",
"sign":"66A5767CAEE9A2AA8CB5E3E53FF00CCC"
}

加密后的示例数据

{
"mchNo":"M1736343150",
"encryptOpenApiData":"MDEyMzQ1Njc4OXlpeXVhbs3fCP1OTRJO1eS5FCleyBh0LEbWfWmyn5YHy1AF6lB9o9J0BTbjhJqYKGRvBE6E36iIFneMFxDW9XBEZpH0Jit8vHW1VfgBv7ukxV289Z29z3mzleE75ws+KPRQVUnM2Pmk+MmGFdkPccxXYFpEGQEpHg6cO2aYaS9Btv63zcR9MzJLIhHd4w6fxLzIJvT\/FA252V4hBnZ1dpODVixB\/RS1asgXHbS02inUh522\/u531YfLI8TBxJ8EDWFm5P37d+efMiTPkeQQxeyo1qiRkLlOaA8APl+69kfdJOe6ST7Jbkdoa24bajD1vMxh9FU+9N3DdRhNLljhZ289RmioUK+LKFrTeiPdXE3YbTad840IwBptyyAOoalSidcXFxh8NOUMUWAaD44EqPyULEo+eL8Tf+bNfI78ZbS4GET8+A7QzA0xKG06B60bISPNpbDkAKCXE7ewb\/lUhRPt7h7DzR8wPvN8y9bi9nd2FSVjPi7ZBDIghJg7yCvcbCx65dPEfd8T\/Q4Y2Ev\/a8FBLrTp43ymKaVehoN4ps50CYYcqPlx8K8E1960UIE1exR9S+4Lg2o65kwdO4X+Zd4BmKMQpyltniQCR\/4ADME2uB7H9++Rhtu5I5UYJ7w7n6G0k2HUnDQj+WjIl21lVKK4DZEQnKaV3kbX5TGZ7Bs28UIEdWI+VG5VVjzlsWBQw9cdsckRMojKUByoD0ZUfeyNK4Iym1V7WwhRhzbhY3RpU+OqqucW5DW2w1K6dtYaFycl2eDxGw=="
}

终端设备信息说明

解密encryptData后的 data数据格式

返回示例数据加密的

{
"code":0,
"encryptData":"MDEyMzQ1Njc4OXlpeXVhboKxxkEtL3+19YKaQgas4KDX7P6b2Om\/mV4DhEQqVLNrev9eH9g7b1voGYKv5aS2ICXkbSGMfZyAeRdL+rQw+Rce0i0gFXJWrXl72wdZufqFhgGQ5bRhSuN6dNVqJf\/wRi4I6YZQ9u3W3cFN8a+phKv75+NNAJw8CPY8O9tWVpai20Cb\/h1YlrScrqNWR1xkMtoFhXaWiSvk3ofRl\/pXRQDVnVqPXSVtW41G7YRsCoDa61def8\/Uvjdx4Z63KgBuJldPTEFuP8pCx1m8XYQSqeo+XHsz+ESEr8Vy18LNkXtA0GI1yHpfFcQLk9PEO22jcMWZPPTQkTgovJQZjohBgaN1oFBMZB+gji87oQu71BxS9CCY+6MAqzKXJlZ4zq0EzRNJ9J9o1z9LRLo2MwBy2t2KTuQZ1lsonSuOb95QMqyUEkc+62MDKpKCEK1BHHaUhgTeQK2vGSjsR8x8DPwhl24b78KXJAl+TywtAkDNTaOy0Ssk5HGuhXnP0SGa83RrH3ixdzGyF+r3PvPm66wSfFb5tJa1IRnuGdfeAZMOLzLTH50noDZ1e+mBHO7I64eUXonbRqRA+ONlI4QLPqjX\/Ax049ChC0VyUsYXYCrMDwsZrO9wp9lBg1tVnNGgAmrqwq8r8ip543pfDvIb3YPQ6RnGXXE9ciTQExCAU7rmCd3U26aEzxRSurHwmBE4VJZmUUbeKikjQD8YWXf1dmbLntINzdyVstepOJCmsKr7tO7t0L7WHEpRJMLJo0TTThIb4oMvRNtsW6AXeoxVawfJxSYYWjszotXp+JxuhnqpVPOPvOljM9EFvKoRblQTatOCM6\/Y7HUkWYTKKrDi9qjidrnvk4MMat6oD8U+pyEMexn\/4ngL0eMIH9TPxVnSYhsKaIwc+un4JE9QgJH7fGx8ZFU=",
"msg":"SUCCESS",
"sign":"A01228B9855D11F280081E1670C8EBB1"
}

{
"code":0,
"msg":"SUCCESS",
"sign":"A01228B9855D11F280081E1670C8EBB1",
"data":{
    "payOrderId":"P2008085145877413889",
    "mchOrderNo":"P1767599781229583",
    "payData":"{
        \"appId\":\"wx952a3e36a8d0ac59\",
        \"timeStamp\":\"1767599782\",
        \"nonceStr\":\"9a52cb78016046dc908dbe0b63afa5dd\",
        \"package\":\"prepay_id=wx05155622603813b1133ded177663e20001\",
        \"signType\":\"RSA\",
        \"paySign\":\"x41rh1r+WfWG+L7NK+wmyC8p7e+v42TB1KXI0XsV5TUiMH6vHQc7y3x4TSxrNnVNl4PHH4a92S\/woNCEaKMyhzsq3782wq1FlmMQE\/gRbrvDrXI4vNeetavCmp7\/OoJ034nI9dqYkD4qKROokE9Sp9\/FHHsAjj8DB4v+NvPhn2wmQNLtnkkZfdMzup3phXXYqES\/vwMK6XSXuozpAuhus+aw1Y6tzG0mDeGDqXW9TFIb7RgEwceWH5j5IgWvGJi8ZVoE99rC3Tht1ko+HYs\/LefXvAYC+ZlB8fucrAbSj0NIdCDWxOMaghLnQp6\/hOmooX+Y3CTH++VFqvky7v+eVw==\"
    }",
    "payDataType":"wxapp",
    "orderState":1
}
}

返回示例数据二

{
"code":9999,
"msg":"商户(M1761720556)无此接口[API_PAY_ORDER]权限！"
}

支付方式

channelExtra参数说明

当 wayCode=AUTO_BAR 或 wayCode=ALI_BAR 或 wayCode=WX_BAR 或 wayCode=YSF_BAR 时，channelExtra必须传auth_code，为用户的付款码值，channelExtra示例数据如：

{"authCode": "13920933111042"}

当 wayCode=ALI_JSAPI或 wayCode=ALI_LITE 时，channelExtra必须传buyerUserId，为支付宝用户ID，channelExtra示例数据如：

{"buyerUserId": "2088702585070844"}

当 wayCode=WX_JSAPI 或 wayCode=WX_LITE 时，channelExtra必须传openid，为微信OpenId， channelExtra示例数据如：

{"openid": "o6BcIwvSiRpfS8e_UyfQNrYuk2LI"}

注意： 若当前为特约商户，并且商户使用的自己的公众号或者小程序获取到的openId时：

需要：

• 商户自己的公众号或者小程序的AppId需要在服务商里进行关联， 请联系运营平台进行配置；
• channelExtra参数中添加 subAppId 参数，该参数为商户的公众号或小程序的AppId，示例：

{ "openid": "o6BcIwvSiRpfS8e_UyfQNrYuk2LI", "subAppId"："wx08b5a41f7a27abf1" }

当 wayCode=ALI_QR 或 wayCode=WX_NATIVE 时，channelExtra可以传payDataType设置返回支付数据支付类型。此时payDataType可以为：codeUrl-二维码地址,codeImgUrl-二维码图片地址，不传payDataType默认返回codeUrl类型, channelExtra示例数据如：

{"payDataType": "codeImgUrl"}

当 wayCode=QR_CASHIER 时，channelExtra可以传payDataType和entryPageType。

entryPageType指定聚合码扫码时进入H5或小程序页面，默认为H5页面。h5-h5页面，lite-小程序页面。

payDataType设置返回支付数据支付类型，此时payDataType可以为：codeUrl-二维码地址,codeImgUrl-二维码图片地址，不传payDataType默认返回codeUrl类型, channelExtra示例数据如：

{"entryPageType": "lite", "payDataType": "codeImgUrl"}

当 wayCode=ALI_WAP 时，channelExtra可以传payDataType设置返回支付数据支付类型。此时payDataType可以为：form-返回自动跳转的支付表单,codeImgUrl-返回一个二维码图片URL,payUrl-返回支付链接，不传payDataType默认返回payUrl类型, channelExtra示例数据如：

{"payDataType": "form"}

当 wayCode=ALI_PC 时，channelExtra可以传payDataType设置返回支付数据支付类型。此时payDataType可以为：form-返回自动跳转的支付表单,payUrl-返回支付链接，不传payDataType默认返回payUrl类型, channelExtra示例数据如：

{"payDataType": "form"}

查询订单

商户通过该接口查询订单，支付网关会返回订单最新的数据

接口说明

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

请求URL：https://pay.tengjukeji.com/api/pay/query

请求方式：POST

请求类型：application/json 或 application/x-www-form-urlencoded

请求参数

请求示例数据

{
  "payOrderId": "P202106181104177050002",
  "appId": "60cc09bce4b0f1c0b83761c9",
  "sign": "46940C58B2F3AE426B77A297ABF4D31E",
  "signType": "MD5",
  "reqTime": "1624006009",
  "mchNo": "M1623984572",
  "version": "1.0"
}

返回示例数据

{
  "code": 0,
  "data": {
    "amount": 58,
    "appId": "60cc09bce4b0f1c0b83761c9",
    "body": "商品描述",
    "channelOrderNo": "2021061822001423031419593035",
    "clientIp": "192.166.1.132",
    "createdAt": 1623985457705,
    "currency": "cny",
    "extParam": "",
    "ifCode": "alipay",
    "mchNo": "M1623984572",
    "mchOrderNo": "mho1623985457320",
    "payOrderId": "P202106181104177050002",
    "state": 2,
    "subject": "商品标题",
    "successTime": 1623985459000,
    "wayCode": "ALI_BAR"
  },
  "msg": "SUCCESS",
  "sign": "9548145EA12D0CD8C1628BCF44E19E0D"
}

关闭订单

商户通过该接口关闭订单，支付网关会对订单完成关闭处理。

接口说明

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

请求URL：https://pay.tengjukeji.com/api/pay/close

请求方式：POST

请求类型：application/json 或 application/x-www-form-urlencoded

请求参数

请求示例数据

{
  "payOrderId": "P202106181104177050002",
  "appId": "60cc09bce4b0f1c0b83761c9",
  "sign": "46940C58B2F3AE426B77A297ABF4D31E",
  "signType": "MD5",
  "reqTime": "1624006009",
  "mchNo": "M1623984572",
  "version": "1.0"
}

返回示例数据

{
  "code": 0,
  "data": {
    "errCode": '',
    "errMsg": ''
  },
  "msg": "SUCCESS",
  "sign": "9548145EA12D0CD8C1628BCF44E19E0D"
}

条码换取openId

商户通过该接口上送刷卡条码值， 换取到微信openId。

接口说明

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

请求URL：https://pay.tengjukeji.com/api/pay/queryOpenIdByBarcode

请求方式：POST

请求类型：application/json 或 application/x-www-form-urlencoded

请求参数

请求示例数据

{
  "barCode": "202106181104177050002",
  "sign": "46940C58B2F3AE426B77A297ABF4D31E",
  "signType": "MD5",
  "reqTime": "1624006009",
  "mchNo": "M1623984572",
  "version": "1.0"
}

返回示例数据

{
  "code": 0,
  "data": {
    "openId": '',
    "subOpenId": ''
  },
  "msg": "SUCCESS",
  "sign": "9548145EA12D0CD8C1628BCF44E19E0D"
}

支付通知

当订单支付成功时，支付网关会向商户系统发起回调通知。如果商户系统没有正确返回，支付网关会延迟再次通知。

接口说明

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

请求URL：该链接是通过统一下单接口提交的参数notifyUrl设置，如果无法访问链接，商户系统将无法接收到支付中心的通知。

请求方式：POST

请求类型：application/x-www-form-urlencoded

通知参数

以下扩展参数如需同步传递需在商户后台配置

> 返回结果

业务系统处理后同步返回给支付中心，返回字符串 success 则表示成功，返回非success则表示处理失败，支付中心会再次通知业务系统。（通知频率为0/30/60/90/120/150,单位：秒）

注意：返回的字符串不区分大小写，字符串前后不能有空格和换行符。

通知示例数据

{
    "amount": 5,
    "body": "商品描述",
    "clientIp": "192.166.1.132",
    "createdAt": "1622016572190",
    "currency": "cny",
    "extParam": "",
    "ifCode": "wxpay",
    "mchNo": "M1621873433953",
    "appId": "60cc09bce4b0f1c0b83761c9",
    "mchOrderNo": "mho1621934803068",
    "payOrderId": "20210525172643357010",
    "state": 3,
    "subject": "商品标题",
    "wayCode": "WX_BAR",
    "sign": "C380BEC2BFD727A4B6845133519F3AD6"
}

获取渠道用户ID

商户通过该接口获取渠道的用户ID，如微信的openID，支付宝的userId。该接口通过跳转获取到用户ID后，会跳转到商户上传的redirectUrl地址，并传递用户ID参数

接口说明

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

请求URL：https://pay.tengjukeji.com/api/channelUserId/jump

请求方式：GET

请求类型：application/json 或 application/x-www-form-urlencoded

请求参数

请求示例数据

{
  "mchNo": "M1621873433953",
  "appId": "60cc09bce4b0f1c0b83761c9",
  "ifCode": "wxpay",
  "redirectUrl": "https://pay.tengjukeji.com",
  "sign": "A5C93D50743126ED91AA6ED96CDEEEF8",
  "signType": "MD5",
  "reqTime": "1622011236571",
  "version": "1.0"
}

当获取到渠道用户ID后，会301重定向到跳转地址，传递参数如下

完整跳转URL示例

https://pay.tengjukeji.com/toU?channelUserId=o6BcIwvSiRpfS8e_UyfQNrYuk2LI

返回码