POS机扫码支付后通知接口

请求参数

Body 参数application/json

reqTime

string

请求时间戳

必需

13位时间

appId

string

应用Id

必需

业务系统的应用Id

sign

string

签名

必需

签名

tenantId

string

租客Id

必需

租客Id

mchOrderNo

string

商户订单号

可选

业务系统这一笔支付记录的唯一编号，如果POS机对应的工行App平台不能传递，则由支付网关自己生成

channelCode

string

支付渠道编码

必需

支付渠道编码

amount

string

支付金额

必需

单位是分

subject

string

商品名称

必需

商品名称

body

string

商品描述

必需

商品描述

invoiceFlag

string

是否可开票标记

可选

是否可开票标记：NO-不可开；YES-可开；FINISH-已开票，若不填则默认YES

extJsonb

string

扩展参数

可选

商户扩展参数,回调时会原样返回
{
"readerCardNo" : "读者证号",
"readerIDNumber":"读者身份证号或护照号或其他唯一标识这个人的编号",
"readerName": "读者姓名",
"readerPhone":"读者联系电话",
"readerEmail":"读者邮箱"
"libCode": "读者所属分馆编码",
"feeType":"费用类别",
"operator":"操作人用户名"
"mchNo":"工行线上商户号",
"mchNoBranch":"工行线上商户号分支",
"wechatAppId":"商户在微信开放平台注册的APPID"
}
注意：费用类别必填，Aleph费用支付费用类型默认“BORROW_FEE”，读者活动系统费用支付默认“ACT_REG_FEE”；对于需要关联读者的业务，读者证号、读者身份证号或护照号或其他唯一标识这个人的编号必填、读者姓名是必需的；读者联系电话、读者邮箱选填；操作人用户名选填；读者所属分馆编码选填；

payDetail

array [object {12}]

支付明细

必需

本笔支付订单的支付明细集合

businessId

string

业务系统费用明细Id

必需

业务系统费用明细Id

feeName

string

费用名称

必需

费用名称

feeDesc

string

费用描述

可选

费用描述

feeType

string

费用类型

可选

业务系统中的费用类型

creditDebit

string

收支标记

可选

D：为读者支付图书馆的款项（Debit）；C：为图书馆应支付读者的款项（Credit），一般是指给读者减免的费用

feeAmount

integer

费用金额

必需

单位分

extJsonb

string

扩展参数

可选

商户扩展参数，回调时会原样返回，这个示例是Aleph里的

{"title" : "书刊名称","barCode": "图书条码","callNo":"索书号","author":"作者","imprint":"出版社","isbnIssn":"isbn和issn","sequence":"费用信息的序列号，相当于主键","subLibrary":"费用所属馆代码","date":"费用日期","type":"费用类型","creditDebit":"支付方向，D代表读者付给图书馆；C代表图书馆付给读者也就是减免","sum":"总的费用金额","paymentCataloger":"收款操作员的用户名","paymentTarget":"费用支付目标馆代码","paymentReceiptNumber":"付款收据编号","description":"费用描述"}

workbench

string

工作台

可选

服务点的编码，流通系统逾期费等相关支付请必填

locInstitution

string

馆藏地-机构

可选

馆藏地-机构编码，流通系统逾期费等相关支付请必填

locCampus

string

馆藏地-校园

可选

馆藏地-校园的编码，流通系统逾期费等相关支付请必填

locLibrary

string

馆藏地-图书馆

可选

馆藏地-图书馆的编码，流通系统逾期费等相关支付请必填

location

string

馆藏地-馆藏地

可选

馆藏地-馆藏地的编码，流通系统逾期费等相关支付请必填

示例

{
    "appId": "90060",
    "mchOrderNo": "20160427210604000490",
    "channelCode": "ICBC_AGGREGATE_PAY",
    "amount": "5000",
    "subject": "ALeph费用支付",
    "body": "ALeph费用支付",
    "notifyUrl": "https://www.xxxx.com/notify.htm",
    "returnUrl": "https://www.xxx.com/return.htm",
    "channelExtra": "{\"openid\": \"o6BcIwvSiRpfS8e_UyfQNrYuk2LI\"}",
    "extJsonb": {"readerCardNo" : "读者证号","readerName": "读者姓名","libCode": "分馆编码","department":"部门编码","feeType":"BORROW_FEE","operator":"馆员1"},
    "payDetail": [
        {
            "businessId": "40",
            "feeName": "逾期费支付",
            "feeDesc": "逾期费支付",
            "feeType": "逾期费",
            "feeAmount": 3000,
            "extJsonb": {"title":"财务手册","barCode":"1111122"}
        }
    ]
}

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST '/jiafulai/paymentgateway/api/pay/posnotify' \
--header 'Content-Type: application/json' \
--data-raw '{
    "appId": "90060",
    "mchOrderNo": "20160427210604000490",
    "channelCode": "ICBC_AGGREGATE_PAY",
    "amount": "5000",
    "subject": "ALeph费用支付",
    "body": "ALeph费用支付",
    "notifyUrl": "https://www.xxxx.com/notify.htm",
    "returnUrl": "https://www.xxx.com/return.htm",
    "channelExtra": "{\"openid\": \"o6BcIwvSiRpfS8e_UyfQNrYuk2LI\"}",
    "extJsonb": {"readerCardNo" : "读者证号","readerName": "读者姓名","libCode": "分馆编码","department":"部门编码","feeType":"BORROW_FEE","operator":"馆员1"},
    "payDetail": [
        {
            "businessId": "40",
            "feeName": "逾期费支付",
            "feeDesc": "逾期费支付",
            "feeType": "逾期费",
            "feeAmount": 3000,
            "extJsonb": {"title":"财务手册","barCode":"1111122"}
        }
    ]
}'

返回响应

🟢200成功

application/json

Body

code

string

返回状态

必需

COMMON_200-处理成功，其他-处理有误，详见msg

msg

string

返回信息

可选

具体错误原因，例如：签名失败、参数格式校验错误

data

object

返回数据

可选

返回支付数据，json格式数据

mchOrderNo

string

商户订单号

必需

业务系统这一笔支付记录的唯一编号

示例

{
    "code": "string",
    "msg": "string",
    "data": {
        "mchOrderNo": "string"
    }
}