服务运行正常 · 全球通道在线
✉ support@wacode.io✈ @wacode_support操作指南 →
v1.0 · 最后更新 2026-11-12

从取号到接入,一份就够

控制台手动接码只需三步;自动化场景直接跳到「开发者 API」。所有写操作幂等,失败自动回滚扣费。

三步接码流程

平台提供「接码资源」,不代你在目标网站完成注册。请确认目标服务支持通过 WhatsApp 通道下发验证码,再开始取号。

1

选择服务与地区

在服务目录中选定目标服务、地区与账号类型,查看实时起价、可用库存与 24h 到达率。库存为 0 或到达率不达标的服务会置灰或下架。

2

取号,拿到专属 WhatsApp 号

点击「取号」后系统会为你锁定一个专属账号并创建订单,返回号码、租期倒计时与实时订阅凭证。此时余额只是冻结,尚未实扣。

3

去目标站注册,回平台取码

在目标服务选择 WhatsApp 验证方式并填入号码。验证码到达后由平台自动识别并归属到本次订单,实时推送到控制台;也可在 API 中主动查询。

关于等待时间:平台无法观测「你在目标站点击发送验证码」的时刻,因此从取号到验证码可交付的耗时会受目标服务影响。若超时仍未收到码,订单会自动结束且不扣费,不需要你手动取消。

控制台操作详解

控制台把「当前会话」「余额与流水」「订单记录」「API Key」收在一个页面。取号后主卡片会依次展示状态流转:

状态含义界面表现资金
等待中已分配专属账号,等待验证码租期倒计时 + 接码进度更新金额已冻结
已收到验证码已到达并可查看大号验证码 + 复制按钮冻结转实扣
已使用你已确认使用支持多次接码的服务可继续接码已完成结算
已超时超时未收到码自动释放账号、提示可重试自动解冻,不扣费
申诉中已发起申诉工单状态与证据上传待复核

同一租期内多条验证码按到达时间编号升序展示,并标注对应的目标服务,不会串号或覆盖。断线重连后会按序补拉本次订单的全部历史码。

打开控制台 →

计费与失败处理

没拿到码,不扣钱

取号时按下单价冻结对应金额,只有验证码成功交付后才实际扣费;超时、账号临时不可用或服务暂不可售时,订单自动结束,冻结金额原路解冻,不产生任何扣费。重复提交同一笔请求也不会重复占号或重复扣费。

超时与申诉

订单超过设定租期(默认 15 分钟,下单时可选择 30 / 60 分钟)仍未收到验证码时会自动结束并释放账号,无需你手动取消。若你认为交付有误,可在订单中发起申诉,客服会复核本次订单与消息记录。

请留意合规边界:用途需符合目标平台服务条款及所在地法律法规。平台不接受用于欺诈、垃圾注册、绕过风控等违规场景。请确保自行确认目标服务是否允许通过第三方接码账号完成验证。

开发者 API · 概览与鉴权

RESTful、固定 /api/v1 前缀、USD 最小单位整数计价、时间统一 RFC3339。所有写操作必须携带 Idempotency-Key(24h 幂等窗口,Redis + 数据库唯一索引双保险)。

request headers
POST https://api.wacode.io/api/v1/activations X-API-Key: wacp_live_•••••••••••• Idempotency-Key: 9f2c7e10-6a4b-4d0e-9c18-7b3a5d2e1f80 Content-Type: application/json { "service_id": "openai", "country": "US", "account_type": "aged_180d", "rental_minutes": 15 }

API Key:在控制台创建,明文仅完整展示一次,之后仅显示掩码;支持 scopes、IP allowlist、限流档与即时轮换。吊销后 60 秒内生效。

核心端点

方法路径说明幂等
GET/api/v1/services服务目录(含 enabled 与 24h 到达率)—
GET/api/v1/services/{id}/stock按国家/类型的实时库存与报价矩阵—
POST/api/v1/activations取号,返回 activation_id / lease_id / ws_ticket必填
GET/api/v1/activations/{id}查询状态与历史验证码—
GET/api/v1/activations/{id}/code?wait=N取码长轮询(wait ≤ 30)—
POST/api/v1/activations/{id}/release释放账号并结算必填
POST/api/v1/activations/{id}/dispute发起申诉 / 退款复核必填
GET/api/v1/balance可用余额与冻结金额—
GET/api/v1/transactions资金流水(cursor 分页)—
GET/api/v1/usage用量计量—
WS/ws/v1/activations订阅验证码到达事件—
quickstart.py
import wacode client = wacode.Client(api_key="wacp_live_••••") # 同一幂等键重放,返回同一租用单,不会二次占号或扣费 order = client.orders.create( service="openai", region="US", lease="15m", idempotency_key="9f2c7e10-..." ) code = order.wait_for_code(timeout=120) # 长轮询 print(order.wa_number, code) # +1 415 555 0218 / "482916" # 号码仅在本订单租期内明文可复制,租期结束即释放,不跨订单复用 order.release() # 自动结算 $0.150

错误码表

HTTPcode含义 / 建议动作
400PARAM_INVALID参数不合法,检查 service_id / country
401UNAUTHENTICATEDAPI Key 缺失、无效或已吊销
402INSUFFICIENT_BALANCE余额不足,不创建租用单、不占用账号
409INSUFFICIENT_STOCK库存不足,稍后重试或换地区
409IDEMPOTENCY_CONFLICT同一幂等键参数不同,请核对请求体
410ACTIVATION_EXPIRED租期已过期,返回稳定终态不再扣费
422SERVICE_UNAVAILABLE_IN_REGION该服务/地区到达率不达标已下架,不收费
429RATE_LIMITED按 Retry-After 退避重试
503DEVICE_OFFLINE账号暂时不可用,订单已自动结束且不扣费

WebSocket 事件

连接 /ws/v1/activations 后以 ws_ticket 订阅指定 activation_id。事件即为 UI 状态来源;断线重连按到达时间升序补拉历史码。

code.ready 事件
{ "event": "code.ready", "activation_id": "act_01J8Z3K...", "code_seq": 1, "code": "482916", "service_tag": "openai", "received_at": "2026-11-12T09:41:22Z", "confidence": 0.99 } // 其他事件:订单结束 / 账号状态变更 / 订单释放

排查与常见问题

先确认目标服务确实提供 WhatsApp 验证通道,且号码填写无误。若目标站已发送但平台长时间未显示,租期到期会自动结束且不扣费,可在订单中发起申诉,我们会复核本次订单与消息记录。

部分服务支持租期内多次接码,以服务目录中的 SKU 标注为准。每条码带独立序号与服务标签,按到达时间升序展示,不会串号。账号释放后会经过安全校验再重新开放,确保不同订单之间的验证码互不干扰。

不会。所有写操作必须携带 Idempotency-Key,相同键重放返回同一结果;资金侧重复操作不会重复扣费,并设有每日账务核对,保证流水、余额与订单三者一致。

Webhook 回调面向企业套餐开放,支持 url / secret / events 配置并带失败重试。当前版本已开放的能力以控制台展示为准,企业接入可联系商务开通。

还需要帮助?

工作时间 7×24 在线,工单与即时通讯均可触达。企业客户可申请技术对接与定制 SLA。

✉ 客服邮箱

support@wacode.io

☎ 客服电话

+86 400 888 0321

✈ Telegram

@wacode_support

📍 办公地址

广东省广州市天河区科韵路 16 号 信息港 A 栋 12 层