文档中心 > 开放平台

条码支付接入指引

更新时间：2017/08/28 访问次数：88372

本文将带您接入支付宝条码支付。
条码支付：即商家使用扫码设备，扫描用户支付宝钱包上的条码/二维码，完成收款。

创建应用 在开放平台创建一个应用

接入条码支付能力，需要在开放平台创建一个应用，通过该应用来接入各种能力。

若还未成为开放平台的入驻服务商或者商户, 请完成入驻指引。

了解应用创建步骤 | 开始创建应用

配置应用 为创建的应用添加所需功能

给应用添加当面付功能，这样就可以在你的应用里使用条码支付能力。

了解如何添加当面付功能 | 立即开始添加

签约

在使用这些能力的时候，商户需要在开放平台里进行签约，这时候约定的合同就生效了。也可以代替商户签约。

了解如何签约 | 立即开始签约

了解如何代商户签约 | 开始代商户签约

配置密钥

为了保证交易双方的身份和数据安全，需要配置双方密钥。

了解支付宝密钥处理体系 | 开始生成密钥 | 开始配置密钥

为了确定交易双方(商户和支付宝)的身份和交易数据的安全，需要对交易数据进行双方校验

应用公钥（商户自身的RSA公钥）: 支付宝使用该公钥验证该交易是商户发起。

支付宝公钥（支付宝的RSA公钥）：商户使用该公钥验证该结果是支付宝返回的。

收起

设计 接入设计

常用的接入方式与架构建议

在开始开发前，需要了解接入的方式或者所需物料等

门店直连方式 | 商户/系统商后台转发方式

即商家收银台直接通过公网向支付宝发起收款。个人商户或者单独门店建议采用直连方式

收起

商家收银台先请求到商家后台，再请求到支付宝。适合商户有多家门店，大型商户, 商户自有商户后台等模式下使用

收起

支持主流的红外扫描设备

支付宝支付物料下载 | 物料系统寄送

安全设计

为了保证交易安全，支付宝采用了一系列的安全手段

了解更多安全手段 | 了解更多安全设计指南

1. 采用HTTPS协议传输交易数据，防止数据被截获，解密。

2. 采用RSA非对称密钥，明确交易双方的身份，保证交易主体的正确性和唯一性

3. 条码定时刷新，防止被拍照

4. 防止截屏（截屏后二维码码失效）

收起

开发 开发应用与支付场景实现

SDK和开发语言

开发者可以使用多种开发方式接入支付能力，开放平台提供了支持主流开发语言的SDK接入的方式, 建议开发者采用SDK接入模式。也支持使用自己熟悉的编程语言构造HTTP请求接入支付宝支付能力

了解更多SDK接入 | 下载SDK

以java语言为例，调用交易支付接口alipay.trade.pay：

AlipayClient alipayClient = new DefaultAlipayClient("https://openapi.alipay.com/gateway.do", APP_ID, APP_PRIVATE_KEY, "json", CHARSET, ALIPAY_PUBLIC_KEY, "RSA2"); //获得初始化的AlipayClient
//创建API对应的request类
AlipayTradePayRequest request = new AlipayTradePayRequest(); 
request.setBizContent("{" +
"    \"out_trade_no\":\"20150320010101001\"," +
"    \"scene\":\"bar_code\"," +
"    \"auth_code\":\"28763443825664394\"," +
"    \"subject\":\"Iphone6 16G\"," +
"    \"store_id\":\"NJ_001\"," +
"    \"timeout_express\":\"2m\"," +
"    \"total_amount\":88.88" +
"  }"); //设置业务参数
//通过alipayClient调用API，获得对应的response类
AlipayTradePayResponse response = alipayClient.execute(request); 
System.out.print(response.getBody());
//根据response中的结果继续业务逻辑处理

收起 | 了解更多SDK开发接入细节 | 查看相关的API

了解更多HTTP方式接入

以调用交易支付接口alipay.trade.pay为例，构造http请求发起支付：

请注意需要对请求做urlencode处理，以下请求是为了方便查看，而没有做urlencode的原始报文

https://openapi.alipay.com/gateway.do?timestamp=2013-01-01 08:08:08&method=alipay.trade.pay&app_id=2284&sign_type=RSA2&sign=ERITJKEIJKJHKKKKKKKHJEREEEEEEEEEEE&version=1.0&biz_content=
  {
    "out_trade_no":"20150320010101001",
    "scene":"bar_code,wave_code",
    "auth_code":"28763443825664394",
    "subject":"Iphone6 16G",
    "seller_id":"2088102146225135",
    "total_amount":"88.88",
    "store_id":"NJ_001"
  }