完善的API文档、多语言SDK和详尽的示例代码，助你快速完成支付功能集成
简单四步，即可完成支付能力接入
在生活圈支付官网注册商户账号，完成实名认证
在商户后台创建应用，获取AppID和API密钥
根据开发语言选择对应SDK，参照文档完成集成
配置回调地址，完成测试后即可正式接入生产环境
RESTful API 设计，统一响应格式，支持 HTTPS 加密传输
创建一笔新的支付订单，返回支付参数供客户端调起支付
/v1/pay/order/create根据商户订单号或平台订单号查询订单支付状态
/v1/pay/order/query对已支付成功的订单发起全额或部分退款
/v1/pay/refund/apply向用户微信零钱或银行卡发起单笔或批量付款
/v1/pay/transfer对指定订单执行分账操作，将资金分账给多个接收方
/v1/pay/profitsharing对信用卡额度进行冻结，适用于押金、保证金场景
/v1/pay/preauth/freeze// Java SDK 调用示例 ShqPayClient client = new ShqPayClient.Builder() .appId("your_app_id") .apiKey("your_api_key") .build(); PayOrderRequest request = new PayOrderRequest(); request.setOutTradeNo("ORDER_20240101_001"); request.setTotalAmount(new BigDecimal("99.99")); request.setSubject("商品名称"); request.setChannel("wx"); request.setNotifyUrl("https://your-domain.com/notify"); PayOrderResponse response = client.execute(request); if (response.isSuccess()) { System.out.println("支付参数: " + response.getPayParams()); }
提供Java、Python、PHP、Node.js等主流语言的完整调用示例
# 安装: pip install shqpay from shqpay import ShqPayClient client = ShqPayClient( app_id="your_app_id", api_key="your_api_key" ) order = client.pay.create_order( out_trade_no="ORDER_001", total_amount=99.99, subject="商品名称", channel="wx", notify_url="https://your-domain.com/notify" ) print(order.pay_params)
// 安装: composer require shqpay/sdk require_once 'vendor/autoload.php'; use ShqPay\Client; $client = new Client([ 'app_id' => 'your_app_id', 'api_key' => 'your_api_key' ]); $result = $client->pay->createOrder([ 'out_trade_no' => 'ORDER_001', 'total_amount' => 99.99, 'subject' => '商品名称', 'channel' => 'wx', 'notify_url' => 'https://your-domain.com/notify' ]);
// 安装: npm install shqpay const { ShqPayClient } = require('shqpay'); const client = new ShqPayClient({ appId: 'your_app_id', apiKey: 'your_api_key' }); const order = await client.pay.createOrder({ outTradeNo: 'ORDER_001', totalAmount: 99.99, subject: '商品名称', channel: 'wx', notifyUrl: 'https://your-domain.com/notify' }); console.log(order.payParams);
// 安装: go get github.com/shqpay/sdk-go import "github.com/shqpay/sdk-go" client, _ := shqpay.NewClient("app_id", "api_key") order, _ := client.Pay.CreateOrder(shqpay.OrderRequest{ OutTradeNo: "ORDER_001", TotalAmount: 99.99, Subject: "商品名称", Channel: "wx", NotifyURL: "https://your-domain.com/notify", }) fmt.Println(order.PayParams)
保障支付数据安全，防范交易风险
所有API接口仅支持HTTPS协议传输，确保数据在传输过程中加密，防止中间人攻击和数据窃取。
每笔请求均需携带RSA-SHA256数字签名，服务端严格校验签名有效性，防止请求被篡改或伪造。
支持配置服务器出口IP白名单，仅允许指定IP地址发起API调用，从源头阻断非法请求。
API密钥仅存储在服务端，禁止在客户端、前端代码或版本控制中暴露。支持定期轮换密钥。
回调通知携带时间戳和随机数，商户端应校验时间窗口并做去重处理，防止重放攻击。
银行卡号、身份证号等敏感信息在日志和接口返回中自动脱敏处理，符合PCI DSS安全标准。
接入过程中常见问题的解答，覆盖密钥获取、支付渠道、回调处理、沙箱测试、费率计算等
注册并完成实名认证后，登录商户后台，在「应用管理」中创建应用，系统将自动生成 AppID 和 API 密钥。请妥善保管密钥，不要在客户端暴露。如需重置密钥，可在后台重新生成，旧密钥将在5分钟后失效。
目前支持微信支付（JSAPI、Native、H5、小程序、APP）、支付宝（电脑网站、手机网站、APP、小程序）、银联云闪付、银联卡刷卡支付（磁条卡、芯片卡、闪付）、国外银行卡支付（Visa、MasterCard、JCB、AE）等多种渠道。一次对接即可覆盖所有主流支付方式。
请确保回调地址可公网访问且返回 HTTP 200 状态码。系统会在 24 小时内最多重试 8 次，重试间隔为1分钟、5分钟、15分钟、30分钟、1小时、2小时、4小时、8小时。同时建议配合主动查询接口使用，确保订单状态同步。
在商户后台开启沙箱模式后，使用沙箱 AppID 和沙箱密钥调用接口。沙箱环境模拟真实支付流程，不产生真实资金交易，适合开发和测试阶段使用。沙箱环境支持模拟支付成功、支付失败、退款等各种场景。
不同支付渠道费率不同，微信支付和支付宝一般为 0.38%-0.6%，银联卡刷卡根据卡类型有所差异（借记卡0.45%，贷记卡0.55%），国外银行卡费率为2.5%-3.5%。具体费率请联系商务获取详细报价，量大可享优惠。
首先检查网络延迟，建议使用ping和traceroute测试到API服务器的网络质量。其次检查请求参数是否正确，错误的参数会导致额外的校验时间。最后查看是否开启了调试日志，生产环境建议关闭详细日志以提升性能。如持续缓慢请联系技术支持。
退款申请提交后，系统实时处理。微信和支付宝退款一般即时到账，最迟不超过24小时。银联卡刷卡退款需经过银联清算，通常1-3个工作日到账。退款到账时间受银行处理速度影响，节假日可能顺延。
可通过「交易对账单」API按日下载对账文件，格式为CSV。也可登录商户后台，在「交易管理-对账单」中在线查看和下载。对账单包含所有交易明细、手续费、结算金额等信息，方便与财务系统对账。
支持。平台型商户可使用「订单分账」接口，在支付完成后将资金按比例或固定金额分账给多个接收方。分账接收方需提前在后台配置。分账功能可有效规避二清风险，满足平台型业务的合规需求。
可通过以下渠道获取技术支持：1) 查看开发者文档和FAQ；2) 加入开发者QQ群（群号：800-xxx-xxxx）与社区交流；3) 提交工单至技术支持团队，工作日2小时内响应；4) 紧急问题可拨打7x24小时技术支持热线。