首页 / 国际短信
国际 / 港澳台短信

国际短信 API
把验证码发到海外用户的手机上

面向出海 App、跨境电商与独立站的验证码短信能力。覆盖 222 个国家 / 地区, 按号码归属国家单价从账户余额实时扣费,发送成功才扣、失败不扣,各国价格明码标价。

222 个
国家 / 地区
1 个接口
POST /api/sms/intl
账户余额
按国家单价扣
成功才扣
失败不扣费
curl -X POST https://jh.fzywl.cn/api/sms/intl \
  -H "Authorization: Bearer {API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{"mobile":"+93701234567","code":"1234"}'

// 返回(含归属国家与实扣金额,便于对账)
{"code":0,"msg":"success","data":{
  "call_id":321,"status":"success","deducted":true,
  "country":"阿富汗","unit_price":1.10,"charged":1.10}}

核心能力

国内短信与实名认证是「扣条数额度」,国际短信是「扣账户余额」——两种计费方式分开,互不占用。

覆盖 222 个国家/地区

号码按最长国家码前缀自动归属,跨境通道直达,各国是否可达以通道为准。

按国家单价计价

每个国家/地区一个单价,同一国家码统一价;完整价目见国际短信费率。

从账户余额扣费

与条数套餐分离:发送成功即从账户余额扣对应金额;余额不足返回 402。

申请制开通

为满足合规要求,国际短信需先提交开通申请(说明用途/目标国家),审核通过后生成 sms_intl Key。

结果可查可回调

返回 call_id 可查状态;配置回执地址后结果(含实扣金额)自动推送到你的系统。

频控与对账明细

同号频次限制 + 每次调用记录国家、单价、实扣金额,可在控制台「余额明细」逐笔核对。

适用场景

出海 App 验证码

海外用户注册、登录的验证码下发,无需自己对接各国通道。

跨境电商 / 独立站

海外买家下单验证、物流通知(通知类需符合当地法规与模板要求)。

海外账号安全

异地登录、改密等敏感操作的国际号码二次验证。

系统集成商

把国际短信能力接入自有产品,按国家单价统一结算。

计费与规格

先用「账户余额」充值,再按各国单价逐条扣——成功才扣、失败不扣。

项说明
计费方式按号码归属国家/地区单价,从账户余额扣费;发送成功才扣,失败或国家码未开通不扣
完整费率222 个国家/地区单价见 国际短信费率 页
支持范围除中国大陆以外的国际 / 港澳台号码,号码必须带国家码(如 +93701234567);国内号码请用短信服务
短信内容正文固定为平台已报备的英文验证码模板,暂不支持自定义文案
开通方式申请制:控制台「API Key → 国际短信申请」提交,审核通过后即可生成 Key
部分国家(美国、加拿大、台湾、马来西亚等)需先完成模板报备,约需 2~5 个工作日;报备完成前该国家可能暂时无法下发。下单前可先咨询客服确认目标国家是否已就绪。

四步接入

比国内短信多一步「申请开通」,其余完全一样。

注册账号
登录控制台,先完成实名认证(合规要求)。
提交开通申请
控制台「API Key → 国际短信申请」,说明用途与目标国家。
充值账户余额
国际短信从账户余额扣费,在「余额明细」充值即可。
生成 Key 并调用
生成 sms_intl 类型 Key,调用 POST /api/sms/intl。

常见问题

为什么国际短信要申请开通?
国际短信涉及跨境与当地法规,也为防止通道被滥用,因此采用申请制:提交用途与目标国家,审核通过后即可开通。
为什么扣的是「账户余额」而不是「条数额度」?
各国成本差异很大,无法用统一的「条」计价。因此国际短信按国家单价从账户余额扣费;国内短信/语音仍按条数额度扣,两者互不影响。
能自己写短信文案吗?
暂不支持。为保证跨境通道送达率与合规,正文使用平台已报备的英文验证码模板,只需传验证码本身。
支持中国大陆号码吗?
不支持。跨境通道不覆盖中国大陆,请改用国内短信服务(价格也便宜得多)。
发送失败会扣钱吗?
不会。只有上游受理成功才扣;失败、国家码未开通、触发限流等都不扣费,可在「余额明细」逐笔核对。

先看费率,再决定开通哪些国家

222 个国家/地区的单价全部公开,按国家码列出,方便你评估成本。

查看各国费率 免费注册 接口文档