摘要：一聚易付移動支付服務簡介聚易付移動支付服務的目標就是使開發者很輕松地在自己的中集成支付功能，從而節約時間和精力用在本身的業務當中。支付兩種加密方式，和。中定義了關于支付結果的各種狀態支付成功，繼續程序邏輯支付成功至此，支付功能集成完畢。

聚易付移動支付服務(MixpayAndroidSDK)的目標就是使開發者很輕松地在自己的APP中集成支付功能，從而節約時間和精力用在本身的業務當中。

只需15分鐘，就可以讓你的APP具有支付寶支付、銀行卡支付、手機充值卡支付和游戲點卡支付。解決了之前開發者在集成支付時遇到的各種問題，比如：

與支付平臺簽約時間過長

支付平臺文檔坑太多，導到開發過程很不順暢

支付平臺技術支持不足，聯調困難

每一個支付通道都要折騰一翻

MixpayAndroidSDK致力于幫助開發者解決以上問題。

以下通過一個實際項目來說明如何使用MixpayAndroidSDK。

筆者的開發環境：

Macbook Pro 10.9.4

Android Studio v0.8.2

Gradle 1.10

JDK 1.7

注冊地址：https://m.mixpay.cn/register

注冊成功之后會收到Mixpay發出的一封確認郵件，點擊其中的確認鏈接即完成注冊過程。

登錄到商戶后臺，通過菜單導航到 應用->新建應用 頁面

https://m.mixpay.cn/application/add

在表單中填寫應用的相關信息，保存即可。如下圖所示：

其中的"通知地址"是指，Mixpay在完成一筆支付之后，通過這個地址通知給您，您在接收到進行相應的處理，并返回一個字符串"success"以表示接收成功，整個支付過程也就完成了。

APP保存之后，Mixpay會位APP分配一個唯一標識，即APP_KEY，可以在 APP詳情頁面中看到：

操作地址：https://m.mixpay.cn/key/add
密鑰用來對訂單信息進行加密。Mixpay支付兩種加密方式，RSA和MD5。
使用RSA，按頁面上給出的提示操作即可。
使用MD5，直接保存即可。在密鑰詳細信息中會看到secretKey。

在這里選擇MD5加密方式：

key信息：

操作地址：https://m.mixpay.cn/key
在key的右邊點擊"加載到應用"，在打開的頁面中選擇剛才新建的APP即可。

可以通過gradle、maven、jar包三種方式添加依賴，開發者可以根據自身情況任選。這里選擇Gradle，在build.gradle中添加以下配置：

apply plugin: "maven"
repositories {
    maven {
        url "https://maven.mixpay.cn"
    }
}
...
dependencies {
    compile ("cn.mixpay:android-sdk:1.0.+"){
        exclude group: "com.google.android", module: "android"
    }
}

引入MixpayAdroidSDK后，即可通過cn.mixpay.Order來表示自己的訂單：

import cn.mixpay.sdk.*;
...

public static final String MD5_SECRET_KEY = "568bd43af00128ee4d1bce2679*****";
private static final String APP_KEY = "60186724345*****";
Order myOrder = null;

//訂單信息
String orderId = "order_id_001";
String userId = "user_id_001";
int amount = 1;
String orderTitle = "瑜伽墊十個";
String orderDesc = "國際健美協會10:00下單";
String productId = "product_id_001";
//初始化訂單界面，此處略去代碼
//簽名
String sign = cn.mixpay.server.MD5SignatureTool.signOrderInfo(amount, APP_KEY, "", orderId, "", orderDesc, orderTitle, "", productId, "", userId
        , MD5_SECRET_KEY);

myOrder = new Order(orderId, userId, amount, orderTitle, orderDesc, productId, sign);

其中的參數依次表示：

訂單編碼、用戶編碼、金額(單位是分)、訂單標題、訂單描述、商品編碼、訂單簽名

初始化一個cn.mixpay.MixpayAPI對象，這個對象里提供了具體的支付方法：

public void pay(View view) {
    MixpayAPI api = new MixpayAPI(this, APP_KEY);
    api.startPay(this, myOrder);
}

其中this表示當前的Activity，APP_KEY是在步驟2.2中得到的應用唯一標識，myOrder就是剛剛生成的訂單。

將pay方法綁定給頁面上的支付按鈕，在點擊按鈕時，MixpayAndroidSDK會做以下工作：

檢測當前環境中是否安裝了Mixpay支付插件

沒有的話會提示用戶安裝

若有更新的Mixpay支付插件，提示用戶升級

打開支付界面引導用戶選擇支付方式并完成支付

訂單界面：

支付界面:

通過onActivityResult獲得支付結果。MixpayAPI中定義了關于支付結果的各種狀態：

    @Override
    protected void onActivityResult(int requestCode, int resultCode, Intent data) {
        super.onActivityResult(requestCode, resultCode, data);
        if (requestCode == MixpayAPI.REQUEST_CODE_START_PAY) {
            Long mixpayOrderId = null;
            try {
                mixpayOrderId = data.getLongExtra(MixpayAPI.GET_MIXPAY_ORDER_ID, 0);
            }catch (Exception e) {
                //mixpayOrderId = new Long(0);
                Log.e(TAG, "no order is returned");
            }
            switch (resultCode) {
                case MixpayAPI.ORDER_STATUS_PAY_SUCCESS:
                    //TODO:支付成功，繼續程序邏輯
                    Toast.makeText(this, "支付成功"), Toast.LENGTH_LONG).show();
                    break;
                case MixpayAPI.ORDER_STATUS_UNPAY:
                    ...
                    break;
                case MixpayAPI.ORDER_STATUS_PAYING:
                    ...
                    break;
                case MixpayAPI.ORDER_STATUS_CANCELED:
                    ...
                    break;
                case MixpayAPI.ORDER_STATUS_PAY_FAILURE:
                    ...
                    break;
                case MixpayAPI.ORDER_STATUS_UNKNOWN:
                    ...
                    break;
            }

        }

    }

至此，支付功能集成完畢。

Mixpay提供的幫助文檔中詳細說明了如何對訂單信息進行簽名，同時也提供了java、PHP、Ruby、Python、NodeJS五種語言的示例，可以直接拿來用。

其中對于java還提供了服務器端的sdk，提供了方便的訂單簽名方法。具體請參考這里：https://www.mixpay.cn/docs/v1/server/java/

在這個示例中，我直接在APP項目里引入這個服務器端sdk。

Mixpay Android SDK 使用幫助

Mixpay Server SDK For JAVA

Mixpay on Github