彩票行业收单、派奖、营销方案
第一步：创建应用
要在您的应用中使用支付宝开放产品的接口能力，您需要先去蚂蚁金服开放平台（open.alipay.com），在管理中心中创建登记您的应用，并提交审核，审核通过后会为您生成应用唯一标识（APPID），并且可以申请开通开放产品使用权限，通过APPID您的应用才能调用开放产品的接口能力。需要详细了解开放平台创建应用步骤请参考《开放平台应用创建指南》。
第二步：配置密钥
开发者调用接口前需要先生成RSA密钥，RSA密钥包含应用私钥(APP_PRIVATE_KEY)、应用公钥(APP_PUBLIC_KEY）。生成密钥后在开放平台管理中心进行密钥配置，配置完成后可以获取支付宝公钥(ALIPAY_PUBLIC_KEY)。详情请参考《配置应用环境》。
第三步：搭建和配置开发环境
- 下载服务端sdk
| 开发语言 |
资源下载 |
环境要求 |
| JAVA版资源 |
适用于Java语言、jdk版本1.5及以上的开发环境 |
|
| 适用于Java语言、jdk版本1.4及以下的开发环境 |
||
| .NET版资源 |
适用于Visual studio 2010及以上版本、Framework3.5及以上版本的开发环境 |
|
| PHP版资源 |
适用于php全系列开发环境 |
各语言版本服务端SDK详细使用说明，请参考《服务端SDK使用说明》
2.接口调用配置
在SDK调用前需要进行初始化，Java代码示例如下：
AlipayClient alipayClient = new DefaultAlipayClient(https://openapi.alipay.com/gateway.do,APP_ID,APP_PRIVATE_KEY,FORMAT,CHARSET,APP_PUBLIC_KEY);
关键参数说明:
| 配置参数 |
示例值解释 |
获取方式/示例值 |
| URL |
支付宝网关（固定） |
https://openapi.alipay.com/gateway.do |
| APPID |
APPID 即创建应用后生成 |
获取见上面创建应用 |
| FORMAT |
参数返回格式，只支持json |
json（固定） |
| APP_PRIVATE_KEY |
开发者私钥，由开发者自己生成 |
获取详见上面配置密钥 |
| CHARSET |
编码集，支持GBK/UTF-8 |
开发者根据实际工程编码配置 |
| ALIPAY_PUBLIC_KEY |
支付宝公钥，由支付宝生成 |
获取详见上面配置密钥 |
第四步调用接口
收款方案
收款方式主要有：条码支付、扫码支付。条码支付和扫码支付的应用场景、应用案例、关键参数、资金方案、对账方案进行说明。具体详细接入见当面付快速接入
条码支付
1.应用场景：主要接入中心提供的收银系统中。收银员在系统上选择彩种等信息，下订单，通过扫码枪扫描用户条码，进行收款。支付成功后打印彩票种信息，同时中心缴款系统为业主分配缴款额度。
2.应用案例：国家体彩下面的各省中心，目前上线的有山东、北京、上海、湖南、江西、青海、浙江。
3.条码支付接入：条码支付
4.关键参数说明:
| 配置参数 |
示例值解释 |
获取方式/示例值 |
| app_id |
填系统商自己创建的第三方应用id |
系统商使用自己的应用替商家调当面付接口 |
| app_auth_token |
商户授权后获取token |
|
| subject |
商品名称 |
商品名称会在账单中显示。建议传商户门店名称 |
| store_id |
外部门店编号 |
账单中可以根据门店id进行汇总，并且如果在支付宝后台开店外部门店号必须与此参数保持一致，否则系统无法识别有效门店。 |
| timeout_express |
超时时间 |
条码支付建议设置5分钟，根据实际情况传此参数。 |
| seller_id |
卖家收款账号 |
此参数与资金流向有直接的关系。收款原则，优先根据支付宝口碑后台配置的门店号绑定的对应收款账号，然后是支付宝企业版后台的门店绑定账号，最后是程序里面传的该参数，指定的收款账号。 |
| discountable_amount |
可打折金额，不可以设为0，可小于等于total_fee。
|
此参数与total_fee、undiscountable_amount三个参数，其中两个必传，另外一个由公式计算获得。 |
| goods_detail |
订单包含的商品列表信息，Json格式，其它说明详见商品明细说明 |
商品详情，最好是传，未来可以为商户做单品优惠活动 |
扫码支付
1.应用场景：主要使用在福彩自助售彩机上或者各省体彩中心开发的app上。彩民在售彩机上选择彩种，选择或填写订单金额，然后用支付宝钱包扫描订单二维码，支付成功后，机器自动出纸质彩票。
2.应用案例：中置（宁夏福彩业主，主要做机具提供商）。
3.扫码支付接入：扫码支付
4.关键参数说明，同条码支付。
一码多付
1.应用场景：目前一家彩票isv正在接入中。彩民在店内选择彩票后，前台打印彩票，彩民通过支付宝钱包扫秒前台摆放的二维码，进入订单页面，输入订单金额等信息，进行付款。是单独的收款工具。主要是当面付条码支付和二维码支付的补充收款方案。
2.应用案例：厦门咕啦（一家isv）
3.快速接入：查看
资金方案
彩票行业资金解决方案主要有两种：一资金直接进入彩票中心的支付宝账号。二资金直接进入彩票投注站业主的支付宝账户。涉及到的对象有：省中心（体彩、福彩）、投注站业主。资金流解决方案一般有几种：
- 资金直接进入彩票中心的支付宝账号解决方案：
资金统一收到彩票中心，按照每笔交易款项，给投注站持续分配售彩额度。然后投注站售彩。此方式体彩、福彩中心账号签约，不需要配置收款限制集。
如图：
- 资金直接进入投驻站业主的支付宝账号解决方案
中心为满足投注站业主需要，将款项直接收到投注站业主账号中。此方案需要中心签约，其他业主账号通过收款限制集方式实现收款。
对账方案
采用sftp账单模式或者接入账单下载地址接口（查询账单接口(alipay.data.dataservice.bill.downloadurl.query)）。
Sftp账单模式：支持账单定制，详见请点击
两种方式都是T+1提供账单，一般在每天上午10:00之前生成好账单。
退款方案
1.退款方案有两种，一是调用退款接口，二使用单笔转账或者批量付款到支付宝账户或者银行卡。
退款接口是资金遵循原路退的原则。譬如：用户使用银行卡支付，就会退退到银行卡上。推荐此方案。
转账实际上可以在退款的场景中使用，用来做退款。一般彩票行业对账户资金流有一个原则，收款账户只进不出，收支两条线。如果商户有这样的需求，就可以考虑转账类的接口。但在调接口时，需要明确转账到支付宝账户或者是银行卡信息需要怎样收集过来。这个点需要考虑。
2.相关接口列表
统一收单交易退款接口 文档
批量付款到支付宝账户文档
B2C单笔转账到银行卡接口-alipay.fund.trans.tobank
B2C单笔转账到账户接口-alipay.fund.trans.toacc
B2C转账订单查询接口-alipay.fund.trans.query
