外观
概念：上游与下游
什么是对接
发卡站之间经常互相“拿货”：A 站有货源，B 站没有，B 站就从 A 站进货再卖给自己的买家。 对接就是让这个过程自动化：B 站的买家付款后，B 站自动去 A 站下单、拿到卡密、再交给买家，全程不需要人工。
text
买家 ──付款──► 你的店（下游 / 采购方） ──自动下单、扣你在上游的余额──► 别人的店（上游 / 供货方）
◄──卡密── ◄────────────卡密─────────────| 你的角色 | 意思 | 你需要做的 |
|---|---|---|
| 下游 / 采购方 | 你从别人那里进货 | 在上游注册账号、拿到凭证、充值余额；在本站后台 对接管理 添加连接、导入商品 |
| 上游 / 供货方 | 别人从你这里进货 | 让对方在本站前台注册账号、申请 API 凭证；你在后台审核；对方在本站充值余额 |
同一个站点可以同时是上游和下游。
钱是怎么走的
- 下游在上游有一个普通用户账号，账号里要有余额；
- 下游每卖出一件对接商品，系统就从下游在上游的余额里扣掉进货价；
- 下游卖给买家的价格 = 进货价 × 汇率 ×（1 + 加价比例），差价就是下游的利润。
所以作为下游，一定要保证在上游的余额充足，否则采购会失败。
支持的协议
对方用什么系统，就选对应的协议：
| 协议 | 对方是什么系统 | 本站做下游（从对方进货） | 本站做上游（给对方供货） |
|---|---|---|---|
| Zebra Store | 另一个斑马小铺 | 支持（推荐） | 支持（推荐） |
| dujiao-next | dujiao-next（独角数卡 Next）及兼容它的站点 | 支持 | 支持 |
| 异次元发卡 | acg-faka | 支持 | 支持（只提供自动发货商品） |
| 萌次元 | mcy-shop（OpenApi 插件）、异次元的“萌次元(V4.0)”店铺类型 | 支持 | 支持（只提供自动发货商品） |
各协议能力对比：
| 能力 | Zebra Store | dujiao-next | 异次元 | 萌次元 |
|---|---|---|---|---|
| 一键连接码 | 有 | — | — | — |
| 上游改价/库存后实时推送 | 有 | — | — | — |
| 增量同步 | 有 | — | — | — |
| 下单前锁定价格 | 有 | — | — | — |
| 一单多个商品 | 有 | — | — | — |
| 防重复下单 | 有 | 有 | 有 | 有 |
| 卡密加密传输 | 有 | — | — | — |
| 签名防重放 | 有（时间戳 + nonce） | 时间戳 | 无 | 无 |
| 发货结果回调 | 有 | 有 | 无（下单时同步返回） | 无（下单时同步返回） |
对方也是斑马小铺时
优先选 Zebra Store 协议：粘贴一个连接码就能接好，上游改价、补货会实时推送过来，安全性也最好。
本站需要能访问对方
对接请求是服务器对服务器发出的。上游的地址必须能从你的服务器访问到， 而且出于安全考虑，默认不允许访问内网地址（127.0.0.1、192.168.x.x、10.x.x.x 等）。 两个站点都在公网、都有域名时不需要任何设置；只在内网测试时才需要打开 integration.allow_private_addresses（见 配置文件详解）。
接下来
演示环境
我们在 dot2.com 上运行了一套演示环境，可以看到各种协议实际连起来的样子：
| 地址 | 系统 | 和主站的关系 |
|---|---|---|
https://store.dot2.com | 斑马小铺（主站） | — |
https://acg.dot2.com | 异次元发卡 | 主站的上游；同时也通过“共享店铺”从主站进货 |
https://dujiao.dot2.com | dujiao-next | 主站的上游 |
https://zs2.dot2.com | 第二个斑马小铺 | 用 Zebra Store 协议从主站进货（下游） |
https://sakura.dot2.com 等 | 主站的分站 | 见 分站 |