关于银联支付交易状态码的一些分析

CSDN 2024-08-17 12:05:08 阅读 50

  

目录

关于银联支付

一些准备

交易状态码的一些分析

小结


关于银联支付

目前B2C购物支付场景下,支付宝和微信的在线支付已经成为我们经常遇到的支付方式。另外,银联支付也是我们日常的一种支付方式,本文所指的银联支付即指中国银联网关支付产品,主要适用于持卡人在商户网站B2C购物支付场景,持卡人通过点击银联在线支付图标(可选择支付类型),并在银联在线支付网关完成支付信息录入,最终完成支付。银联在线支付支持输入卡号付款、用户登录支付、网银支付、迷你付(IC卡支付)等多种付款方式,用户通过统一入口,访问支付首页,按照提示和所列功能即可完成支付。

一些准备

做为软件开发商,实现银联在线支付,需要协助(但不必要)目标商户签署支付协议,开通商户平台。以2007版支付为例,开通过商户平台需要提交许多资料,包括企业及个人信息(如管理员用户名、名称、手机号等)备案。本文将不重点介绍如何实现在线支付,仅就支付反馈中遇到的一些问题进行分析。

在分析前,我们简单讲述一下要 POST 的一些参数和数据,参见下表:

序号 字段名 类型 说明
1 MerId 数字串 必填,为银联统一分配给商户的商户号,15位长度
2 OrdId 数字串 必填,商户提交给银联的交易订单号,16位长度,请注意生成的订单号当天支付如果不成功,则再次使用相同的订单号提交后会提示重复交易,但次日该订单号仍可以做为交易失败后的“新”订单号继续在线支付。从另一个角度来说,使用固定订单号有助于商户端更新支付状态失败造成用户的重复交易。
3 TransAmt 数字串 必填,订单交易金额,12位长度,左补0,单位为分。如 000000007890,表示七十八元九角零分,即 78.90 元。
4 CuryId 数字串 必填,订单交易币种,3位长度,固定为人民币156
5 TransDate 数字串 必填,订单交易日期,8位长度
6 TransType 数字串 必填,交易类型,4位长度,0001 表示消费,0002 表示退款
7 Version 数字串 必填,支付接入版本号,如 20070129
8 BgRetUrl 数字串 必填,后台交易接收的回调 URL,URL地址的长度不超过80个字节
9 PageRetUrl 数字串 必填,前台交易页面接收的回调 URL(显示给用户方的页面,交易情况显示详情页面),URL地址的长度不超过80个字节
10 GateId 数字串 非必填,支付网关号
11 Priv1 数字串 非必填,商户私有域,长度不超过60个字节,属于商户的备注内容
12 ChkValue 数字串 必填,256字节长的ASCII码,是本次交易的关键数字签名

 以下是示例代码,提供了一个服务器 Form 和一些隐藏字段域 准备提交时使用

<code><form id="payform" runat="server">code>

<input type="hidden" name="MerId" value="" id="MerId" runat="server"/>code>

<input type="hidden" name="OrdId" value="" id="OrdId" runat="server"/>code>

<input type="hidden" name="TransAmt" value="" id="TransAmt" runat="server"/>code>

<input type="hidden" name="CuryId" value="156" id="CuryId" runat="server"/> code>

<input type="hidden" name="TransDate" value="" id="TransDate" runat="server"/>code>

<input type="hidden" name="TransType" value="0001" id="TransType" runat="server"/> code>

<input type="hidden" name="Version" value="" id="Version" runat="server"/> code>

<input type="hidden" name="BgRetUrl" value="https://x.x.com/BR.aspx" id="BgRetUrl" runat="server"/>code>

<input type="hidden" name="PageRetUrl" value="https://x.x.com/PR.aspx" id="PageRetUrl" runat="server"/>code>

<input type="hidden" name="GateId" value="" id="GateId" runat="server"/>code>

<input type="hidden" name="Priv1" value="" id="Priv1" runat="server"/>code>

<input type="hidden" name="ChkValue" value="" id="ChkValue" runat="server"/>code>

</form>

假设我们可以动态的设置 Form 的 Action (如测试环境或生产环境),示例代码如下:

protected void b_insbtn_Click(object sender, EventArgs e)

{

if (ViewState["RunType"].ToString() == "1")

{

payform.Action = "https://payment.chinapay.com/pay/TransGet"; //生产环境

payform.Method = "post";

}

else if (ViewState["RunType"].ToString() == "0")

{

payform.Action = "http://payment-test.chinapay.com/pay/TransGet"; //测试环境

payform.Method = "post";

}

//后续参数配置代码....

}

​代码中 https://payment.chinapay.com/pay/TransGet ,即为正式提交在线支付的入口页。

交易状态码的一些分析

当引导用户到银联支付页面,并完成支付操作后(包括未成功的交易),通过 PageRetUrl 和 BgRetUrl  回调地址我们会获取银联的交易状态码,状态码为4位数字,交易状态码为非 “1001” 的即为失败交易,我们要根据实际的返回保存到数据库并给予对应的提示。

详细的交易状态码见下表:

