首图支付网关
  1. 对外提供支付相关接口
首图支付网关
  • 对外提供支付相关接口
    • POS机扫码支付后通知接口
      POST
    • 根据工作台编码查询商户号接口
      POST
    • 根据馆藏地编码查询商户号接口
      POST
    • OpenAPI-支付统一下单接口(测试)
      POST
    • OpenAPI-查询支付订单接口(测试)
      POST
    • OpenAPI-支付统一下单接口(正式)
      POST
    • 支付统一下单接口
      POST
    • 查询支付订单接口
      POST
    • 支付记录分页列表查询接口
      POST
    • 支付通知回调
      POST
  • 对外提供退款相关接口
    • OpenAPI-退款接口(测试)
      POST
    • OpenAPI-查询退款订单接口(测试)
      POST
    • 退款接口
      POST
    • 查询退款订单接口
      POST
    • 退款记录分页查询接口
      POST
    • 退款通知回调
      POST
  • 对外提供发票相关接口
    • 读者发票抬头管理
      • 增加
      • 根据id删除
      • 修改
      • 查询读者的发票抬头
    • 开票相关接口
      • 申请开票接口
      • 查询开票状态
      • 再次发送电子发票到邮箱
  1. 对外提供支付相关接口

查询支付订单接口

开发中
POST
/jiafulai/paymentgateway/api/pay/query

请求参数

Body 参数application/json
appId
string 
应用Id
必需
业务系统的应用Id
tenantId
string 
租客Id
必需
租客Id
channelOrderNo
string 
渠道支付订单号
必需
支付网关与支付渠道之间的唯一订单号,与mchOrderNo二者传一个就可以
mchOrderNo
string 
商户订单号
必需
业务系统这一笔支付记录的唯一编号,与channelOrderNo二者传一个就可以
示例
{
    "appId": "string",
    "tenantId": "string",
    "channelOrderNo": "string",
    "mchOrderNo": "string"
}

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST '/jiafulai/paymentgateway/api/pay/query' \
--header 'Content-Type: application/json' \
--data-raw '{
    "appId": "string",
    "tenantId": "string",
    "channelOrderNo": "string",
    "mchOrderNo": "string"
}'

返回响应

🟢200成功
application/json
Body
code
string 
返回状态
必需
COMMON_200-处理成功,其他-处理有误,详见msg
msg
string 
返回信息
可选
具体错误原因,例如:签名失败、参数格式校验错误
data
object 
返回数据
必需
返回下单数据,json格式数据
channelOrderNo
string 
渠道支付订单号
必需
支付网关与支付渠道之间的唯一订单号,与mchOrderNo二者传一即可
appId
string 
应用Id
必需
业务系统的应用Id
mchOrderNo
string 
商户订单号
必需
业务系统这一笔支付记录的唯一编号,与channelPayOrderNo二者传一即可
channelCode
string 
支付渠道编码
必需
用的是工行聚合支付还是对公支付或者其他
wayCode
string 
支付方式编码
可选
用户支付方式:WE_CHAT_PAY-微信支付;ALI_PAY-支付宝;UNION_PAY-银联支付;OTHER-其他
amount
string 
支付金额
必需
单位分
payState
string 
支付状态
必需
支付状态
ORDER_GENERATED-订单生成
PAYMENT_IN_PROGRESS-支付中
PAYMENT_SUCCESS-支付成功
PAYMENT_FAILURE-支付失败
CANCELLED-已撤销
REFUNDED-已退款
ORDER_CLOSED-订单关闭
subject
string 
商品名称
必需
商品名称
body
string 
商品描述
必需
商品描述
payDetail
array [object {7}] 
必需
extJsonb
string 
扩展信息
必需
业务的相关信息都在此
errCode
string 
渠道错误码
可选
渠道下单返回错误码
errMsg
string 
渠道错误描述
可选
渠道下单返回错误描述
createdTime
string 
创建时间
必需
订单创建时间,13位时间戳
successTime
string 
支付成功时间
可选
订单支付成功时间,13位时间戳
示例
{
    "code": "COMMON_200",
    "msg": "签名失败",
    "data": {
        "channelOrderNo": "U12021022311124442600",
        "appId": "90060",
        "mchOrderNo": "20160427210604000490",
        "channelCode": "ICBC_AGGREGATE_PAY",
        "wayCode": "WE_CHAT_PAY",
        "amount": "3000",
        "payState": "PAYMENT_IN_PROGRESS",
        "subject": "ALeph费用支付",
        "body": "ALeph费用支付",
        "payDetail": [
            {
                "businessId": "12",
                "feeName": "逾期费支付",
                "feeDesc": "逾期费支付",
                "feeType": "逾期费",
                "feeAmount": 3000,
                "extJsonb": " {\"title\":\"财务手册\",\"barCode\":\"1111122\"}"
            }
        ],
        "extJsonb": {
            "readerCardNo": "读者证号",
            "readerName": "读者姓名",
            "libCode": "分馆编码",
            "department": "部门编码",
            "feeType": "借阅费用",
            "operator": "馆员1"
        },
        "errCode": "1002",
        "errMsg": "业务异常错误",
        "createdTime": "1622016572190",
        "successTime": "1622016572190"
    }
}
修改于 2025-04-08 08:38:06
上一页
支付统一下单接口
下一页
支付记录分页列表查询接口
Built with