米大师SDK接入

保密性采用大白话形式简短对话

支付功能概览

1.啥叫支付呢？？？
时间往回走，很久以前，其实没有货币的概念，于是有了以物换物的行为。
几千年之前，很多的原始人，手里拥有不同的物品，甚至出现了多余，但是又想要别人手里的，怎么办，拿自己的物品去换别人手里的物品。

如果某个原始男人拿自己挖来的漂亮宝石去换一个原始女人手里的水果。那么这个这个男人想获得水果，就必须给女人水果。当这个部落的所有人都使用漂亮宝石去换别人的物品的时候。那么这个宝石其实就成了一种我们现代人所谓的货币，那么支付就是讲的是货币的一种流通，穿梭于整个人群之中。

2.支付渠道

支付渠道如何理解，有什么用。不急话说古代人A采用宝石给古代人B的这个方式，其实我们现代人很熟悉，不就是现金支付吗，有没有觉得现金支付麻烦呢，想一想古代人要携带一袋宝石出门换取东西，累不累，肯定累啊，于是聪明的古人就形成一种潜规则，怕累的就把宝石放到一位众望所归的老人代为保管，同时老人会记录这个人存了多少宝石，同时会给这个人一张发票方便他自己知道拥有多少宝石。于是出门就舒服了带着这个发票就可以。这个时候古代人A想买B的东西，就不需要给宝石，给b也开一个票据就可以，上面会写着花了多少宝石买什么时候，然后交给古人b，古人b就可以随时拿票兑换宝石，只需要拿着去找长老，长老会根据发票扣除上面这个人的宝石，并且给你增加相应的数量，当然直接拿来使用也是可以的。

滴滴…电脑屏幕的你发现什么了吗？没错，这个众望所归的老人的职责不就是我们目前银行干的事情吗，然而现代比古代关系更加复杂，所以出现各种货币，各种支付方式，比如银行转账，电子钱包支付，信用卡等，这么多的支付方式都可以完成付款其实就统称为支付渠道。

我饿了，去吃了一个炒饭，我就需要给钱，那么就面临支付渠道的选择，是微信，还是支付宝，还是现金等渠道的选择。

回到正题：
当然支付渠道的选择和很多因为有关支付稳定性，费率等等。
支付渠道的选择还会受游戏上架渠道的影响，某些渠道上架是需要接入对应的支付渠道的。
例如你要上苹果Appstore，你就要接入苹果Appstore 的支付渠道。

app上苹果Appstore，你就要接入苹果Appstore 的支付渠道，算霸道吗

苹果要求应用开发者接入其App Store的支付渠道，这一做法是否“霸道”，在很大程度上取决于具体的情境和解读角度。以下是对这一问题的详细分析：

苹果App Store支付渠道接入要求

苹果公司对其应用商店App Store有严格的管理规定，要求所有应用内购买必须通过苹果的支付系统进行，即使用苹果支付（Apple Pay）或应用内购买（In-App Purchase，简称IAP）。这一政策确保了苹果能够对应用内购买进行抽成，通常为30%。

开发者对苹果App Store支付渠道接入规定的态度

• 支持观点：一些开发者认为，苹果的支付系统提供了安全、便捷的支付体验，对于用户来说是一种保障。
• 反对观点：另一些开发者则认为，苹果的这一政策限制了他们的商业自由，使他们无法选择更有利的支付渠道，从而影响了他们的收益。

苹果App Store支付渠道接入规定的潜在影响

• 对开发者的影响：这一政策直接影响开发者的收入，因为他们无法绕过苹果的抽成系统，这可能导致他们在与苹果的谈判中处于不利地位。
• 对用户的影响：用户可能会因为支付选项的限制而面临不便，尤其是在寻找更优惠的支付选项时。

综上所述，苹果要求应用开发者接入其App Store的支付渠道，这一做法虽然为苹果带来了显著的收入，但也引发了开发者和用户的广泛讨论。对于是否“霸道”，不同利益相关者可能有不同的看法’

## 3.游戏商品
玩过游戏的都知道了，需要你花钱去兑换的一切都可以叫商品。
不过我们游戏app内部可以购买的商品其实主要分2类 一种是；类似元宝，我用钱买到元宝，然后慢慢花元宝，所以我们称这种商品是消耗品， 还有一直商品比如月卡，直接花钱买了，一般是叫非消耗品商品。

