通过我们的 API 转售虚拟号码:定价与利润

通过 SMS Activate App API 转售私有虚拟号码:以我们的价格购买,加上您的利润,从您的机器人或网站服务客户。

本指南面向希望通过白标服务、Telegram 机器人或小型网站向自己的客户提供私有虚拟号码的人。内容涵盖:整体运作方式、如何为每个号码定价、需要调用哪些 API 接口、计费机制,以及我们的责任边界。

转售的运作方式

您拥有一个 SMS Activate App 账号和一个 API 密钥。您通过 API 在该账号上购买号码。您的机器人或网站随后向每位客户展示其号码以及到达该号码的短信验证码。

每个号码都是来自运营商号段的真实手机号或本地号码,具体取决于国家。您的账号持有该号码 28 天。在此期间,号码可接收短信和来电。

您的客户就是您的客户。您收取他们的付款、回答他们的问题、制定您自己的条款。他们不需要在我们这里注册账号。关于这一模式的更多信息,请参见转售页面。

设定您的价格与利润

我们的价格按号码和国家设定。您可以通过 API 实时读取:

  • GET /v1/public/countries 返回每个国家的 minPriceCents、maxPriceCents 和 availableNumbers。
  • GET /v1/public/numbers/search?country=US&limit=20 返回在售的实时号码。每个号码的 priceCents 字段就是您的价格。

API 中所有金额均以整数美元美分为单位。

您的售价等于我们对该号码的定价加上您的利润。如果一个号码的成本是 C,您的售价是 P,那么利润就是 P 减去 C。利润率是(P 减去 C)除以 P。加价率是另一个概念:(P 减去 C)除以 C。加价率总是大于利润率,所以设定目标之前请先确认您指的是哪一个。

每次销售时都从实时价格重新计算。不要使用固定价格表,因为不同国家的价格可能变化。没有经销商折扣或阶梯定价:您以正常价格购买,与定价页面上展示的价格相同。

请将以下成本也纳入预算:

  • 最终购买。 号码一经发放即为最终状态,不可退款,即使平台拒绝了该号码。
  • 平台的决定。 是否接受某个号码由平台决定,而非我们。请让您的客户先确认号码对其服务有效,或者将这一风险计入您的定价。
  • 自动续期。 号码每 28 天自动续期并扣费,除非您关闭自动续期。
  • 支付手续费。 您自己的支付处理商会对每笔客户付款收取费用。
  • 客服时间。 您的客户会向您提问,回答这些问题需要花费您的时间。

API 流程,逐步说明

基础 URL 是 https://api.sms-activate.app/v1/public。每个调用(包括目录)都需要在 Authorization: Bearer vpn_xxx 请求头中携带您的密钥。

  • 列出国家。 调用 GET /countries 查看哪些国家有号码及其价格范围。
  • 查找号码。 调用 GET /numbers/search?country=US&limit=20 列出某个国家的实时号码,每个号码的 priceCents 即您的价格。
  • 购买号码。 调用 POST /numbers,请求体为 JSON:{"phone": "+15551234567", "country": "US"},并设置 Idempotency-Key 请求头为一个 UUID。重试时再次发送同一个密钥,就不会重复扣费。购买成功返回 201,包含号码、chargedCents 和 balanceAfterCents。有两个可选字段:autoRenew(默认为 true)和 note。使用 note 存储您的客户标识。
  • 读取验证码。 调用 GET /numbers/{id}/sms 获取单个号码的短信,或调用 GET /sms 获取所有号码的短信。两者均支持游标分页。如需让验证码主动推送给您,调用 PATCH /numbers/{id} 并发送 {"forwardWebhookUrl": "https://your-app.example.com/sms"}:之后该号码收到的每条短信和每个来电都会推送到您的服务器,并带有 HMAC-SHA256 签名。在展示验证码之前,请先将其匹配到正确的客户。
  • 管理有效期。 如果客户不再续期,调用 PATCH /numbers/{id} 并发送 {"autoRenew": false}。要释放不再需要的号码,调用 DELETE /numbers/{id}。

另外两个接口有助于对账。GET /balance 返回您的余额(美分)。GET /v1/me/transactions 列出您的账单明细。

错误统一为一种格式:{"error": "<code>", "message": "...", "reqId": "..."}。请根据 error 代码分支处理,而非 HTTP 状态码。某些拒绝(如 insufficientbalance、nonumbers 和 priceexceeded)本身就是回答。请将它们展示给您的客户,而非盲目重试。遇到 ratelimited 时,请按 Retry-After 响应头给出的时间等待。

完整规范见 OpenAPI 文件,API 文档对每个接口都有说明。

账单:您在我们这里的余额

您的购买从账户余额中扣除。在网站上,您可以用加密货币(USDT)充值。Telegram 机器人还接受卢布银行卡和 Telegram Stars。绑定账户后,两者共用一个余额。

在您的高峰时段之前,请确保余额充足。余额不足时,购买请求会被拒绝并返回 insufficient_balance,您的客户需要等待您充值。

提现仅以 USDT(TRON、BSC 或 TON)支付。您可在本站账户或 Telegram 机器人中自行提现:每天 100 美元以内自动支付,几分钟内到账;超出部分由客服根据申请人工支付。通过银行卡支付、作为奖励获得或通过转移收到的资金,到账 180 天后方可提现;加密货币充值可立即提现。最低提现金额为 10 美元。手续费为提现金额的 10%,但不低于 5 USDT,从提现金额中扣除。

您自己的购买与合作伙伴计划

您自己账户上的购买,或您控制的任何账户上的购买,均不产生合作伙伴佣金。

有些客户更愿意拥有自己的账户。请将您的合作伙伴链接发送给他们。之后,只要他们的账户存在,您就可以获得他们购买和续费所产生的我们利润的 10% 至 30%(不是价格的百分比);比例随您带来的用户中已购买的人数提高,从前 3 位购买者的 10% 到第 3001 位起的 30%。每笔佣金在购买后 30 天计入您的余额。详情见联盟计划和转售商页面。

支持

您的客户联系您,您联系我们。真人会通过 support@sms-activate.app 或 Telegram(t.me/BestVoipTelegram)回复,通常在 24 小时内。

请不要向您的客户承诺超出我们对您承诺的内容。我们不承诺每条验证码都能送达,也不承诺某个平台会接受某个号码。大多数验证码在平台发送后几分钟内到达。请告知您的客户在使用某个号码之前先测试它是否适用于他们的服务。

实用视频

关于定价、Telegram 机器人和 API 设计的第三方视频。它们讲解通用技巧,不涉及我们的服务。

开始

  • 在注册页面创建一个免费账户。
  • 在账户面板的 API 密钥选项卡中创建一个 API 密钥。
  • 阅读 API 文档和 OpenAPI 文件。
  • 在价格页面查看实时价格。
  • 在开始销售之前,先购买一个号码并端到端测试您的流程。