移动支付之支付宝

---

支付宝支付

---

支付介绍

用户已安装支付宝支付流程
步骤1：用户在商家App中选择商品下单、确认购买，进入支付环节，选择支付宝，用户点击确认支付，如图1；
步骤2：进入到支付宝页面，调起支付宝支付，出现确认支付界面，如图2；
步骤3：用户确认收款方和金额，点击立即支付后出现输入密码界面，如图3；

步骤4：输入正确密码后，支付宝端显示支付结果，如图4；
步骤5：自动回跳到商家App中，商家根据付款结果个性化展示订单处理结果，如图5。

用户未安装支付宝支付流程
步骤1：用户在商家App中选择商品下单、确认购买，进入支付环节，选择支付宝，用户点击确认支付，如图6；
步骤2：用户未安装支付宝客户端，则调起支付宝网页支付收银台，用户登录支付宝账户，如图7和图8；
步骤3：登录成功后，进入付款确认页面，如图9；
步骤4：用户点击确认付款，进入支付密码页面，如下图10；用户输入密码，完成支付，展示支付结果，如图11

案例及规范

列表首位+默认勾选+Logo+推荐标签+标语，最低标准为“Logo+支付宝”，并将作为审核依据

准入条件

申请前必须拥有经过实名认证的支付宝账户；
企业或个体工商户可申请；
需提供真实有效的营业执照，且支付宝账户名称需与营业执照主体一致；
网站能正常访问且页面显示完整，网站需要明确经营内容且有完整的商品信息；
网站必须通过ICP备案。如为个体工商户，网站备案主体需要与支付宝账户主体名称一致；
如为个体工商户，则团购不开放，且古玩、珠宝等奢侈品、投资类行业无法申请本产品。

使用说明

APP支付产品包含的接口和描述如下：

---

App支付快速接入

注意： 文档中的代码示例和Demo是用来阐述API基本使用方法的，仅针对大众场景。供ISV参考，特殊情况还请ISV自行扩展，确保符合自身业务需求。

第一步：创建应用并获取APPID

要在您的应用中使用支付宝开放产品的接口能力，您需要先去蚂蚁金服开放平台（open.alipay.com），在管理中心中创建登记您的应用，并提交审核，审核通过后会为您生成应用唯一标识（APPID），并且可以申请开通开放产品使用权限，通过APPID您的应用才能调用开放产品的接口能力。需要详细了解开放平台创建应用步骤请参考《开放平台应用创建指南》。
重要：首先先创建应用
重要：然后配置应用

第二步：配置密钥