米大师支付SDK

1. 米大师SDK功能
付款交易、结算，清算等，关键来了，支付sdk不是存在很多了吗，为什么还要开发一款叫米大师的支付sdk，是我们吃饱了钱多吗，No,正是因为支付渠道太多，一一接入非常麻烦，为了公式的效率，我们专门弄个部门把这个活干了，这样其他具体游戏部门就不需要去接那么的支付渠道，比如我的游戏接入什么微信支付，又怕玩家不用微信支付，然后又接入支付宝支付，真麻烦呀，这样以后游戏部分拿着米大师sdk文档接入米大师就可以了，
米大师sdk功能难道就只有支付功能吗，no为了方便甚至是迎合游戏部门的常用需求会支持下列功能：
1.多种支付渠道合并
2.盈利统计
3.交易日志
4.风控支持，比如恶意退款等。
5.跨平台

2.支付渠道
就是移动端而言Midas提供的支付渠道有：
国内版本
Android 平台：微信支付，QQ支付
iOS：苹果支付
海外版本
GooglePlay
苹果Appstore

3.米大师SDK支付体系
其实就很简单了呀米大师就相当一个中介咯，他们站在各种支付渠道和游戏app或者应用程序的中间，游戏app发起支付请求其实只要和米大师说下，米大师就会去采用具体支付渠道去付款，比如一个玩家在游戏内点击购买通知了米大师，米大师在拉起微信支付，完成付款。

接入米大师

1.准备工作
首先我们需要确定我们的需求，比如我们的游戏app需要接入支付的具体哪个功能，比如游戏币充值或者道具直购等其他。

渠道注册
比如我们需要去微信 googlePlay 苹果appStore官网去注册下我们的游戏app相关资料。

支付渠道注册是指商家或应用开发者为了接入支付服务，需要按照支付平台的要求提交相关资料和信息，以完成在支付平台的注册过程。这一过程通常涉及准备必要的资料、选择注册方式、提交申请以及等待审核等环节。以下是支付渠道注册的相关信息：

支付渠道注册的定义

支付渠道注册是指商家或应用开发者为了接入支付服务，需要按照支付平台的要求提交相关资料和信息，以完成在支付平台的注册过程。

支付渠道注册的目的

支付渠道注册的目的在于确保商家或应用开发者能够合法、安全地使用支付平台提供的支付服务，以便于用户进行交易支付，同时保障资金的安全流转和交易的合规性。

支付渠道注册的一般流程

1. 准备资料：根据注册类型（个人或企业），准备相应的身份证明文件、营业执照、银行账户信息等。
2. 选择注册方式：通过微信支付商户平台或相关支付平台的官网进行注册。
3. 提交申请：按照平台指引填写相关信息，上传所需资料。
4. 等待审核：提交申请后，支付平台会对提交的资料进行审核。
5. 审核通过并开通：审核通过后，商家或应用开发者将获得支付渠道账号，并可以开始使用支付服务。

支付渠道注册所需材料

• 个人注册：身份证、手机号码、银行卡。
• 企业注册：营业执照、组织机构代码证、税务登记证、企业银行账户信息、法定代表人身份证件等。

支付渠道注册的注意事项

• 确保所提供的信息真实有效，避免因信息错误导致审核不通过。
• 遵守支付平台的相关规定和政策，确保交易的真实性和合法性。

通过以上步骤，商家或应用开发者可以成功注册支付渠道，从而为用户提供安全、

支付渠道注册成功后会获得什么信息

支付渠道注册成功后，您将获得以下信息：

• 支付渠道账号：用于在支付平台进行交易和收款。
• 支付密钥配置：确保交易的安全性和数据的加密。
• 商户号：商户在微信支付侧的唯一标识。
• 拓展二维码：用于商家在小程序上注册和授权。
• 服务信息：包括服务人员的ID、联系方式等，用于提供客户服务。

通过以上信息，您可以开始使用支付渠道进行收款和交易，同时确保交易的安全性和合规性。

sdk版本对应 比如GooglePlay 支付结算系统应该对应什么sdk版本

2.米大师接入流程
第一步注册应用
看官网

需要注册应用的目的

支付SDK（Software Development Kit）需要注册应用的主要目的包括以下几个方面：

1. 身份验证与授权

