Appearance
业务交易接口
本章节描述商户接入金运通网关支付平台相关业务接口。
网关支付交易
请求参数表
特别注意:输入参数必须进行SHA256/SM3算法生成签名字符串,并将签名后的字符串同输入的参数一同请求才能够被金运通支付平台接收。生成支付交易URL方式参考 网关支付平台接入 章节。
交易地址:https://test.jytpay.com/JytNetpay/payment.do
字段名 | 变量名 | 类型 | 说明 | 可空 |
---|---|---|---|---|
交易代码 | tranCode | String(6) | 网关支付交易代码,TN1001 | N |
版本号 | version | String(5) | 支付接口版本号,当前版本号为:1.3.0 | N |
编码方式 | charset | String(16) | 默认为utf-8 | N |
客户端类型 | uaType | String(2) | 支付客户端类型,00:PC端,01:手机端,目前只支持00。 | N |
商户号 | merchantld | String(12) | 由金运通支付平台的分配 | N |
商户订单号 | merOrderld | String(30) | 商户支付订单号,不能重复(1~30位字母、数字、中横线、下划线),建议格式:merchant_id+商户端唯一序号 | N |
订单交易时间 | merTranTime | String(14) | 订单交易时间,格式:yyyymmddhhmmss | N |
商户用户ID | merUserld | String(64) | 商户系统支付用户ID | N |
订单描述 | orderDesc | String(255) | 订单描述信息 | N |
商品名称 | prodlnfo | String(255) | 商品名称 | N |
商品详情 | prodDetailUrl | String(255) | 收银台页面上,展示商品详情URL地址 | Y |
交易金额 | tranAmt | String(16) | 单位为元,最高精确到分(如0.01),金额必须以两位小数结尾(如1.00) | N |
币种 | curType | String(3) | 币种,默认为:CNY | N |
支付模式 | payMode | String(2) | 支付方式,00:B2C;01:B2B;03:银联页面快捷 | N |
支付银行 | bankCode | String(8) | 编码字典参见附录。如支付银行为工商银行,则此字段输入:01020000。如果为空则默认在金运通支付平台选择支付银行。 | Y |
银行卡类型 | bankCardType | String(2) | 01纯借记卡,02信用卡,99:企业账户。05纯借记卡,06信用卡 若支付模式为00,此处可选01,02; 若支付模式为01,则此处只能是99; 若支付模式为03,此处可选05,06; | Y |
通知地址 | notifyUrl | String(200) | 以http开头的url。平台处理完后,后台通知商户服务器的地址。参见“商户通知接口” | N |
跳转地址 | backUrl | String(200) | 平台处理完后,页面直接跳转的地址(默认为签约时的返回地址),携带订单支付结果form表单(商户通知接口) | N |
订单有效时间 | validTime | String(8) | 分钟为单位,默认为4320分钟(3天),从创建时间开始,过了此订单有效时间此笔订单就会被设置为失败状态不能再重新进行支付。 | Y |
保留字段1 | reserve1 | String(64) | 保留字段 | Y |
保留字段2 | reserve2 | String(128) | 保留字段 | Y |
签名算法 | signType | String(8) | 目前支持:SHA256/SM3 | N |
签名 | sign | String(64) | 由订单数据生成的签名值,签名方式参见“参数签名机制” | N |
商户通知接口
只对提交成功的支付请求进行结果通知,支付结果通知回调有两种方式,通知到在线支付请求参数中的backUrl上:
- 浏览器转发--同步
支付成功后,通过Http的post+form 表单方式将结果参数返回给商户系统,使用backUrl通知
- 服务器点对点通讯--异步
如果用户在支付成功后,并没有通知商家而是直接关闭了浏览器窗口就不会通知到商户,不管用户是否同步通知到商户,服务器点对点通知都会通知到商户,
异步通过form表单发送,使用notifyUrl地址通知。
注意:需要处理重复订单,以防两次通知都处理了相同的业务造成损失。
请求参数表
字段名 | 变量名 | 类型 | 说明 | 可空 |
---|---|---|---|---|
交易代码 | tranCode | String(6) | 网关支付交易代码,TN3001 | N |
版本号 | version | String(5) | 支付接口版本号,当前版本号为:1.3.0 | N |
编码方式 | charset | String(16) | 默认为utf-8 | N |
商户号 | merchantld | String(12) | 由金运通支付平台的分配 | N |
支付银行 | bankCode | String(8) | 编码字典参见附录。如支付银行为工商银行,则此字段输入:01020000。 | N |
原商户订单号 | oriMerOrderld | String(30) | 返回商户支付时请求的支付订单号 | N |
原订单发送时间 | oriMerTranTime | String(14) | 商户发送订单时间,yyyymmddhhmmss | N |
平台支付订单号 | payFlowid | String(30) | 金运通平台支付订单号 | N |
支付完成时间 | payFinishTime | String(14) | 支付订单完成时间,yyyymmddhhmmss | N |
网银流水号 | bankTranFlowid | String(64) | 银行返回的交易流水号 | Y |
交易状态 | tranState | String(2) | 订单交易状态,00-初始01-支付中,02-支付成功,03-支付失败,04-过期订单,05-撤销成功,06-作废订单 | N |
交易响应码 | respCode | String(8) | 订单交易响应码,成功-S0000000,其他失败 | N |
交易响应码描述 | respDesc | String(64) | 订单交易响应描述 | N |
交易响应码 | tranRespCode | String(8) | 交易响应码,1.3.0版本 | Y |
交易响应描述 | tranRespDesc | String(64) | 交易响应描述,1.3.0版本 | Y |
交易金额 | tranAmt | String(16) | 单位为元,最高精确到分(如0.01),金额必须以两位小数结尾(如1.00) | N |
签名 | sign | String(64) | 由订单数据生成的签名值,签名方式参见“参数签名机制”,签名字段只需要接口中声明字段 | N |
响应参数
说明:返回S0000000:通知成功,其他:通知失败,继续通知总共通知6次
交易订单查询
请求参数表
输入参数必须进行SHA256/SM3算法生成签名字符串,并将签名后的字符串同输入的参数一同请求才能够被金运通支付平台接收。
查询地址:https://test.jytpay.com/JytNetpay/payment-query.do
字段名 | 变量名 | 类型 | 说明 | 可空 |
---|---|---|---|---|
交易代码 | tranCode | String(6) | 网关支付交易代码,TN2001 | N |
版本号 | version | String(5) | 支付接口版本号,当前版本号为:1.3.0 | N |
编码方式 | charset | String(16) | 默认为utf-8 | N |
商户号 | merchantld | String(12) | 由金运通支付平台的分配 | N |
原商户订单号 | oriMerOrderld | String(30) | 商户请求的订单号 | N |
订单类型 | orderType | String(1) | 0:“支付订单”,1:“退款订单” | N |
签名类型 | signType | String(8) | 目前支持:SHA256/SM3 | N |
签名 | sign | String(64) | 由订单数据生成的签名值,签名方式参见“参数签名机制” | N |
响应参数列表(响应以json字符串)
字段名 | 变量名 | 类型 | 说明 | 可空 |
---|---|---|---|---|
交易代码 | tranCode | String(6) | 网关支付交易代码,TN2001 | |
版本号 | version | String(5) | 支付接口版本号,当前版本号为:1.3.0 | |
编码方式 | charset | String(16) | 默认为utf-8 | |
商户号 | merchantld | String(12) | 由金运通支付平台的分配 | |
原商户订单号 | oriMerOrderld | String(30) | 商户请求订单号 | |
订单类型 | orderType | String(1) | 0:“支付订单”,1:"退款订单” | |
原平台支付订单号 | oriPayOrderld | String(30) | 金运通平台支付订单号/退款订单号 | |
交易状态 | tranState | String(2) | 订单交易状态,00-初始01-支付中,02-支付成功,03-支付失败,04-过期订单,05-撤销成功,06-作废订单退款交易状态,01:未退款;02:正在退还原卡中;03:退款完成(退款到原卡);04:退款失败;05:退款到原卡失败 | |
交易完成时间 | tranFinishTime | String(14) | 交易完成时间,yyyyMMddHHmmss | |
交易响应码 | tranRespCode | String(8) | 交易响应码,1.3.0版本,退款为空 | Y |
交易响应描述 | tranRespDesc | String(64) | 交易响应描述,1.3.0版本,退款为空 | Y |
订单金额 | tranAmt | String(16) | ||
交易响应码 | respCode | String(8) | 订单交易响应码,成功-S0000000,其他失败 | N |
交易响应码描述 | respDesc | String(64) | 订单交易响应描述 | N |
签名类型 | signType | String(8) | 目前支持:SHA256/SM3 | |
签名 | sign | String(64) | 由订单数据生成的签名值,签名方式参见“参数签名机制”,签名字段只需要接口中声明字段 |
退款交易接口
请求参数表
输入参数必须进行SHA256/SM3算法生成签名字符串,并将签名后的字符串同输入的参数一同请求才能够被金运通支付平台接收。
退款地址:https://test.jytpay.com/JytNetpay/refund.do
字段名 | 变量名 | 类型 | 说明 | 可空 |
---|---|---|---|---|
交易代码 | tranCode | String(6) | 网关支付交易代码,TN1002 | N |
版本号 | version | String(5) | 支付接口版本号,当前版本号为:1.0.0 | N |
编码方式 | charset | String(16) | 默认为utf-8 | N |
商户号 | merchantld | String(12) | 由金运通支付平台的分配 | N |
退款流水号 | refundOrderld | String(30) | 退款交易流水号 | N |
退款金额 | refundAmt | String(16) | 单位为元,最高精确到分(如0.01),金额必须以两位小数结尾(如1.00) | N |
原商户订单号 | oriMerOrderld | String(30) | 返回商户支付时请求的支付订单号 | N |
后台通知地址 | refundNotifyUrl | String(200) | 退款成功,通知商户地址 | N |
退款原因 | refundReason | String(100) | Y | |
签名类型 | signType | String(8) | 目前支持:SHA256/SM3 | N |
签名 | sign | String(64) | 由订单数据生成的签名值,签名方式参见“参数签名机制” | N |
响应/通知参数列表(响应json字符串,通知post表单)
字段名 | 变量名 | 类型 | 说明 | 可空 |
---|---|---|---|---|
交易代码 | tranCode | String(6) | 网关支付交易代码,TN1002/通知TN3002 | |
版本号 | version | String(5) | 支付接口版本号,当前版本号为:1.0.0 | |
编码方式 | charset | String(16) | 默认为utf-8 | |
商户号 | merchantld | String(12) | 由金运通支付平台的分配 | |
退款流水号 | refundOrderld | String(30) | 退款交易流水号 | |
退款金额 | refundAmt | String(16) | 单位为元,最高精确到分(如0.01) | |
原退款订单号 | oriMerOrderld | String(30) | 返回商户支付时请求的支付订单号 | |
金运通退款流水号 | payRefundFlowld | String(30) | ||
交易状态 | refundState | String(2) | 退款交易状态,01:未退款;02:正在退还原卡中;03:退款完成(退款到原卡);04:退款失败;05:退款到原卡失败 | N |
退款完成时间 | refundFinishTime | String(14) | yyyyMMddHHmmss | |
退款响应码 | respCode | String(8) | 退款交易响应码,成功-S0000000,其 | N |
他失败 | ||||
退款响应码描述 | respDesc | String(64) | 退款交易响应描述 | N |
签名类型 | signType | String(8) | 目前支持:SHA256/SM3 | |
签名 | sign | String(64) | 由订单数据生成的签名值,签名方式参见“参数签名机制”,签名字段只需要接口中声明字段 |
通知响应参数(返回“S0000000”字符串)