首图支付网关
  1. 对外提供退款相关接口
首图支付网关
  • 对外提供支付相关接口
    • OpenAPI-支付统一下单接口(测试)
      POST
    • OpenAPI-查询支付订单接口(测试)
      POST
    • OpenAPI-支付记录分页列表查询接口
      POST
    • 支付通知回调
      POST
  • 对外提供退款相关接口
    • OpenAPI-退款接口(测试)
      POST
    • OpenAPI-查询退款订单接口(测试)
      POST
    • OpenAPI-退款记录分页查询接口
      POST
    • 退款通知回调
      POST
  • 数据模型
    • Schemas
      • QueryPage
      • ApiResult«CreateQrcodeResponse»
      • Order
      • ApiResult«PayByWechatResponse»
      • Query
      • ApiResult«QueryPayStatusForH5Response»
      • ResponseResult«object»
      • ApiResult«QueryPayStatusResponse»
      • ApiResult«QueryRefundStatusForH5Response»
      • ApiResult«QueryRefundStatusResponse»
      • ApiResult«RefundForH5Response»
      • ApiResult«RefundResponse»
      • ApiResult«string»
      • ApiResult«登录传递DTO»
      • CreateQrcodeRequest
      • CreateQrcodeResponse
      • Folio用户信息中的meta
      • Folio用户信息中的personal
      • JsonNode
      • PayByWechatRequest
      • PayByWechatResponse
      • QueryPayStatusForH5Request
      • QueryPayStatusForH5Response
      • QueryPayStatusRequest
      • QueryPayStatusResponse
      • QueryRefundStatusForH5Response
      • QueryRefundStatusResponse
      • RefundForH5Request
      • RefundForH5Response
      • RefundRequest
      • RefundResponse
      • TaskHttpResponse
      • 修改密码DTO
      • 创建用户信息
      • 外部系统调用重置密码接口时传递的DTO
      • 对外提供支付下单DTO
      • 对外提供支付下单DTO_1
      • 对外提供支付下单回调通知结果DTO
      • 对外提供支付下单明细DTO
      • 对外提供查询商户号DTO
      • 对外提供查询商户号DTO_1
      • 对外提供查询支付订单信息的DTO
      • 对外提供查询退款订单信息的DTO
      • 对外提供退款DTO
      • 对外提供退款回调通知结果DTO
      • 登录传递DTO
      • 登录传递DTO,也可用于创建登录账号
      • 登录传递DTO,也可用于创建登录账号_1
      • 读者发票抬头管理
    • 支付明细数据模型
  1. 对外提供退款相关接口

OpenAPI-退款记录分页查询接口

POST
/gateway-starter/api/gateway/254086046961665

请求参数

Header 参数

Body 参数application/json

示例
{
    "tenantId": "stlib0001",
    "queryPage": {
        "orders": [
            {
                "fieldName": "createdTime",
                "order": "0"
            }
        ],
        "page": 1,
        "queries": [
            {
                "cp": "0",
                "field": "tenantId",
                "lc": "1",
                "value": "stlib0001"
            }
        ],
        "size": 10
    }
}

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST '/gateway-starter/api/gateway/254086046961665' \
--header 'lk-appid: 240479585243137' \
--header 'lk-time: 2025-04-08 16:29:13' \
--header 'lk-nonce: 9f96ac1ff4fa4595862f5709abce5eff' \
--header 'lk-sign: a37e073f77cde8428da6a9bf7750fac9' \
--header 'Content-Type: application/json' \
--data-raw '{
    "tenantId": "stlib0001",
    "queryPage": {
        "orders": [
            {
                "fieldName": "createdTime",
                "order": "0"
            }
        ],
        "page": 1,
        "queries": [
            {
                "cp": "0",
                "field": "tenantId",
                "lc": "1",
                "value": "stlib0001"
            }
        ],
        "size": 10
    }
}'

返回响应

🟢200OK
application/json
Body