• 确保开发者身份：通过注册应用，支付平台可以验证开发者的身份，确保只有合法的开发者和企业才能接入SDK。
• 授权访问：注册过程授予开发者访问支付平台API和服务的权限，使其能够集成支付功能到自己的应用中。

2. 安全性保障

• 数据加密：支付SDK通常涉及敏感的金融交易数据，注册应用有助于实施必要的安全措施，如数据加密和传输安全。
• 防止欺诈与滥用：严格的注册流程有助于防范未授权的使用和潜在的欺诈行为。

3. 合规性管理

• 遵守法律法规：许多国家和地区对金融服务有严格的监管要求，注册应用有助于确保SDK的使用符合相关法律法规。
• 行业标准遵循：支付行业通常有一系列标准操作流程，注册过程确保了这些标准得到遵循。

4. 服务支持与维护

• 获取官方文档和技术支持：注册后，开发者可以获得官方的技术文档和支持服务，便于解决开发过程中遇到的问题。
• 定期更新与维护：支付平台会不断更新SDK以修复漏洞和添加新功能，注册应用确保开发者能够及时获取这些更新。

5. 交易管理与结算

• 创建商户账户：注册过程中通常需要创建商户账户，以便于处理交易和资金结算。
• 设置支付方式：开发者可以根据业务需求配置不同的支付方式和货币类型。

6. 性能监控与优化

• 收集使用数据：注册后的应用可以被纳入平台的监控体系，帮助分析SDK的性能和使用情况。
• 反馈改进意见：基于收集到的数据和用户反馈，支付平台可以持续改进SDK的功能和用户体验。

实施步骤

1. 访问支付平台官网：前往相应支付服务商的官方网站。
2. 填写注册信息：按照页面提示填写企业或个人信息。
3. 提交审核材料：上传必要的文件和资料进行审核。
4. 等待审核通过：审核通过后会收到通知，并获得相应的SDK密钥和应用凭证。

总之，支付SDK注册应用不仅是技术集成的前提条件，也是保障交易安全、符合法规要求及提供后续支持的重要环节。

第二步米大师联调环境部署
一般分为沙盒环境和现网环境，沙盒环境其实就是安全环境需要让跑在上面的应用经过一层安全逻辑，一般都是米大师那边负责搭建好。
第三步配置
主要分米大师官网配置和对应接入渠道平台的配置。

米大师官网配置其实主要是商品的
一般是几个档位的商品可以配置
每一个充值档位对应一个商品，商品信息主要包含价格和物品ID，物品会在购买的时候作为参数传给米大师后端。

渠道平台配置也是商品配置，目的是什么呢，其实主要是需要把这些商品信息同步到比如appStore的应用管理平台上，方便进行相关功能。
总之，保持渠道平台与米大师之间的商品配置一致性对于企业的长期发展和日常运营至关重要。

商品信息在支付平台的作用是什么

商品信息在支付平台中扮演着至关重要的角色，它不仅影响支付流程的顺畅性，还关系到交易的安全性、合规性以及用户体验。以下是商品信息在支付平台中的主要作用：

• 确保支付指令的准确性：商品信息是生成支付指令的基础，确保支付金额、收款方等关键信息无误，避免支付错误。
• 验证交易的真实性和合法性：通过商品信息与订单详情的匹配，支付平台可以验证交易的真实性和合法性，防止欺诈行为。
• 优化用户体验：提供准确的商品信息，如商品描述、价格、库存等，可以帮助用户更好地了解商品，提升购物体验。
• 支持交易纠纷的解决：在发生交易纠纷时，商品信息作为交易证据的一部分，有助于平台和用户之间快速解决问题。

商品信息在支付平台中发挥着核心作用，它不仅确保了支付流程的准确性和安全性，还极大地优化了用户体验，并支持了交易纠纷

渠道平台商品配置要和米大师上的商品配置保持一致的原因

渠道平台商品配置与米大师上的商品配置保持一致性的原因主要包括以下几点：

1. 确保用户体验一致性

• 品牌信任：用户在不同渠道看到的商品信息应保持一致，以维护品牌形象和用户的信任感。
• 减少混淆：统一的信息可以避免用户在不同平台间比较时产生混淆，提高决策效率。

2. 简化管理流程

• 集中管理：若各平台商品信息一致，可以实现集中化的商品管理和更新，降低维护成本。
• 减少错误：避免因多平台独立操作导致的重复录入或信息不一致的错误。