开发者调用接口前需要先生成RSA密钥，RSA密钥包含应用私钥(APP_PRIVATE_KEY)、应用公钥(APP_PUBLIC_KEY）。生成密钥后在开放平台管理中心进行密钥配置，配置完成后可以获取支付宝公钥(ALIPAY_PUBLIC_KEY)。详细步骤请参考《配置应用环境》。

第三步：集成并配置SDK

接入移动支付需要集成两个SDK，客户端SDK需要集成在商户自己的APP中，用于唤起支付宝APP并发送交易数据，并在支付宝APP返回商户APP时获得支付结果。服务端SDK需要商户集成在自己的服务端系统中，用于协助解析并验证客户端同步返回的支付结果和异步通知。

• 集成服务端
  1.服务端SDK

• 集成客户端(android)—见App支付Android集成流程详解
  1.导入开发资源

  • 将alipay-sdk-common/alipaySdk-xxxxxxxx.jar包放入商户应用工程的libs目录下
  • 进入商户应用工程的Java Build Path，将libs目录下的alipaySDK-xxxxxxxx.jar导入
  • 选中Order and Export，勾选alipaySDK-xxxxxxxx.jar

  2.修改Manifest
  3.添加混淆规则
  4.支付接口调用
  5.支付结果获取和处理
  6.获取当前开发包版本号

第四步：调用接口

系统交互流程:

第4步：调用支付接口：此消息就是本接口所描述的支付宝客户端SDK提供的支付对象PayTask，将商户签名后的订单信息传进payv2方法唤起支付宝收银台，交易数据格式具体参见重要：请求参数说明。
1. 接口功能：外部商户App唤起快捷SDK创建订单并支付，请求参数是商户在与支付宝进行数据交互时，提供给支付宝的请求数据，以便支付宝根据这些数据进一步处理。
第5步：支付请求：支付宝客户端SDK将会按照商户客户端提供的请求参数发送支付请求。
第8步：接口返回支付结果：商户客户端在第4步中调用的支付接口，会返回最终的支付结果（即同步通知），参见客户端同步返回。
第13步：用户在支付宝APP或H5收银台完成支付后，会根据商户在手机网站支付API中传入的前台回跳地址return_url自动跳转回商户页面，同时在URL请求中附带上支付结果参数。同时，支付宝还会根据原始支付API中传入的异步通知地址notify_url，通过POST请求的形式将支付结果作为参数通知到商户系统，详情见支付结果异步通知。

特别注意：

• 构造交易数据并签名必须在商户服务端完成，商户的应用私钥绝对不能保存在商户APP客户端中，也不能从服务端下发。
• 同步返回的数据，只是一个简单的结果通知，商户确定该笔交易付款是否成功需要依赖服务端收到支付宝异步通知的结果进行判断

• 商户系统接收到通知以后，必须通过验签（验证通知中的sign参数）来确保支付通知是由支付宝发送的。建议使用支付宝提供的SDK来完成，详细验签规则参考异步通知验签。

  使用SDK快速接入:App支付API必须通过支付宝提供的移动端SDK来调用，点击查看重要：Android调用说明。

---

交易操作

• 1.交易查询接口alipay.trade.query：

AlipayClient alipayClient = .... //获得初始化的AlipayClientAlipayTradeQueryRequest request = new AlipayTradeQueryRequest();//创建API对应的request类request.setBizContent("{    "out_trade_no":"20150320010101001",    "trade_no":"2014112611001004680073956707"  }");//设置业务参数AlipayTradeQueryResponse response = alipayClient.execute(request);//通过alipayClient调用API，获得对应的response类// TODO 根据response中的结果继续业务逻辑处理

• 2.交易退款接口alipay.trade.refund：

AlipayClient alipayClient = .... //获得初始化的AlipayClientAlipayTradeRefundRequest request = new AlipayTradeRefundRequest();//创建API对应的request类request.setBizContent("{    "out_trade_no":"20150320010101001",    "trade_no":"2014112611001004680073956707"    "out_request_no":"1000001"    "refund_amount":"1"  }");//设置业务参数AlipayTradeRefundResponse response = alipayClient.execute(request);//通过alipayClient调用API，获得对应的response类// TODO 根据response中的结果继续业务逻辑处理

• 3.查询对账单下载地址接口alipay.data.dataservice.bill.downloadurl.query：

AlipayClient alipayClient = new DefaultAlipayClient("https://openapi.alipay.com/gateway.do","app_id","your private_key","json","GBK","alipay_public_key");AlipayDataDataserviceBillDownloadurlQueryRequest request = new AlipayDataDataserviceBillDownloadurlQueryRequest();//创建API对应的request类request.setBizContent("{    "bill_type":"trade",    "bill_date":"2016-04-05"  }");//设置业务参数AlipayDataDataserviceBillDownloadurlQueryResponse response = alipayClient.execute(request);// TODO 根据response中的结果继续业务逻辑处理

…..

---

---

注意：

• 异步通知：商户需要提供一个http协议的接口，包含在请求支付的入参中，其key对应notify_url。
  支付宝服务器在支付完成后，会以POST方式调用notify_url传输数据。
• 请求参数的sign字段请务必在服务端完成签名生成（不要在客户端本地签名）；
• 支付请求中的订单金额total_amount，请务必依赖服务端，不要轻信客户端上行的数据（客户端本地上行 数据在用户手机环境中无法确保一定安全）。

---

官方Demo中得主要代码(重点看官方demo)：

package com.alipay.sdk.pay.demo;import java.util.Map;import com.alipay.sdk.app.AuthTask;import com.alipay.sdk.app.PayTask;import com.alipay.sdk.pay.demo.util.OrderInfoUtil2_0;import android.annotation.SuppressLint;import android.app.AlertDialog;import android.content.DialogInterface;import android.content.Intent;import android.os.Bundle;import android.os.Handler;import android.os.Message;import android.support.v4.app.FragmentActivity;import android.text.TextUtils;import android.util.Log;import android.view.View;import android.widget.Toast;/** *  重要说明: *   *  这里只是为了方便直接向商户展示支付宝的整个支付流程；所以Demo中加签过程直接放在客户端完成； *  真实App里，privateKey等数据严禁放在客户端，加签过程务必要放在服务端完成； *  防止商户私密数据泄露，造成不必要的资金损失，及面临各种安全风险；  */public class PayDemoActivity extends FragmentActivity {    /** 支付宝支付业务：入参app_id */    public static final String APPID = "";    /** 支付宝账户登录授权业务：入参pid值 */    public static final String PID = "";    /** 支付宝账户登录授权业务：入参target_id值 */    public static final String TARGET_ID = "";    /** 商户私钥，pkcs8格式 */    public static final String RSA_PRIVATE = "";    private static final int SDK_PAY_FLAG = 1;    private static final int SDK_AUTH_FLAG = 2;    @SuppressLint("HandlerLeak")    private Handler mHandler = new Handler() {        @SuppressWarnings("unused")        public void handleMessage(Message msg) {            switch (msg.what) {            case SDK_PAY_FLAG: {                @SuppressWarnings("unchecked")                PayResult payResult = new PayResult((Map<String, String>) msg.obj);                /**                 对于支付结果，请商户依赖服务端的异步通知结果。同步通知结果，仅作为支付结束的通知。                 */                String resultInfo = payResult.getResult();// 同步返回需要验证的信息                String resultStatus = payResult.getResultStatus();                // 判断resultStatus 为9000则代表支付成功                if (TextUtils.equals(resultStatus, "9000")) {                    // 该笔订单是否真实支付成功，需要依赖服务端的异步通知。                    Toast.makeText(PayDemoActivity.this, "支付成功", Toast.LENGTH_SHORT).show();                } else {                    // 该笔订单真实的支付结果，需要依赖服务端的异步通知。                    Toast.makeText(PayDemoActivity.this, "支付失败", Toast.LENGTH_SHORT).show();                }                break;            }            case SDK_AUTH_FLAG: {                @SuppressWarnings("unchecked")                AuthResult authResult = new AuthResult((Map<String, String>) msg.obj, true);                String resultStatus = authResult.getResultStatus();                // 判断resultStatus 为“9000”且result_code                // 为“200”则代表授权成功，具体状态码代表含义可参考授权接口文档                if (TextUtils.equals(resultStatus, "9000") && TextUtils.equals(authResult.getResultCode(), "200")) {                    // 获取alipay_open_id，调支付时作为参数extern_token 的value                    // 传入，则支付账户为该授权账户                    Toast.makeText(PayDemoActivity.this,                            "授权成功\n" + String.format("authCode:%s", authResult.getAuthCode()), Toast.LENGTH_SHORT)                            .show();                } else {                    // 其他状态值则为授权失败                    Toast.makeText(PayDemoActivity.this,                            "授权失败" + String.format("authCode:%s", authResult.getAuthCode()), Toast.LENGTH_SHORT).show();                }                break;            }            default:                break;            }        };    };    @Override    protected void onCreate(Bundle savedInstanceState) {        super.onCreate(savedInstanceState);        setContentView(R.layout.pay_main);    }    /**     * 支付宝支付业务     *      * @param v     */    public void payV2(View v) {        if (TextUtils.isEmpty(APPID) || TextUtils.isEmpty(RSA_PRIVATE)) {            new AlertDialog.Builder(this).setTitle("警告").setMessage("需要配置APPID | RSA_PRIVATE")                    .setPositiveButton("确定", new DialogInterface.OnClickListener() {                        public void onClick(DialogInterface dialoginterface, int i) {                            //                            finish();                        }                    }).show();            return;        }        /**         * 这里只是为了方便直接向商户展示支付宝的整个支付流程；所以Demo中加签过程直接放在客户端完成；         * 真实App里，privateKey等数据严禁放在客户端，加签过程务必要放在服务端完成；         * 防止商户私密数据泄露，造成不必要的资金损失，及面临各种安全风险；          *          * orderInfo的获取必须来自服务端；           */        Map<String, String> params = OrderInfoUtil2_0.buildOrderParamMap(APPID);        String orderParam = OrderInfoUtil2_0.buildOrderParam(params);        String sign = OrderInfoUtil2_0.getSign(params, RSA_PRIVATE);        final String orderInfo = orderParam + "&" + sign;        Runnable payRunnable = new Runnable() {            @Override            public void run() {                PayTask alipay = new PayTask(PayDemoActivity.this);                Map<String, String> result = alipay.payV2(orderInfo, true);                Log.i("msp", result.toString());                Message msg = new Message();                msg.what = SDK_PAY_FLAG;                msg.obj = result;                mHandler.sendMessage(msg);            }        };        Thread payThread = new Thread(payRunnable);        payThread.start();    }    /**     * 支付宝账户授权业务     *      * @param v     */    public void authV2(View v) {        if (TextUtils.isEmpty(PID) || TextUtils.isEmpty(APPID) || TextUtils.isEmpty(RSA_PRIVATE)                || TextUtils.isEmpty(TARGET_ID)) {            new AlertDialog.Builder(this).setTitle("警告").setMessage("需要配置PARTNER |APP_ID| RSA_PRIVATE| TARGET_ID")                    .setPositiveButton("确定", new DialogInterface.OnClickListener() {                        public void onClick(DialogInterface dialoginterface, int i) {                        }                    }).show();            return;        }        /**         * 这里只是为了方便直接向商户展示支付宝的整个支付流程；所以Demo中加签过程直接放在客户端完成；         * 真实App里，privateKey等数据严禁放在客户端，加签过程务必要放在服务端完成；         * 防止商户私密数据泄露，造成不必要的资金损失，及面临各种安全风险；          *          * authInfo的获取必须来自服务端；         */        Map<String, String> authInfoMap = OrderInfoUtil2_0.buildAuthInfoMap(PID, APPID, TARGET_ID);        String info = OrderInfoUtil2_0.buildOrderParam(authInfoMap);        String sign = OrderInfoUtil2_0.getSign(authInfoMap, RSA_PRIVATE);        final String authInfo = info + "&" + sign;        Runnable authRunnable = new Runnable() {            @Override            public void run() {                // 构造AuthTask 对象                AuthTask authTask = new AuthTask(PayDemoActivity.this);                // 调用授权接口，获取授权结果                Map<String, String> result = authTask.authV2(authInfo, true);                Message msg = new Message();                msg.what = SDK_AUTH_FLAG;                msg.obj = result;                mHandler.sendMessage(msg);            }        };        // 必须异步调用        Thread authThread = new Thread(authRunnable);        authThread.start();    }    /**     * get the sdk version. 获取SDK版本号     *      */    public void getSDKVersion() {        PayTask payTask = new PayTask(this);        String version = payTask.getVersion();        Toast.makeText(this, version, Toast.LENGTH_SHORT).show();    }    /**     * 原生的H5（手机网页版支付切natvie支付） 【对应页面网页支付按钮】     *      * @param v     */    public void h5Pay(View v) {        Intent intent = new Intent(this, H5PayDemoActivity.class);        Bundle extras = new Bundle();        /**         * url是测试的网站，在app内部打开页面是基于webview打开的，demo中的webview是H5PayDemoActivity，         * demo中拦截url进行支付的逻辑是在H5PayDemoActivity中shouldOverrideUrlLoading方法实现，         * 商户可以根据自己的需求来实现         */        String url = "http://m.taobao.com";        // url可以是一号店或者淘宝等第三方的购物wap站点，在该网站的支付过程中，支付宝sdk完成拦截支付        extras.putString("url", url);        intent.putExtras(extras);        startActivity(intent);    }}

---

其他Demo

package cn.woblog.testalipay;import android.annotation.SuppressLint;import android.app.AlertDialog;import android.content.DialogInterface;import android.os.Bundle;import android.os.Handler;import android.os.Message;import android.support.v7.app.AppCompatActivity;import android.text.TextUtils;import android.view.View;import android.widget.Toast;import com.alipay.sdk.app.PayTask;import java.io.UnsupportedEncodingException;import java.net.URLEncoder;import java.text.SimpleDateFormat;import java.util.Date;import java.util.Locale;import java.util.Random;import cn.woblog.testalipay.domain.PayResult;import cn.woblog.testalipay.util.SignUtils;public class MainActivity extends AppCompatActivity {    public static final String PARTNER = "";    // 商户收款账号    public static final String SELLER = "";    // 商户私钥，pkcs8格式    public static final String RSA_PRIVATE = "";    private static final int SDK_PAY_FLAG = 1;    @SuppressLint("HandlerLeak")    private Handler mHandler = new Handler() {        @SuppressWarnings("unused")        public void handleMessage(Message msg) {            switch (msg.what) {                case SDK_PAY_FLAG: {                    PayResult payResult = new PayResult((String) msg.obj);                    /**                     * 同步返回的结果必须放置到服务端进行验证（验证的规则请看https://doc.open.alipay.com/doc2/                     * detail.htm?spm=0.0.0.0.xdvAU6&treeId=59&articleId=103665&                     * docType=1) 建议商户依赖异步通知                     */                    String resultInfo = payResult.getResult();// 同步返回需要验证的信息                    String resultStatus = payResult.getResultStatus();                    // 判断resultStatus 为“9000”则代表支付成功，具体状态码代表含义可参考接口文档                    if (TextUtils.equals(resultStatus, "9000")) {                        Toast.makeText(MainActivity.this, "支付成功", Toast.LENGTH_SHORT).show();                    } else {                        // 判断resultStatus 为非"9000"则代表可能支付失败                        // "8000"代表支付结果因为支付渠道原因或者系统原因还在等待支付结果确认，最终交易是否成功以服务端异步通知为准（小概率状态）                        if (TextUtils.equals(resultStatus, "8000")) {                            Toast.makeText(MainActivity.this, "支付结果确认中", Toast.LENGTH_SHORT).show();                        } else {                            // 其他值就可以判断为支付失败，包括用户主动取消支付，或者系统返回的错误                            Toast.makeText(MainActivity.this, "支付失败", Toast.LENGTH_SHORT).show();                        }                    }                    break;                }                default:                    break;            }        }    };    @Override    protected void onCreate(Bundle savedInstanceState) {        super.onCreate(savedInstanceState);        setContentView(R.layout.activity_main);    }    public void testAlipay(View view) {        if (TextUtils.isEmpty(PARTNER) || TextUtils.isEmpty(RSA_PRIVATE) || TextUtils.isEmpty(SELLER)) {            new AlertDialog.Builder(this).setTitle("警告").setMessage("需要配置PARTNER | RSA_PRIVATE| SELLER")                    .setPositiveButton("确定", new DialogInterface.OnClickListener() {                        public void onClick(DialogInterface dialoginterface, int i) {                            //                            finish();                        }                    }).show();            return;        }        String orderInfo = getOrderInfo("测试的商品", "该测试商品的详细描述", "0.01");/** * 特别注意，这里的签名逻辑需要放在服务端，切勿将私钥泄露在代码中！ */        String sign = sign(orderInfo);        try {            /**             * 仅需对sign 做URL编码             */            sign = URLEncoder.encode(sign, "UTF-8");        } catch (UnsupportedEncodingException e) {            e.printStackTrace();        }/** * 完整的符合支付宝参数规范的订单信息 */        final String payInfo = orderInfo + "&sign=\"" + sign + "\"&" + getSignType();        Runnable payRunnable = new Runnable() {            @Override            public void run() {                // 构造PayTask 对象                PayTask alipay = new PayTask(MainActivity.this);                // 调用支付接口，获取支付结果                String result = alipay.pay(payInfo, true);                Message msg = new Message();                msg.what = SDK_PAY_FLAG;                msg.obj = result;                mHandler.sendMessage(msg);            }        };// 必须异步调用        Thread payThread = new Thread(payRunnable);        payThread.start();    }    /**     * create the order info. 创建订单信息     */    private String getOrderInfo(String subject, String body, String price) {        // 签约合作者身份ID        String orderInfo = "partner=" + "\"" + PARTNER + "\"";        // 签约卖家支付宝账号        orderInfo += "&seller_id=" + "\"" + SELLER + "\"";        // 商户网站唯一订单号        orderInfo += "&out_trade_no=" + "\"" + getOutTradeNo() + "\"";        // 商品名称        orderInfo += "&subject=" + "\"" + subject + "\"";        // 商品详情        orderInfo += "&body=" + "\"" + body + "\"";        // 商品金额        orderInfo += "&total_fee=" + "\"" + price + "\"";        // 服务器异步通知页面路径        orderInfo += "&notify_url=" + "\"" + "http://notify.msp.hk/notify.htm" + "\"";        // 服务接口名称， 固定值        orderInfo += "&service=\"mobile.securitypay.pay\"";        // 支付类型， 固定值        orderInfo += "&payment_type=\"1\"";        // 参数编码， 固定值        orderInfo += "&_input_charset=\"utf-8\"";        // 设置未付款交易的超时时间        // 默认30分钟，一旦超时，该笔交易就会自动被关闭。        // 取值范围：1m～15d。        // m-分钟，h-小时，d-天，1c-当天（无论交易何时创建，都在0点关闭）。        // 该参数数值不接受小数点，如1.5h，可转换为90m。        orderInfo += "&it_b_pay=\"30m\"";        // extern_token为经过快登授权获取到的alipay_open_id,带上此参数用户将使用授权的账户进行支付        // orderInfo += "&extern_token=" + "\"" + extern_token + "\"";        // 支付宝处理完请求后，当前页面跳转到商户指定页面的路径，可空        orderInfo += "&return_url=\"m.alipay.com\"";        // 调用银行卡支付，需配置此参数，参与签名， 固定值 （需要签约《无线银行卡快捷支付》才能使用）        // orderInfo += "&paymethod=\"expressGateway\"";        return orderInfo;    }    /**     * sign the order info. 对订单信息进行签名     *     * @param content 待签名订单信息     */    private String sign(String content) {        return SignUtils.sign(content, RSA_PRIVATE);    }    /**     * get the sign type we use. 获取签名方式     */    private String getSignType() {        return "sign_type=\"RSA\"";    }    /**     * get the out_trade_no for an order. 生成商户订单号，该值在商户端应保持唯一（可自定义格式规范）     */    private String getOutTradeNo() {        SimpleDateFormat format = new SimpleDateFormat("MMddHHmmss", Locale.getDefault());        Date date = new Date();        String key = format.format(date);        Random r = new Random();        key = key + r.nextInt();        key = key.substring(0, 15);        return key;    }}