开发指南

快速入门

功能概述

Adapay 是一款在线支付工具，聚合了支付宝、微信等主流支付渠道，为商户提供一站式支付解决方案。通过使用 Adapay 提供的 SDK 可以快速且便捷的接入支付及其他支付相关的增值服务。

Adapay 对外提供了 Server SDK 与 Client SDK，其中 Server SDK 包含 Java、PHP、Python、Nodejs、C#、Golang 语言版本，Client SDK 包含 iOS、Android、JS、微信小程序版本。

接入准备

您需先完成以下步骤后才能开始接入 SDK 然后进行开发：

1.注册 Adapay 账号

2.极速入网

3.参数配置(新建应用，配置支付渠道)

详情参见 接入指引 。

开发接入步骤

主要步骤分以下内容：

  • 接入准备

  • 对接服务端SDK

  • 部署服务端服务

  • 前端应用对接

1，接入准备

在完成上步接入准备以后，您应该已经满足以下条件：

  • 下载了对应的商户配置文件，里面包含adapay 分配的 APIKey，adapay 公钥。

本地生成RSA私钥，并将公钥上传到商户控台，私钥妥善保存。

RSA 密钥生成方法参考帮助中心 - 证书生成。

  • 在商户控台新建了应用，获得对应的appId。并已开通对应的支付渠道。

至此，您可以开始准备开发，按照以下步骤进行开发。

2，对接服务端SDK

安装好依赖库保证运行环境没问题，可直接运行SDK demo，如能正常下单说明运行环境没问题。

  • 更改商户配置信息(APIKey, 私钥，APPID)，看下单是否成功，如能成功，说明商户配置没问题，否则请检查商户控台配置。

  • 根据业务情况，选择对应的支付通道，修改代码，调用接口。返回正确的payment 信息，至此服务端成功接入。

具体接入方式参见 SDK 使用文档：

部署服务端服务

安装并部署服务端服务到您的服务器，将下单功能开放接口给前端应用调用。

3，前端应用对接

前端应用通过网络请求获取到应用服务端从adapay 获取的支付信息。在前端页面或者APP内处理后，发起支付。

不同支付渠道处理流程不同，流程说明可参见 流程说明

具体发起方式参考以下说明：

微信端：

支付宝端：

自助服务

自助联调工具说明

Adapay 自助联调提供 Adapay API 联调功能，开发者能快速体验 Adapay 功能。

首先，开发者能在一分钟内完成支付全流程，且无学习成本。

以支付宝为例：

1、点击调试 Adapay 支付接口，能快速生成支付宝二维码，这时开发者用支付宝 App 扫一扫，能快速完成一分钱付款。

2、如果要进入开发者模式，点击开发者模式，先用 Android 手机下载 Adapay demo App，然后进入 App -> 自助联调 扫一扫，完成一分钱付款。

其次，完成支付后，开发者可以快速完成关单、退款等 Adapay 其它功能调试体验。

最后，我们准备了可以运行的几行示例代码，包括 java、php 和 python 等。开发者可以拷贝它们到自己工程中，快速接入 Adapay。

快速体验

工单系统使用说明

若您在使用中有任何的问题或建议，您可在控台右上角提交工单反馈，Adapay 技术工程师会及时跟进，并将结果第一时间反馈给您，您可在“我的工单”中查看工单处理进度。

重点知识

1.APIKEY是商户身份码与商户的公钥、商户的APPID是一一匹配，任何一个错误都是导致交易发起失败

2.签名与验证过程：商户服务端SDK利用商户的私钥进行签名后发送给Adapay，Adapay用商户公钥验证签名；Adapay用自己的私钥对响应签名，商户用Adapay的公钥验证。整个过程使用两对秘钥

3.APPID，控制台主页可以查看添加，可用于隔离交易(一般用不到),交易下挂到APPID下

4.RSA秘钥：1024，PKCS8。不支持其他格式

5.SDK签名验证：只需要配置秘钥等，其他无需再去变动

6.支付与结算是通过账户关联，故无法在结算中关联支付交易。结算情况请使用 结算查询 接口查询

7.结算失败常见原因：银行卡错误、省份地区错误、风控拦截、二类银行卡超限

8.prod对于api_live。mock对于api_test，有些情况mock环境没有办法mock（依赖微信、支付客服端的，比如公众号支付、小程序支付等）

9.SDK我们提供了服务端的SDK与前端的SDK（前端SDK可以不用，商户自己实现）