DF通信

支持中心

Partner API 对接说明

最后更新:2026-09-10

DF通信 面向 B2B 合作方提供标准化 Partner API,支持号码资源检索、新号开通、线路充值及流量包采购。采用预充值人民币(CNY)结算,接口扣费自 Partner 钱包余额扣除。本文概述合作模式、计费与折扣规则;技术文档、接入地址及凭证在审核通过后由运营单独下发。

文档范围

本页为业务与计费说明,不含公网 API 地址、OpenAPI 规范及示例代码。完整技术文档在合作审核通过后,通过约定渠道单独提供。

适用场景

  • 具备稳定分销或代理业务,需批量、自动化采购爱沙尼亚号码及配套服务的合作方
  • 计划将号码能力集成至自有系统、应用或运营后台的技术团队与平台方
  • 接受预充值结算模式,并具备基本 API 对接与运维能力的 B2B 客户

准入与开通

Partner API 实行审核开通,暂不开放自助注册。请通过 联系我们 提交申请,并提供公司名称、预计业务规模、技术对接人及 Webhook 接收地址。审核通过后,运营将下发 API Key、API Secret、Partner ID 及完整对接文档。账户状态为 active 后即可调用接口。

业务流程

  • 新号开通:号码检索 → 创建待确认订单 → 确认扣费并完成上游履约
  • 线路维护:对已购号码进行话费充值或流量包采购
  • 异步通知:配置 Webhook 接收订单完成、充值结果、余额预警等事件
  • 余额共用:绑定前台账号后,API 余额可与站内「我的钱包」合并使用(技术字段 usesSiteWallet)

账户与计费

预充值钱包

所有 API 写操作及扣费类接口均从 Partner 钱包(CNY)扣除。余额不足时接口返回 402。充值由运营后台处理,或通过绑定账号后的站内钱包入账;流水可通过余额查询接口导出,用于对账。钱包使用规则另见 钱包信用条款。

报价构成

买号订单标价(listAmountCny)由卡费与欧元侧零售价(号码费、预存、流量包、手续费,按当日汇率及平台加点折算)组成。线路充值与流量包采购按零售价全额计费,不参与 Partner 折扣。总部成本以欧元结算,具体扣费金额以接口实时 quote 为准。

卡费折扣

买号时可对卡费部分享受折扣:eSIM 与实体卡卡费均为 ¥88。号码费、预存、流量包、手续费等成本项不参与折扣。折扣比例通过 GET /balance 查询,字段包括 discountPercent(当前比例)、discountSource(tier 阶梯 / manual 手动)及 lifetimeTopupCny(累计预存)。

  • 阶梯折扣:累计预存满 ¥1,000 享卡费 10%;满 ¥2,000 享卡费 15%
  • 累计预存仅统计充值入账,消费扣减与人工调账不影响档位
  • 手动折扣:运营可为指定 Partner 配置固定卡费折扣,优先级高于阶梯
  • 折后实扣:amountCny = listAmountCny −(卡费 × discountPercent);阶梯升级时可能触发 Webhook wallet.tier_upgraded

接口能力概要

  • 钱包:余额查询、流水查询
  • 目录:号码检索、占号校验、新号套餐列表
  • 订单:创建待确认订单(返回报价)、确认扣费并履约
  • 线路:线路列表与状态、话费充值、流量包购买
  • Webhook:连通性测试、投递记录查询

安全要求

  • 全量请求:X-Partner-Key + Authorization: Bearer <api_secret>
  • 写操作:另需 HMAC-SHA256 请求签名(Timestamp、Nonce、Signature)
  • 支持 IP 白名单、Idempotency-Key 幂等控制及 Scope 权限隔离
  • 扣费类接口上线前须在测试环境完成小额联调,并确认报价与余额逻辑

技术支持

开通后提供的完整技术文档涵盖鉴权签名、错误码、Webhook 载荷规范及联调示例。业务申请、充值及技术问题请通过 联系我们 联系,或发送邮件至 hello@dfsim.cn(邮件标题请注明「API 对接」)。请勿在公开渠道传播 API 地址、密钥或内部文档。

总部成本以欧元结算;API 折扣为平台让利,定价及汇率以接口实时 quote 为准。