• 服务QQ
    944639175
  • 微信关注
    下载APP

    下载APP

订单查询接口(可选接口)

用来主动查询订单是否支付成功,一般情况只用支付接口即可。如果您服务器中断了一段时间,可以用这个接口,快速获取中断时期的订单的支付状态。

查询接口地址:https://www.heimipay.com/payapi/query

传参方式:POST/GET

请求参数:

参数名 参数含义 参数类型 说明
uid 商户uid string(32) 必填。您的商户唯一标识,注册后在设置里获得。一个32位字符串
orderid 订单ID string(32) 必填。商户自定义订单号.
nonce_str 随机字符串 string(32) 必填。随机字符串,可用随机函数或日期函数生成.
sign 签名 string(32) MD5对上诉参数+sign_key进行签名,具体签名算法请看签名算法章节

返回参数json(适用接口:创建支付订单,支付回调,支付查询等接口通用):

参数名 参数含义 参数类型 说明
ret_code 返回编码 int 必然返回。1:表示成功,其他编码都是失败,具体编码代表的含义,请查阅字典表。
ret_msg 返回消息说明 string(128) 部分失败的消息会放在这里。
nonce_str 返回随机字符串 string(32) 必然返回。随机生成的字符串。
pay_id 支付平台订单ID string(32) 必然返回。支付平台生成的订单号。
uid 商户uid string(32) 必然返回。您的商户唯一标识,注册后在设置里获得。
orderid 订单ID string(32) 必然返回。是您在发起付款接口传入的您的自定义订单号。
qrcode 支付二维码网址 string(256) 支付二维码信息,如果没返回,说明存在错误, 如果想单独展示,可以把qrcode值放到这个网址后面:https://www.heimipay.com/comm/qr_img_view?url=
qrcode_type 支付二维码类型 int 1:通码(手输金额) 2:固码(固定金额)
realprice 支付金额 float 显示给用户的订单金额(如果自己定制支付页面一定要把这个价格显示在支付页上,而不是订单金额)
create_time 创建时间 string(20) 订单的创建时间,格式:yyyyMMddHHmmss
pay_state 支付状态 int 必然返回。订单的支付状态: 0:等待支付,1:已支付
pay_type 支付类型/渠道 int 必然返回。1:支付宝;2:微信支付
pay_name 支付名称 string(64) 原样返回。
pay_demo 扩展字段 string(64) 原样返回。
return_url 成功后跳转网址 string(255) 支付成功后的跳转网站如:http://www.aaa.com/paysuccess_return
pay_ext1 扩展字段 string(64) 原样返回。
pay_ext2 扩展字段 string(64) 原样返回。
sign 签名 string(32) MD5对上诉参数进行签名,具体签名算法请看签名算法章节