开发指南

功能概述

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

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

快速入门

前提条件

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

1.注册 Adapay 账号

2.极速入网

3.参数配置

详情参见 接入指引

接入步骤

步骤一:获取 API Key

Adapay 系统提供的 API Key 有两种,分别对应 Adapay系统开发环境的 Live模式 与 Test模式。

  • Live Key

在您已经完成签约和渠道入驻的前提下,您可以使用 Live Key 直接完成第三方渠道的真实付款。

  • Test Key

在您还未完成渠道入驻的情况下,您可以使用 Test Key 先跑通支付流程,Test环境的支付页面是 Adapay 提供的模拟页面,直接点击对应的状态按钮即可模拟完成付款流程中的各种支付状态的更新

步骤二:上传交易公钥

Adapay 系统进行交易请求需通过公私钥加密保证报文安全,交易使用的私钥为您本地生成的 RSA 私钥,对应公钥您需上传到 控制台 的「商户信息管理」–「证书管理」-「商户 RSA 公钥」

相应的 RSA 私钥您需要妥善保管。

生成 RSA 公私钥方法详情参考帮助中心 - 证书生成

步骤三:接入服务端 SDK

下载对应语言 服务端 SDK

安装部署并发起请求,将交易请求结果返回给前端,接入详情参见服务端 SDK 使用说明

步骤四:接入客户端 SDK

下载对应语言 客户端 SDK 在您的客户端项目中接入 客户端 SDK,并请求您的服务端拿到交易对象,调用客户端 SDK 完成支付

接入详情参见客户端 SDK 使用说明

步骤五:配置服务端异步消息结果通知,来接收交易结果的事件;

步骤六:根据具体场景,在指定时间没有获取到异步消息结果通知的前提下,通过查询接口获取交易结果。

自助联调工具说明

Adapay 自助联调是调试 API 接口的自助工具,帮助您快速完成接口调试。快速体验