Automate one-time OTP activations, long-term rentals, live SSE status streaming, and HMAC-SHA256 webhooks with zero balance risk in Sandbox mode.
| Scope | Permissions granted |
|---|---|
orders:read | List orders, inspect order status, export CSV, and open SSE streams. |
orders:write | Create single or batch activations, edit notes, finish, cancel, and save presets. |
rentals:read | List your rented numbers and poll rental SMS inbox messages. |
rentals:write | Purchase, extend, configure auto-renew, and refund eligible rentals. |
balance:read | Read wallet balance and account profile on /me. |
curl -X POST "https://api.voipstore.xyz/orders" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-H "X-Sandbox: true" \
-d '{"service_id": 12, "country_id": 79, "operator": "any"}'Supported webhook events
sms.receivedFired immediately when an SMS code arrives on an activation.
rental.expiring_soonProactive alert 24 hours before an active rental expires.
rental.auto_renewedSent when automatic rental renewal completes and extends expiry.
rental.auto_renew_failedSent when automatic renewal pauses due to low balance or upstream decline.
import crypto from "node:crypto";
export function verifyVoipStoreSignature(secret, timestamp, rawBody, headerSig) {
const expected = "sha256=" + crypto
.createHmac("sha256", secret)
.update(`${timestamp}.${rawBody}`)
.digest("hex");
return crypto.timingSafeEqual(Buffer.from(expected), Buffer.from(headerSig));
}