交易状态码 说明 交易状态码 说明
1001 消费交易成功 2063 违反安全保密规定
1003 退款交易成功 2064 原始金额不正确
1005 退款撤销成功 2065 超出取款次数限制
1111 未支付 2066 受卡方呼受理方安全保密部门
2000 银行无应答 2067 捕捉
2001 查发卡放 2068 收到的回答太迟
2002 查发卡放特殊条件 2075 允许输入PIN的次数超限
2003 无效商户 2090 日期切换正在处理
2004 没收卡 2091 发卡方与交换中心不能操作
2005 不予承兑 2092 金融机构或中间网络设施找不到或无法到达
2006 出错 2093 交易违法、不能完成
2007 特殊条件下没收卡 2094 重复交易
2009 请求正在处理中 2095 调节控制错
2010 卡bin未参与CPUSecure服务 2096 系统异常、失效
2012 无效交易 2097 ATM\POS终端找不到
2013 无效金额 2098 交换中心收不到收卡方应答
2014 无效卡号 2099 PIN格式错误
2015 无此发卡方 20A0 MAC鉴别失败
2019 重新送入交易 2101 网关出错
2020 无效应答 2102 密码加密出错
2021 不作任何处理 2111 消息时间太新,请调整浏览器时间与实际时间一致
2022 怀疑操作有误 2112 消息时间太旧,请调整浏览器时间与实际时间一致
2023 不可接受的交易费 2113 信息不符
2030 格式错误 2114 商户号验证出错
2031 交换中心不支持的银行 2115 商户信息格式出错
2033 过期的卡 2116 撤销交易信息出错
2034 有作弊嫌疑 2117 查新个数为零
2035 受卡方与安全保密部门联系 2118 查询个数大于100
2036 受限制的卡 2141 系统出错
2037 受卡方呼受理方安全部门 2142 撤销交易出错
2038 超过允许的PIN试输入 2143 撤销交易已处理
2039 无此信用卡账户 2144 交易已被冲正
2040 请求的功能不支持 2145 撤销交易出错
2041 挂失卡 2146 交换中心无应答
2042 无此账户 2147 网管未收到该交易
2043 被窃卡 2148 重复交易
2044 无此投资账户 2150 通讯线路故障
2051 无足够的存款 2157 不允许持卡人进行交易
2052 无此支票账户 2158 该银行卡网上支付功能因系统升级而暂停
2053 无此储蓄卡账户 2199 系统出错
2054 过期的卡 2257 基于风险控制阻止的交易
2055 不正确的PIN 2997 交易提交银行错误
2056 无此卡记录 4001 HSBC交易中止
2057 不允许持卡人进行的交易 4055 HSBC安全认证错误
2058 不允许此终端进行的交易 4097 HSBC交易无应答
2059 有作弊嫌疑 5501 工行网关无应答
2060 受卡方与安全保密部门联系 5511 工行网关处理失败
2061 超出取款金额限制 5522 工行网关未收到后台应答
2062 受限制的卡
交易状态码 说明 交易状态码 说明
8001 HSBC交易失败 9000 电话支付订单已成功发给银行
8002 HSBC交易失败 9001 电话支付订单发送银行失败(订单电话域非法)
8003 HSBC交易失败 9002 电话支付订单发送银行失败(秘密数域非法)
8004 HSBC交易失败 9003 电话支付订单发送银行失败(商户扩展域非法)
8005 HSBC交易失败 9004 电话支付订单发送银行失败(CP保留域非法)
8006 HSBC交易失败 9100 电话支付订单撤销成功
8007 HSBC交易失败 9101 电话支付订单撤销失败(订单号不匹配)
8008 HSBC交易失败 9102 电话支付订单撤销失败(金额不匹配)
8009 HSBC交易失败 9103 电话支付订单撤销失败(交易日期不对)

在银联支付20070129版本的实际应用中,回调获取的交易状态码基本正常,但出现了一些问题就是在回调获取成功交易状态码 “1001” 后,银联继续推送了一些状态码回调,因此在开发中需要进行判断 ,一味的接收并更新状态码,可能无法达到预期的效果,尤其当状态码已经为“1001”的情况下。在实际应用中,除正常状态码反馈,我们遇到了 “2006” 和 “2148” 错误。

从 “2148” 错误可以理解,是用户的重复交易(包括当日和隔日重复交易),因此我们需要在更新数据库前对两次交易码进行比对,如果之前为 “1001” 的可以无视 “2148” 的存在。

另外我们遇到的是 “2006” 错误,从代码表中仅查询出说明为 “出错” ,这个问题我们曾致电银联客服求解,未得到任何有效答案,包括可能出现的情况。关键是,状态码会在获得“1001” 后不定期的时间内(非正常回调周期)推送到回调地址,这就比较难以判断真实发生的情况。

因此对于非“1001”的特殊情况,建立日志表跟踪非常关键,目前来看,对于“2006”的拦截很有必要,实际应用中错误更新的情况明显减少。 

小结

更多的详情请参考如下链接(中国银联开放平台):

https://open.unionpay.com/tjweb/index

在实际与银联客服的沟通中,我们尽量使用官方提供的联系邮件进行沟通,这样效率可以高一些。也便于留档查询,而且如果修改资料(包括更换联系人、修改企业信息等)手续比较繁琐,不是太友好,需要一定的时间,因此在应用上线功能时需要做好准备工作。

以上是本人的一些体会与实践,仅代表个人的一些观点,再次感谢您的阅读,欢迎讨论、指教!



声明

本文内容仅代表作者观点,或转载于其他网站,本站不以此文作为商业用途
如有涉及侵权,请联系本站进行删除
转载本站原创文章,请注明来源及作者。