快速接入指南 - shoufuyou/Shoufuyou-SDK-Doucument-for-core-client GitHub Wiki

快速接入流程

首付游提供的SDK，开箱即用，下面简述一下快速接入流程：

测试环境

  • nginx1.8+php5.6(sdk要求php>=5.4)
  • shoufuyou-sdk-php-2.4.0
  • 解压 SDK demo， 放到网站开发测试环境

收单流程

  • 访问 trade.create.php - 收单接口(需要修改product_type，任意一个即可)， 跳转到首付游分期支付页面
  • 首付游分期支付页面会进行手机号验证(安全 + 风控，测试环境填写 1234 即可)，然后确认订单, 支付首付(测试环境假支付即可)
  • 支付首付后，提示用户返回商户，点击后触发 after_pay_return.php - 同步通知接口，告知商户交易结果
  • 为防止漏单， 务必接入 after_pay_notify.php - 异步通知 接口，并做好多次通知下的订单去重

退款流程

  • 调用 trade.refund.php - 退款接口即可

其他

  • 查询接口: trade.query.php，接入 同步通知+异步通知 基本可以保证 99% 的高可用，不过还是建议接入查询接口，并制定逻辑防止通知没有到达的情况主动轮询
  • 费率查询接口: trade.rate.query.php，可以到常见问题查看相关问答

sdk demo 结构

下面简述一下 SDK 目录结构

lib/
	SfyApi.php // API接口类
	SfyConfig.php // 环境配置
	SfyPay.php // 网关收单类
	SfyTripleDESCrypt.php // 3DES加解密类
	SfyUtil.php // 工具类
after_pay_notify.php // 异步通知
after_pay_return.php // 同步通知
trade.create.php // 交易收单接口
trade.query.php // 交易查询接口
trade.rate.query.php // 交易利率查询接口
trade.refund.php // 交易退款接口