支付接口介绍

使用此接口可以实现支付宝、QQ钱包、微信支付与财付通的即时到账，免签约，无需企业认证。

本文阅读对象：商户系统（在线购物平台、人工收银系统、自动化智能收银系统或其他）集成开心支付涉及的技术架构师，研发工程师，测试工程师，系统运维工程师。

接口申请方式

共有两种接口模式：

（一）普通支付商户
可以获得一个支付商户，目前认证费是5元。可在线申请：接入申请，在线申请之后即可登录使用！

（二）合作支付商户
获得一个合作者身份TOKEN，可以集成到你开发的程序里面，通过接口无限申请普通支付商户，并且每个普通支付商户单独结算，相对独立。申请需要进行企业或开发者资质认证，请联系人工申请QQ58888，申请之后会将合作者身份TOKEN给你！（内测暂不开放）

协议规则

传输方式：HTTP

数据格式：JSON

签名算法：MD5

字符编码：UTF-8

[API]查询商户余额

URL地址：https://xpay.cctzz.cc/api.php?act=paymentBalance&pid={商户ID}&key={商户密钥}

请求参数说明：

返回结果：

[API]查询单个代收订单

URL地址：https://xpay.cctzz.cc/api.php?act=order&pid={商户ID}&key={商户密钥}&out_trade_no={商户订单号}

请求参数说明：

返回结果：

[API]批量查询代收订单

URL地址：https://xpay.cctzz.cc/api.php?act=orders&pid={商户ID}&key={商户密钥}

请求参数说明：

返回结果：

[API]查询单个代付订单

URL地址：https://xpay.cctzz.cc/api.php?act=paymentOrder&pid={商户ID}&key={商户密钥}&out_trade_no={商户订单号}

请求参数说明：

返回结果：

[API]批量查询代付订单

URL地址：https://xpay.cctzz.cc/api.php?act=paymentOrders&pid={商户ID}&key={商户密钥}

请求参数说明：

返回结果：

发起支付请求

URL地址：https://xpay.cctzz.cc/submit.php

POST数据：pid={商户ID}&type={支付方式}&out_trade_no={商户订单号}&notify_url={服务器异步通知地址}&return_url={页面跳转通知地址}&name={商品名称}&money={金额}&sitename={网站名称}&sign={签名字符串}&sign_type=MD5

请求参数说明：

结果参数说明：

data参数说明：

发起网关支付请求

URL地址：https://xpay.cctzz.cc/ebanking.php

POST数据：pid={商户ID}&type={支付方式}&out_trade_no={商户订单号}&notify_url={服务器异步通知地址}&return_url={页面跳转通知地址}&name={商品名称}&money={金额}&sitename={网站名称}&sign={签名字符串}&sign_type=MD5

请求参数说明：

支付结果通知

通知类型：服务器异步通知（notify_url）、页面跳转通知（return_url）

请求方式：GET

请求参数说明：

发起代付请求

URL地址：https://xpay.cctzz.cc/payment_submit.php

POST数据：pid={商户ID}&out_trade_no={商户订单号}&notify_url={服务器异步通知地址}&card_name={收款姓名}&card_num={收款卡号}&bank_name={收款银行}&money={金额}&sign={签名字符串}&sign_type=MD5

请求参数说明：

支付结果通知

通知类型：服务器异步通知（notify_url）

请求方式：GET

请求参数说明：

服务器异步通知页面特性

必须保证服务器异步通知页面（notify_url）上无任何字符，如空格、HTML标签、开发系统自带抛出的异常提示信息等；

开心支付是用GET方式发送通知信息，因此该页面中获取参数的方式，如：$_GET[‘out_trade_no’]；

开心支付主动发起通知，该方式才会被启用；

只有在开心支付的交易管理中存在该笔交易，且发生了交易状态的改变，开心支付才会通过该方式发起服务器通知；

服务器间的交互，不像页面跳转同步通知可以在页面上显示出来，这种交互方式是不可见的；

第一次交易状态改变时，不仅会返回同步处理结果，而且服务器异步通知页面也会收到开心支付发来的处理结果通知；

程序执行完后必须打印输出“success”（不包含引号）。如果商户反馈给开心支付的字符不是success这7个字符，开心支付服务器会不断重发通知，直到超过10次通知；

程序执行完成后，该页面不能执行页面跳转。如果执行页面跳转，开心支付会收不到success字符，会被开心支付服务器判定为该页面程序运行出现异常，而重发处理结果通知；

cookies、session等在此页面会失效，即无法获取这些数据；

该方式的调试与运行必须在服务器上，即互联网上能访问；

该方式的作用主要防止订单丢失，即页面跳转同步通知没有处理订单更新，它则去处理；

当商户收到服务器异步通知并打印出success时，服务器异步通知参数才会失效。也就是说在开心支付发送同一条异步通知时（包含商户并未成功打印出success导致开心支付重发数次通知），服务器异步通知参数是不变的。

收款SDK下载

W_Sdk.zip
SDK版本：V1.1

代付SDK下载

W_Sdk.zip
SDK版本：V1.1