3. 优化财务处理

• 准确核算：确保所有平台的交易数据都能准确反映实际销售情况，便于财务核算和分析。
• 便捷结算：统一的商品信息有助于简化跨平台的结算和对账过程。

4. 提升营销效果

• 一致性推广：在进行跨渠道营销活动时，统一的商品描述和图片可以提高宣传的连贯性和有效性。
• 数据分析可靠性：准确的商品信息是进行市场分析和营销效果评估的基础。

5. 符合监管要求

• 合规性：许多行业都有严格的商品信息披露规定，保持信息一致性有助于遵守这些规定。
• 法律风险防范：避免因信息披露不一致而引发的法律责任和纠纷。

6. 增强竞争力

• 快速响应市场：统一管理使得企业能够迅速适应市场变化，及时调整商品策略。
• 高效资源配置：准确的销售数据有助于企业更有效地分配资源，提升整体运营效率。

7. 促进技术整合

• 无缝对接：确保与其他系统（如ERP、CRM等）的顺畅连接，实现数据的自动同步和交换。
• 智能化运营：利用先进的数据分析工具，基于一致的商品数据进行智能决策支持。

8. 国际化运营需求

• 全球视野：对于跨国经营的企业而言，统一的商品信息有助于在全球范围内提供一致的服务体验。
• 本地化调整：在保持基本信息一致的前提下，可根据不同地区的特定需求进行适当本地化调整。

实施建议：

• 建立标准化的商品信息模板和流程规范。
• 定期进行跨平台的数据审核和校验。
• 强化内部沟通协作，确保各部门对商品信息的理解和执行一致。

SDK 集成

主要业务接口介绍

初始化：设置国内或者海外渠道，设置沙箱环境或者正式环境，以及日志开关
充值游戏币：客户端接口发起充值
查询游戏币：查询游戏币数据，一般后台使用
消耗游戏币：使用游戏币购买游戏内的道具，一般后台使用
查询充值活动信息：客户端使用，展示充值的活动，例如首充赠送等
查询商品本地价格：客户端使用，根据玩家账号地区获取本地货币的价格
目前公司的要求是游戏币需要托管在米大师，所以充值数据最终要存在米大师服务器上，通过查询接口向游戏服务器提供充值数据。
游戏币充值功能业务接口执行流程主要如下：

沙箱环境联调

官网文档：
https://wiki.midas.qq.com/post/index/1/27/232/0 （UE4）
https://wiki.midas.qq.com/post/index/1/27/233/0 (Unity)

环境配置问题

检查配置是否已经发布到沙箱环境
检查配置是否和对应渠道一致。
米大师后台环境问题。
账号的问题
GooglePlay渠道 在测试时需要时候对应应用的许可测试账号

手机环境的问题
测试账号登陆的地区应该要和应用发布的地区一致，海外地区的需要VPN来登陆。

米大师现网环境部署

主要是米大师那边完成部署，可能需要同步修改下SDK 中的链接地址，前后端相关参数都要一致。

米大师现网环境验证

米大师现网环境部署完成后，修改正式环境的链接地址IP， 客户端SDK 环境配置：

env 环境切换成release

现网验证支付功能

充值游戏币的流程
![在这里插入图片描述](https://i-blog.csdnimg.cn/direct/d7d5921a3dd8477eb37f8d5156068772.png

MidasIAPSDK： 米大师前端组件
MidasPayServe： 米大师后台服务
iOS StoreKit：iOS 系统平台和AppStoreServer 交互的框架组件。
AppStoreServer： 苹果后台服务

App 调用MidasIAPSDK接口Pay()
MidasIAPSDK调用iOS StoreKit 去请求AppStoreServer 配置商品数据
MidasIAPSDK 获取到商品数据后向MidasPayServer 请求下单记录（PS：这里应该会校验AppStoreServer的商品配置和MidasPayServer 的数据是否一致。）
MidasPayServer 下单校验完成回掉MidasIAPSDK
MidasIAPSDK 调用iOS StoreKit 拉起支付（iOS StoreKit 会向AppStoreServer 请求支付） 。
支付成功后 AppStoreServer 下发支付票据到MidasIAPSDK ，回调App支付完成。
MidasIAPSDK 向MidasPayServer 请求发货
MidasPayServer 通过票据校验后，下发商品（游戏币），流程结束