• 通用问题
  • 特殊问题
商户密钥(KEY)如何使用?
商户密钥(KEY)有两种,第一种是签名密钥(全部接口都包括),第二种是数据加密密钥(快捷AES加密密钥、卡支付3DES加密密钥、实名认证3DES加密密钥)。
签名密钥用在签名验证的时候参与签名计算,数据加密密钥用在加密算法中,密钥均为字符串形式,由我方运营同事分配。具体的用法请参照接口文档规范。
无效的签名验证?
1.登录商户后台,确认商户内码和密钥正确;
2.对照文档,看下签名参数和传的参数是否一致,签名参数是否按照文档中的规定;
3.我方编码是GB2312,请求参数涉及到中文需要转码。(md5的编码是utf-8)
如何确认支付成功?
同步通知和异步通知同时存在的前提下,实际支付状态以异步通知为准,验签成功后根据通知中的参数,订单状态、支付金额等都显示为支付成功的状态才可以处理订单成功,不要验签通过就处理成功!同步通知用于页面跳转和信息展示,订单可能是未支付;特别注意,如果对接为卡类支付,则需要同时校验支付状态和支付金额,以免造成不必要的损失。
异步通知的处理规则?
异步通知共通知五次,间隔5min,当商户返回ok或者error后停止发送,返回其他或者不返回会发送到5次后停止,商户接收到异步通知,先进行验签,然后根据支付状态做相应的业务处理,最后需要将反馈结果(具体参见指定的文档规则)提供给汇付宝。
查单接口有什么用?
如果支付过程中出现异常,或者异步通知收到后校验不通过,返回error,则可以通过查单接口确认支付状态。
支付失败!
请联系商户群运营同事协助处理。
乱码问题!
我方编码是GB2312,传输中文时需要进行转码;如果转码后还是显示乱码,可以增加urlencode。
签名!
签名的目的是保证数据传输正确,只与当前传输数据有关。签名具体参数按照文档,key我方分配的密钥。
agent_id 和key是什么?在哪里查看?
登录商户后台www.heepay.com,首页中商户内码即为agent_id,key为密钥,在产品服务-查看秘钥。
尚未开通此类型错误?
找负责的商务人员,确认开通服务 。
同步通知return_url和异步通知notify_url!
同步通知为页面跳转地址,在支付完成后会跳转到该地址;异步通知是在支付确认结果后,由我方服务器发送支付结果到该地址,商户依照通知信息做业务逻辑处理,进行发货。地址必须可以用外网访问。
SDK确认订单状态说明!
1.订单支付完毕后,银行通知我方结果,我方服务器会发送异步通知把支付结果发送到提交订单时的notify_url,商户接收到结果后进行发货;
2.sdk会通过查询我们服务器订单状态返回状态码,用于商户APP的支付结果显示;
3.由于银行方通知我方结果可能会有延迟,导致sdk查询结果是未支付,而之后会发送异步通知告知成功,所以处理业务要用异步通知,sdk返回状态码只能用于显示。
订单号已存在,请重新发起支付?
1.商户订单号和汇付宝订单号是一一对应的(否则如果出现异常单追溯困难);
2.用户是在商户自己的业务系统发起支付,商品信息、用户信息都有记录,可以使用新单号下单,并与之前单号做成关联。
微信sdk支付的时候会提示token校验失败!
检查一下tokenid中请求的订单号是否和sdk中的订单号是同一个。
agent_id参数错误!
1.请求到我们这边agent_id丢失;
2.请求到我们这边所有参数丢失,没有带任何参数直接访问我们的地址。
商户还没有开通此支付类型!
1.检查所传agent_id是否是开通该支付类型的商户内码;
2.查看所传pay_type是否是对应的支付类型.
如果上述都没问题,请联系我们商务处理.
风控验证失败!
1.单笔支付金额超过最高限额或者低于最低金额;
2.notify_url和签约地址不在同一个域名中.