信用付纯支付Android SDK 接入文档

一.概述 Introduction

下载demo工程

Snaplii信用付SDK

二.接入前准备

申请一个业务方标识appId，初始化SDK时传入。

上传app的release/debug apk签名的md5.

开发环境: Android Studio.

三.名词解释 Glossary

Partner: 第三方接入方

SDK: Snaplii信用付sdk

用户: 使用接入方宿主app的用户

信用付: Snaplii提供的支付产品

PT: Personal Token。代表接入方的一个用户ID，推荐使用接入方用户ID的一个hash值，不同的用户要确保value不一样。

AppId: App在Snaplii注册的应用标识ID， 由Snaplii分配给第三方。

App Secret: 第三方接入方应用secret，由Snaplii分配。

OTP: One Time Password。基于时间的，用app secret转为base32的字符串后作为key。

orderStr: 订单order String，其格式类似为

{
	"outterOrderNo":"a275702d001746caace8b40b25a09df6",  
	"orderAmount":"0.01",  
	"personalToken":"9077777766",  
	"sign":"+LtDS7AFES\/k3ttx8yd46TSMlQM="  
}

其中“sign"为签名，签名方式请参照"信用付SDK服务端接入文档"

四. OTP生成算法

One time passcode是采用标准的基于时间的TOTP算法，目前设置的有效时间跨度为1分钟。OTP的密钥为app secret + personal token拼接而成。密钥算法为"HmacSHA1"。Python算法可参照：

secret_key= secret + pt
key_str = base64.b32encode(secret_key.encode('utf-8')).decode("utf-8")
pyotp.TOTP(key_str, digest="sha1", interval=60).now()

其他语言的实现可参照对应的实现文档

五. 服务端准备工作: partner服务端Server准备

请参考服务端接入文档。

六. 客户端接入流程准备工作 (可参考文档中的demo代码工程)

步骤1:添加依赖库

在主项目的 build.gradle 中，添加以下内容：
注意：只有"mavenCentral"的仓库可以同步到依赖。如果发现获取不到依赖库，请确认下获取的链接是否有问题。可以尝试将mavenCentral() 放到所有依赖库的第一个来保证优先从这个仓库获取依赖。

allprojects {  
    repositories {  
         // 添加下方的内容  
         mavenCentral()  
         jcenter() 等其它仓库  
    }  
}

dependencyResolutionManagement {    
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
            maven {            
                    url 'https://maven.pkg.github.com/SnapPayInc/maven/'           
                    credentials {                
                        username = "snappay-jenkins"
                        password = "*********************************" //请联系Snaplii获取password     
                    }        
            }        
            google()
            mavenCentral()

    }
}

在 App Module 的 app/build.gradle 中，添加以下内容，将Snaplii SDK 作为项目依赖。

defaultConfig {
    ... ...

    dataBinding {
        enabled = true
    }
    ... ...
}

dependencies {  
    // 添加下方的内容  
    implementation 'com.snaplii.sdk:credit_sdk_sandbox_pay:0.0.3'        //sandbox环境
    // 其它依赖项  
}

步骤2:权限配置

配置 AndroidManifest.xml 文件中的运行权限

为正常完成良好的支付流程体验以及支付风控需要，Snaplii SDK 需要使用以下权限：

android.permission.INTERNET  
android.permission.ACCESS_NETWORK_STATE  
android.permission.ACCESS_COARSE_LOCATION  
android.permission.ACCESS_FINE_LOCATION  

android.permission.ACCESS_WIFI_STATE

步骤3：初始化SDK Initialize SDK

SnapliiSdk.initSdk(this, appId, PT, language, "", new OTPCallback() {      
    @Override
    public void getOtp(RetOTPCallback callback) {
         mRetOTPCallback = callback;
         //new Thread(() -> reqOtp()).start();
    }
});

步骤4：选择信用付支付时，判断是否登录，未登录调用登录接口

if (!SnapliiSdk.hasLogin()) {
    SnapliiSdk.login(DemoActivity.this, new ILoginCallback() {
        @Override
        public void onSuccess() {
            Log.e(TAG, "login success");
        }

        @Override
        public void onCancel() {
            Log.e(TAG, "login cancel");
        }
    });
}

步骤5: 支付 Start a Payment

SnapliiSdk.payment(activity, orderStr, new PayResultCallback() {
    @Override
    public void onSuccess() {
    }
    @Override
    public void onError(String errorCode, String errorMsg) {
    }
});

[可选配置接口] configurations

1.登出现有信用付账号，切换手机号:

SnapliiSdk.logout();

2.配置语言:

SnapliiSDK.setLanguage(SnapliiSDK.LAN_EN);

3.输出logcat debug日志:

SnapliiSDK.setDebug(true);

4.获取sdk版本:

SnapliiSDK.getVersion();

五.SDK接口说明

• 初始化SDK
  商户APP工程中引入依赖后，调用API前，需要先向注册您的AppId，代码如下：
  void SnapliiSdk.initSdk(Application applicationContext, String appId, String lang, String customData, OTPCallback callback);

public interface OTPCallback() {
    @Override    
    public void getOtp(RetOTPCallback callback) { 
    
    }
});

• 登录

void SnapliiSdk.login();

public interface ILoginCallback {

    void onSuccess();

    void onCancel();

}

• 支付
  void SnapliiSdk.payment(Activity activity, String orderStr, PayResultCallback callback);

public interface PayResultCallback {

    void onSuccess();

    void onError(String errorCode, String errorMsg);

}

• 检查是否登录

boolean SnapliiSdk.hasLogin();

• 退出登录

void SnapliiSdk.logout();

• 设置语言

void SnapliiSdk.setLanguage(int value);

• 打开debug日志

void SnapliiSdk.setDebug(boolean value);

• 获取Sdk版本号

String SnapliiSdk.getVersion();

六.测试和发布

在应用发布之前，需要仔细测试集成的支付 SDK 功能，确保支付过程流畅且无错误。确认Snaplii信用付支付功能已经正常工作后，就可以您的应用发布到市场上供用户使用。