摘要：一聚易付移動(dòng)支付服務(wù)簡(jiǎn)介聚易付移動(dòng)支付服務(wù)的目標(biāo)就是使開發(fā)者很輕松地在自己的中集成支付功能，從而節(jié)約時(shí)間和精力用在本身的業(yè)務(wù)當(dāng)中。支付兩種加密方式，和。中定義了關(guān)于支付結(jié)果的各種狀態(tài)支付成功，繼續(xù)程序邏輯支付成功至此，支付功能集成完畢。

聚易付移動(dòng)支付服務(wù)(MixpayAndroidSDK)的目標(biāo)就是使開發(fā)者很輕松地在自己的APP中集成支付功能，從而節(jié)約時(shí)間和精力用在本身的業(yè)務(wù)當(dāng)中。

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

與支付平臺(tái)簽約時(shí)間過長(zhǎng)

支付平臺(tái)文檔坑太多，導(dǎo)到開發(fā)過程很不順暢

支付平臺(tái)技術(shù)支持不足，聯(lián)調(diào)困難

每一個(gè)支付通道都要折騰一翻

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

以下通過一個(gè)實(shí)際項(xiàng)目來說明如何使用MixpayAndroidSDK。

筆者的開發(fā)環(huán)境：

Macbook Pro 10.9.4

Android Studio v0.8.2

Gradle 1.10

JDK 1.7

注冊(cè)地址：https://m.mixpay.cn/register

注冊(cè)成功之后會(huì)收到Mixpay發(fā)出的一封確認(rèn)郵件，點(diǎn)擊其中的確認(rèn)鏈接即完成注冊(cè)過程。

登錄到商戶后臺(tái)，通過菜單導(dǎo)航到 應(yīng)用->新建應(yīng)用 頁面

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

在表單中填寫應(yīng)用的相關(guān)信息，保存即可。如下圖所示：

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

APP保存之后，Mixpay會(huì)位APP分配一個(gè)唯一標(biāo)識(shí)，即APP_KEY，可以在 APP詳情頁面中看到：

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

在這里選擇MD5加密方式：

key信息：

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

可以通過gradle、maven、jar包三種方式添加依賴，開發(fā)者可以根據(jù)自身情況任選。這里選擇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 = "瑜伽墊十個(gè)";
String orderDesc = "國(guó)際健美協(xié)會(huì)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);

其中的參數(shù)依次表示：

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

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

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

其中this表示當(dāng)前的Activity，APP_KEY是在步驟2.2中得到的應(yīng)用唯一標(biāo)識(shí)，myOrder就是剛剛生成的訂單。

將pay方法綁定給頁面上的支付按鈕，在點(diǎn)擊按鈕時(shí)，MixpayAndroidSDK會(huì)做以下工作：

檢測(cè)當(dāng)前環(huán)境中是否安裝了Mixpay支付插件

沒有的話會(huì)提示用戶安裝

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

打開支付界面引導(dǎo)用戶選擇支付方式并完成支付

訂單界面：

支付界面:

通過onActivityResult獲得支付結(jié)果。MixpayAPI中定義了關(guān)于支付結(jié)果的各種狀態(tài)：

    @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:支付成功，繼續(xù)程序邏輯
                    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提供的幫助文檔中詳細(xì)說明了如何對(duì)訂單信息進(jìn)行簽名，同時(shí)也提供了java、PHP、Ruby、Python、NodeJS五種語言的示例，可以直接拿來用。

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

在這個(gè)示例中，我直接在APP項(xiàng)目里引入這個(gè)服務(wù)器端sdk。

Mixpay Android SDK 使用幫助

Mixpay Server SDK For JAVA

Mixpay on Github