示例
{
    "code": 200,
    "cost": 100,
    "data": {
        "msg": "SUCCESS",
        "code": "COMMON_200",
        "data": {
            "total": 28,
            "current": 1,
            "hitCount": false,
            "pages": 3,
            "size": 10,
            "optimizeCountSql": true,
            "records": [
                {
                    "refundState": "REFUND_SUCCESSFUL",
                    "mchNoBranch": "0200140217230201",
                    "extJsonb": {
                        "libCode": "读者所属分馆编码",
                        "unionId": "oUSDOusdsdISLSDlskdf",
                        "readerName": "读者姓名",
                        "readerMobile": "18000000000",
                        "openId": "oosvA6pymxUkwdI5cVuXGs5jrE_8",
                        "readerCardNo": "TJLD00000273204",
                        "readerEmail": "test123@163.com",
                        "feeType": "BORROW_FEE",
                        "operator": "wx11",
                        "deviceInfo": "013467007045764"
                    },
                    "refundReason": "逾期费减免",
                    "mchName": "首图线上商户号-URL支付",
                    "businessId": null,
                    "errMsg": null,
                    "channelOrderNo": "R202508011718367618568",
                    "payAmount": "100",
                    "errCode": null,
                    "mchRefundNo": "M27210632100510",
                    "appId": "Aleph001",
                    "successTime": "1754040384004",
                    "createdTime": "1754039916845",
                    "refundMode": "ENTIRE_REFUND",
                    "channelPayOrderNo": "P202508011714591565788",
                    "mchNo": "020014021723",
                    "refundAmount": "100"
                },
                {
                    "refundState": "REFUND_SUCCESSFUL",
                    "mchNoBranch": "0200140217230201",
                    "extJsonb": {
                        "libCode": "读者所属分馆编码",
                        "unionId": "oUSDOusdsdISLSDlskdf",
                        "readerName": "读者姓名",
                        "readerMobile": "18000000000",
                        "openId": "oosvA6pymxUkwdI5cVuXGs5jrE_8",
                        "readerCardNo": "TJLD00000273204",
                        "readerEmail": "test123@163.com",
                        "feeType": "BORROW_FEE",
                        "operator": "wx11",
                        "deviceInfo": "013467007045764"
                    },
                    "refundReason": "逾期费减免",
                    "mchName": "首图线上商户号-URL支付",
                    "businessId": null,
                    "errMsg": null,
                    "channelOrderNo": "R202508011739347489478",
                    "payAmount": "100",
                    "errCode": null,
                    "mchRefundNo": "M27210632100511",
                    "appId": "Aleph001",
                    "successTime": "1754041202060",
                    "createdTime": "1754041174756",
                    "refundMode": "ENTIRE_REFUND",
                    "channelPayOrderNo": "P202508011737219518562",
                    "mchNo": "020014021723",
                    "refundAmount": "100"
                },
                {
                    "refundState": "REFUND_SUCCESSFUL",
                    "mchNoBranch": "0200140217230201",
                    "extJsonb": {
                        "libCode": "读者所属分馆编码",
                        "unionId": "oUSDOusdsdISLSDlskdf",
                        "readerName": "读者姓名",
                        "readerMobile": "18000000000",
                        "openId": "oosvA6pymxUkwdI5cVuXGs5jrE_8",
                        "readerCardNo": "TJLD00000273204",
                        "readerEmail": "test123@163.com",
                        "feeType": "BORROW_FEE",
                        "operator": "wx11",
                        "deviceInfo": "013467007045764"
                    },
                    "refundReason": "逾期费减免",
                    "mchName": "首图线上商户号-URL支付",
                    "businessId": null,
                    "errMsg": null,
                    "channelOrderNo": "R202508011806546753156",
                    "payAmount": "100",
                    "errCode": null,
                    "mchRefundNo": "M27210632100512",
                    "appId": "Aleph001",
                    "successTime": "1754042822074",
                    "createdTime": "1754042814947",
                    "refundMode": "ENTIRE_REFUND",
                    "channelPayOrderNo": "P202508011803283942595",
                    "mchNo": "020014021723",
                    "refundAmount": "100"
                },
                {
                    "refundState": "REFUND_SUCCESSFUL",
                    "mchNoBranch": "0200140217230201",
                    "extJsonb": {
                        "libCode": "读者所属分馆编码",
                        "unionId": "oUSDOusdsdISLSDlskdf",
                        "readerName": "读者姓名",
                        "readerMobile": "18000000000",
                        "openId": "oosvA6pymxUkwdI5cVuXGs5jrE_8",
                        "readerCardNo": "TJLD00000273204",
                        "readerEmail": "test123@163.com",
                        "feeType": "BORROW_FEE",
                        "operator": "wx11",
                        "deviceInfo": "013467007045764"
                    },
                    "refundReason": "逾期费减免",
                    "mchName": "首图线上商户号-URL支付",
                    "businessId": null,
                    "errMsg": null,
                    "channelOrderNo": "R202508040839173036575",
                    "payAmount": "100",
                    "errCode": null,
                    "mchRefundNo": "M27210632100513",
                    "appId": "Aleph001",
                    "successTime": "1754268001845",
                    "createdTime": "1754267957309",
                    "refundMode": "ENTIRE_REFUND",
                    "channelPayOrderNo": "P202508040837368725905",
                    "mchNo": "020014021723",
                    "refundAmount": "100"
                },
                {
                    "refundState": "REFUND_SUCCESSFUL",
                    "mchNoBranch": "0200140217230201",
                    "extJsonb": {
                        "libCode": "读者所属分馆编码",
                        "unionId": "oUSDOusdsdISLSDlskdf",
                        "readerName": "读者姓名",
                        "readerMobile": "18000000000",
                        "openId": "oosvA6pymxUkwdI5cVuXGs5jrE_8",
                        "readerCardNo": "TJLD00000273204",
                        "readerEmail": "test123@163.com",
                        "feeType": "BORROW_FEE",
                        "operator": "wx11",
                        "deviceInfo": "013467007045764"
                    },
                    "refundReason": "逾期费减免",
                    "mchName": "首图线上商户号-URL支付",
                    "businessId": null,
                    "errMsg": null,
                    "channelOrderNo": "R202508040843576127552",
                    "payAmount": "100",
                    "errCode": null,
                    "mchRefundNo": "M27210632100514",
                    "appId": "Aleph001",
                    "successTime": "1754268241823",
                    "createdTime": "1754268237617",
                    "refundMode": "ENTIRE_REFUND",
                    "channelPayOrderNo": "P202508040842454558639",
                    "mchNo": "020014021723",
                    "refundAmount": "100"
                },
                {
                    "refundState": "REFUND_SUCCESSFUL",
                    "mchNoBranch": "0200140215340201",
                    "extJsonb": {
                        "orderApdInf": "城图",
                        "readerPhone": "13858079955",
                        "readerName": "方杰",
                        "openId": "oh_W_62LEH3BcFznrEaSwAvPZZmU",
                        "readerCardNo": "ST0020427303",
                        "feeType": "AUTO_PRINT_FEE",
                        "deviceInfo": "013467007045764",
                        "readerIDNumber": "ST0020427303"
                    },
                    "refundReason": "钱包退款",
                    "mchName": "首图线上商户号-自助文印",
                    "businessId": "20250804102850670000522288",
                    "errMsg": null,
                    "channelOrderNo": "R202508041315009958942",
                    "payAmount": "1",
                    "errCode": null,
                    "mchRefundNo": "2025080413150013100066904",
                    "appId": "AutoPrintWeChatApplet",
                    "successTime": "1754284562267",
                    "createdTime": "1754284501048",
                    "refundMode": "ITEMIZED_REFUND",
                    "channelPayOrderNo": "P202508041028513668025",
                    "mchNo": "020014021534",
                    "refundAmount": "1"
                },
                {
                    "refundState": "REFUND_SUCCESSFUL",
                    "mchNoBranch": "0200140217230201",
                    "extJsonb": {
                        "readerPhone": "18888888888",
                        "readerName": "1",
                        "readerCardNo": "1",
                        "remark": null,
                        "feeType": "BORROW_FEE",
                        "operator": "张旺111",
                        "readerIDNumber": null
                    },
                    "refundReason": "1",
                    "mchName": "首图线上商户号-URL支付",
                    "businessId": null,
                    "errMsg": null,
                    "channelOrderNo": null,
                    "payAmount": null,
                    "errCode": null,
                    "mchRefundNo": "1153391953405972480",
                    "appId": "Aleph001",
                    "successTime": null,
                    "createdTime": null,
                    "refundMode": "ITEMIZED_REFUND",
                    "channelPayOrderNo": null,
                    "mchNo": "020014021723",
                    "refundAmount": null
                },
                {
                    "refundState": "REFUND_SUCCESSFUL",
                    "mchNoBranch": "0200140217230201",
                    "extJsonb": {
                        "readerPhone": "15926981127",
                        "readerName": "康瑞",
                        "bizOrderId": "94d0a4da-85a3-41a3-bfa8-f542f46bf6fc",
                        "openId": "oh_W_6yb1LZ4MNRqk14sWAVNErfA",
                        "readerCardNo": "ST0012000080",
                        "feeType": "ACTIVITY_TICKET_FEE",
                        "businessList": "[{\"businessId\":\"7b47e2fc-9fbc-4bca-9525-c04d3f290351\",\"orderTicketId\":\"e3c44ac3-dda4-4720-94c6-3894c62da7bb\"}]",
                        "tenant": "stlib0001",
                        "deviceInfo": "87349ccbd12f4cb083bd85716b5995bb",
                        "readerIDNumber": "420528199303080339"
                    },
                    "refundReason": "活动购票申请退款",
                    "mchName": "首图线上商户号(新申请)",
                    "businessId": null,
                    "errMsg": null,
                    "channelOrderNo": "R202508211547566367170",
                    "payAmount": "2",
                    "errCode": null,
                    "mchRefundNo": "R2025082115475600001",
                    "appId": "activityTicket",
                    "successTime": "1755762481550",
                    "createdTime": "1755762476640",
                    "refundMode": "ENTIRE_REFUND",
                    "channelPayOrderNo": "P202508211545121286321",
                    "mchNo": "020014021723",
                    "refundAmount": "2"
                },
                {
                    "refundState": "REFUND_SUCCESSFUL",
                    "mchNoBranch": "0200140217230201",
                    "extJsonb": {
                        "readerPhone": "15926981127",
                        "readerName": "康瑞",
                        "bizOrderId": "8094d61f-e02d-4e2d-b4f5-b5f8bed1603a",
                        "openId": "oh_W_6yb1LZ4MNRqk14sWAVNErfA",
                        "readerCardNo": "ST0012000080",
                        "feeType": "ACTIVITY_TICKET_FEE",
                        "businessList": "[{\"businessId\":\"33643089-7934-446e-b69d-f3c7ba8909e4\",\"orderTicketId\":\"9b3928ac-ce60-4991-bac2-dea9c8041fb1\"}]",
                        "tenant": "stlib0001",
                        "deviceInfo": "bda9da0c16eb44ff95f84cd6b51f7a5e",
                        "readerIDNumber": "420528199303080339"
                    },
                    "refundReason": "活动购票申请退款",
                    "mchName": "首图线上商户号(新申请)",
                    "businessId": "33643089-7934-446e-b69d-f3c7ba8909e4",
                    "errMsg": null,
                    "channelOrderNo": "R202508211551315862841",
                    "payAmount": "2",
                    "errCode": null,
                    "mchRefundNo": "R2025082115513100001",
                    "appId": "activityTicket",
                    "successTime": "1755762721743",
                    "createdTime": "1755762691601",
                    "refundMode": "ITEMIZED_REFUND",
                    "channelPayOrderNo": "P202508211550421922430",
                    "mchNo": "020014021723",
                    "refundAmount": "1"
                },
                {
                    "refundState": "REFUND_SUCCESSFUL",
                    "mchNoBranch": "0200140217230201",
                    "extJsonb": {
                        "readerPhone": "15926981127",
                        "readerName": "康瑞",
                        "bizOrderId": "8094d61f-e02d-4e2d-b4f5-b5f8bed1603a",
                        "openId": "oh_W_6yb1LZ4MNRqk14sWAVNErfA",
                        "readerCardNo": "ST0012000080",
                        "feeType": "ACTIVITY_TICKET_FEE",
                        "businessList": "[{\"businessId\":\"33643089-7934-446e-b69d-f3c7ba8909e4\",\"orderTicketId\":\"9b3928ac-ce60-4991-bac2-dea9c8041fb1\"}]",
                        "tenant": "stlib0001",
                        "deviceInfo": "bda9da0c16eb44ff95f84cd6b51f7a5e",
                        "readerIDNumber": "420528199303080339"
                    },
                    "refundReason": "活动购票申请退款",
                    "mchName": "首图线上商户号(新申请)",
                    "businessId": "33643089-7934-446e-b69d-f3c7ba8909e4",
                    "errMsg": null,
                    "channelOrderNo": "R202508211552588284666",
                    "payAmount": "2",
                    "errCode": null,
                    "mchRefundNo": "R2025082115525800001",
                    "appId": "activityTicket",
                    "successTime": "1755762782063",
                    "createdTime": "1755762778839",
                    "refundMode": "ITEMIZED_REFUND",
                    "channelPayOrderNo": "P202508211550421922430",
                    "mchNo": "020014021723",
                    "refundAmount": "1"
                }
            ],
            "searchCount": true,
            "orders": []
        }
    },
    "msg": "OK",
    "responseTime": "2025-09-05 14:44:19",
    "success": true,
    "traceLogId": "254089531076608"
}
🟢201Created
🟠401Unauthorized
🟠403Forbidden
🟠404Not Found
修改于 2025-09-26 10:53:47
上一页
OpenAPI-查询退款订单接口(测试)
下一页
退款通知回调
Built with