开发指南

快速入门

功能概述

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可以不用,商户自己实现)