Documentation de l'API

Votre clé API

Tester l'API

Sélectionnez une action, remplissez les paramètres et envoyez une requête. Lorsque vous êtes connecté, votre clé API est chargée automatiquement.

curl -X POST "https://hstockplus.net/api/v2" \
  --data-urlencode "key=YOUR_API_KEY" \
  --data-urlencode "action=categories"

Point de terminaison API

Toutes les requêtes API doivent être envoyées via HTTP POST à ce point de terminaison.

Limites de débit

Limite par clé API ; seules les deux actions de liste ci-dessous sont limitées.

A limited call still returns HTTP 200, with the error below. retry_after_ms is how many milliseconds to wait before the next call. A key that keeps calling while limited (about 20 limited calls in one minute) is paused for 60 seconds.

{"error": "Rate limit exceeded", "retry_after_ms": 1400}

To check price and stock of many products, call products once with productIds (up to 100 per call) instead of one services call per product. For the stock of each option of one product, use inventory.

Langue optionnelle (lang)

Optionnel. Code de langue cible. Utilisez l'un des codes pris en charge listés ci-dessous. Lorsqu'il est défini et différent de en, les champs traduisibles sont renvoyés dans cette langue. Si une traduction n'est pas encore disponible, l'API renvoie l'anglais.

Pris en charge sur les actions de lecture : categories, subcategory_info, services, products, inventory ((noms des sous-produits)), sms_projects, et sms_countries. Omettez lang ou utilisez en pour l'anglais.

Les paramètres de filtre catégorie et sous-catégorie sur les services/produits utilisent toujours les noms canoniques en anglais, même lorsque lang est défini.

curl -X POST https://hstockplus.net/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=services" \
  -d "lang=zh"

Obtenir les Catégories

Obtenez toutes les catégories et les sous-catégories de chaque catégorie. Utilisez ces valeurs pour filtrer la Liste des Services par catégorie ou sous-catégorie.

Exemple de demande :

curl -X POST https://hstockplus.net/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=categories" \
  -d "lang=zh"

Exemple de réponse :

{
  "categories": [
    {
      "category": "Instagram",
      "subcategories": ["Followers", "Comments", "Likes"]
    },
    {
      "category": "Email Accounts",
      "subcategories": ["Gmail", "Outlook"]
    }
  ]
}

Infos de la sous-catégorie

Obtenez les détails d'une sous-catégorie par subcategoryId, y compris la catégorie parente. Utilisez subcategoryId des lignes Products List.

Exemple de demande :

curl -X POST https://hstockplus.net/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=subcategory_info" \
  -d "subcategoryId=674a1f77bcf86cd799439099" \
  -d "lang=zh"

Exemple de réponse :

{
  "subcategoryId": "674a1f77bcf86cd799439099",
  "name": "Gmail",
  "slug": "gmail",
  "imageUrl": "https://cdn.hstockplus.org/uploads/subcategories/gmail.webp",
  "description": "Verified Gmail accounts",
  "category": {
    "categoryId": "674a1f77bcf86cd799439088",
    "name": "Email Accounts",
    "slug": "email-accounts"
  }
}

Liste des Boutiques

Liste les boutiques actives avec les informations de base, le nombre de produits et les évaluations. Les noms des boutiques sont masqués pour la confidentialité.

Exemple de demande :

curl -X POST https://hstockplus.net/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=shops"

Avec pagination :

curl -X POST https://hstockplus.net/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=shops" \
  -d "page=1" \
  -d "limit=20"

Liste des coupons

Liste les codes coupon de toutes les boutiques utilisables dès maintenant, avec les conditions requises pour chacun. Transmettez un code comme coupon à action=add. Les codes créés uniquement pour votre compte (par exemple un devis de prix de gros issu d'un ticket) sont inclus et marqués private.

Exemple de demande :

curl -X POST https://hstockplus.net/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=coupons"

Exemple de réponse :

{
  "coupons": [
    {
      "code": "SAVE10",
      "type": "percentage",
      "value": 10,
      "shopId": "6650a1f77bcf86cd79943901",
      "shopSlug": "example-shop",
      "shopName": "Example Shop",
      "appliesTo": "shop",
      "minPurchase": 20,
      "remainingUses": 87,
      "expiresAt": "2026-11-30T23:59:59.000Z"
    },
    {
      "code": "BULK500",
      "type": "percentage",
      "value": 5,
      "shopId": "6650a1f77bcf86cd79943901",
      "shopSlug": "example-shop",
      "shopName": "Example Shop",
      "appliesTo": "services",
      "services": [110469, 110470],
      "minQuantity": 100,
      "quantityTiers": [
        { "minQuantity": 100, "value": 5 },
        { "minQuantity": 500, "value": 12 }
      ],
      "maxUsesPerUser": 1,
      "remainingUses": 40
    }
  ],
  "total": 2
}

Un coupon est déduit du montant restant après votre remise revendeur. Les champs facultatifs sont omis lorsque le coupon n'a pas de condition correspondante.

Liste des Produits

Listez uniquement les produits de la marketplace (pas de services SMM). Mêmes champs que les lignes de produits dans la liste des services, y compris id (identifiant d'entité produit), service (numéro de service convivial), description et imageUrl. productIds (facultatif) ne renvoie que ces produits (numéros de service conviviaux de la liste et/ou identifiants d'entité produit, séparés par des virgules ou en tableau JSON, max 100). sort=sold (facultatif) trie les résultats par unités de commande payées décroissantes (meilleures ventes en premier).

Exemple de demande :

curl -X POST https://hstockplus.net/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=products"

Filtrer par identifiants de produits :

curl -X POST https://hstockplus.net/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=products" \
  -d "productIds=2,5,9"

Avec pagination :

curl -X POST https://hstockplus.net/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=products" \
  -d "page=1" \
  -d "limit=50"

Filtrer par catégorie ou sous-catégorie :

curl -X POST https://hstockplus.net/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=products" \
  -d "category=Accounts-Email"
# Or filter by subcategory:
curl -X POST https://hstockplus.net/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=products" \
  -d "subcategory=Gmail"

Meilleures ventes dans une sous-catégorie :

curl -X POST https://hstockplus.net/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=products" \
  -d "subcategory=Twitter/X" \
  -d "sort=sold" \
  -d "page=1" \
  -d "limit=10"

Produits recommandés uniquement :

curl -X POST https://hstockplus.net/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=products" \
  -d "isRecommended=true"

Liste des services

Obtenez tous les services disponibles avec pagination optionnelle. Chaque ligne comprend l'id (identifiant de l'entité), le service (numéro de service convivial), le stock et le type d'entité (smm ou product). Le paramètre optionnel entityType ne renvoie que les lignes product ou smm. Les paramètres optionnels category et subcategory ne renvoient que les services de cette catégorie ou sous-catégorie (valeurs issues de l'API Get Categories). Le paramètre optionnel shopId ne renvoie que les produits et services de cette boutique (utilisez shopId depuis la liste des boutiques). Le paramètre optionnel productIds ne renvoie que les lignes correspondantes (numéros de service conviviaux et/ou identifiants d'entité ; correspond aux lignes product ou smm). Utilisez action=products pour filtrer uniquement les produits.

Exemple de demande :

curl -X POST https://hstockplus.net/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=services" \
  -d "lang=zh"

Avec pagination :

curl -X POST https://hstockplus.net/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=services" \
  -d "page=1" \
  -d "limit=50"

Filtrer par catégorie ou sous-catégorie :

curl -X POST https://hstockplus.net/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=services" \
  -d "category=Instagram"
# Or filter by subcategory:
curl -X POST https://hstockplus.net/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=services" \
  -d "subcategory=Followers"

Filtrer par type d'entité :

curl -X POST https://hstockplus.net/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=services" \
  -d "entityType=product"

Exemple de réponse :

{
  "services": [
    {
      "id": "507f1f77bcf86cd799439011",
      "service": 1,
      "name": "Instagram Followers",
      "type": "Default",
      "category": "Instagram",
      "rate": "0.50",
      "min": 100,
      "max": 10000,
      "refill": true,
      "cancel": false,
      "stock": 10000,
      "entityType": "smm",
      "autoDelivery": true
    },
    {
      "id": "507f1f77bcf86cd799439012",
      "service": 2,
      "name": "Gmail Account - USA",
      "type": "Default",
      "category": "Accounts-Email",
      "rate": "25.00",
      "min": 1,
      "max": 50,
      "refill": false,
      "cancel": false,
      "stock": 50,
      "entityType": "product",
      "autoDelivery": true,
      "description": "Verified Gmail account with recovery email",
      "imageUrl": "https://cdn.hstockplus.org/uploads/products/gmail.webp",
      "isRecommended": true,
      "subcategoryId": "674a1f77bcf86cd799439099",
      "sold": 5300,
      "sellerRating": 4.0,
      "sellerReviewCount": 30,
      "returningBuyerRate": 0.52,
      "warrantyHours": 12
    }
  ],
  "total": 150,
  "page": 1,
  "limit": 50,
  "total_pages": 3
}

Chaque ligne inclut id (identifiant de l'entité) et service (numéro de service convivial pour les commandes), stock, entityType (smm ou product) et autoDelivery. Les lignes product incluent également description, imageUrl, isRecommended et subcategoryId. Lorsque limit est 0 ou omis, tous les services sont renvoyés et page/limit égalent le total.

Les lignes de produits contiennent aussi les chiffres affichés sur la page du produit : service est le numéro du produit (#48071 sur la page), sellerRating et sellerReviewCount sont la note en étoiles du vendeur et son nombre d'avis, returningBuyerRate est la part d'acheteurs récurrents du vendeur (0.52 = 52 %), sold est le nombre d'unités vendues, et warrantyHours est la durée du service après-vente en heures à compter de la livraison (0 = pas de service après-vente). sellerRating, sellerReviewCount et returningBuyerRate sont omis lorsque le vendeur n'a pas de note ou trop peu d'acheteurs.

Vérifier l'Inventaire

Obtient le stock actuel et la disponibilité d'un service via son ID (le même que dans la liste des services). Pour les produits de la marketplace, le JSON inclut subproducts : un tableau de variantes actives, chacune avec subproductId, name, stock (stock affiché pour cette variante) et ses propres prix et limites de commande : available, rate, min, max, et packs pour les options vendues en packs fixes.

Exemple de demande :

curl -X POST https://hstockplus.net/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=inventory" \
  -d "service=23501"

Exemple de réponse (SMM) :

{
  "service": 1,
  "stock": 10000,
  "available": true,
  "rate": "0.5000",
  "entityType": "smm",
  "autoDelivery": true
}

Exemple de réponse (produit) :

{
  "service": 23501,
  "stock": 42,
  "available": true,
  "rate": "25.0000",
  "min": 1,
  "max": 42,
  "entityType": "product",
  "autoDelivery": true,
  "subproducts": [
    { "subproductId": "674a1f77bcf86cd799439011", "name": "1 Month", "stock": 42, "available": true, "rate": "25.0000", "min": 1, "max": 42 },
    { "subproductId": "674a1f77bcf86cd799439012", "name": "3 Months", "stock": 0, "available": false, "rate": "60.0000", "min": 1, "max": 0 },
    {
      "subproductId": "674a1f77bcf86cd799439013", "name": "Pack", "stock": 500, "available": true, "rate": "0.0190", "min": 100, "max": 100,
      "packs": [
        { "quantity": 100, "price": "1.9000", "discountPercent": 5 },
        { "quantity": 500, "price": "9.0000", "discountPercent": 10 }
      ]
    }
  ],
  "warrantyHours": 24
}

La réponse inclut le tarif (par unité, même format de chaîne que la liste des services), le type d’entité (smm ou product), et la livraison automatique (true = livraison automatique, false = le fournisseur exécute manuellement). Pour les services de type produit, les valeurs min et max correspondent à la sous‑ligne principale de la liste des services ; si cette sous‑ligne ne peut pas exécuter votre commande supplémentaire, la plateforme peut sélectionner une autre sous‑ligne et facturer son prix unitaire. Le tableau subproducts liste chaque variante active avec le stock affiché ; les réponses d’inventaire SMM omettent les sous‑produits.

Chaque sous-produit a ses propres rate, min et max : c'est le prix unitaire et la plage de quantité qui s'appliquent lorsque vous transmettez ce subproductId, avant toute remise revendeur de votre compte. Pour les options vendues en packs fixes, packs liste chaque pack en stock (quantity, total price, discountPercent) et vous devez commander l'une de ces quantités ; rate, min et max décrivent alors le plus petit pack.

warrantyHours (products only) is the product's after-sales window in hours counted from delivery, the same figure as in the services list; 0 means no after-sales.

Place a standard order with link and quantity. Link: for SMM services (e.g. followers, likes) — required, use the URL to the content (e.g. Instagram post); for product orders (e.g. accounts) — optional, if empty the system uses your account email for delivery. For products with multiple options (Select Option on the website), pass subproductId (from action=inventory) to choose which option to order — otherwise the default option is used.

Exemple de demande :

curl -X POST https://hstockplus.net/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=add" \
  -d "service=1" \
  -d "link=https://instagram.com/username" \
  -d "quantity=1000"

# Product with multiple options: pick the subproductId from action=inventory
curl -X POST https://hstockplus.net/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=add" \
  -d "service=110469" \
  -d "quantity=1" \
  -d "subproductId=674a1f77bcf86cd799439012"

# With a coupon code from action=coupons
curl -X POST https://hstockplus.net/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=add" \
  -d "service=110469" \
  -d "quantity=10" \
  -d "coupon=SAVE10"

Exemple de réponse :

{
  "order": 23501,
  "entityType": "product",
  "charge": "22.5000",
  "couponDiscount": "2.5000",
  "warrantyHours": 24
}

charge is what was taken from your balance. couponDiscount is present only when a coupon was applied. warrantyHours (products only) is the after-sales window in hours counted from delivery, 0 = no after-sales; action=status returns the exact end time as warranty_expires_at.

Statut de la commande

Obtenir le statut d'une commande.

Exemple de demande :

curl -X POST https://hstockplus.net/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=status" \
  -d "order=23501"

Exemple de réponse :

{
  "status": "In progress",
  "charge": "5.00",
  "start_count": 1000,
  "remains": 500,
  "currency": "USD",
  "autoDelivery": true
}

Pour les commandes de produits (ex. comptes), lorsque la commande est livrée en totalité ou partiellement, la réponse inclut un tableau "accounts" avec les identifiants des comptes livrés (une chaîne de caractères par compte). Pour une livraison partielle, seuls les comptes livrés jusqu'à présent sont renvoyés.

autoDelivery : true si la commande est exécutée automatiquement (par exemple, SMM, produits auto/inventaire) ; false si le fournisseur doit exécuter manuellement (peut prendre du temps).

Exemple de Réponse (commande de produit avec comptes livrés) :

{
  "status": "Completed",
  "charge": "10.00",
  "start_count": 5,
  "remains": 0,
  "currency": "USD",
  "entityType": "product",
  "autoDelivery": true,
  "accounts": [
    "user1:pass1",
    "user2:pass2"
  ]
}

Statuts possibles :

Une commande remboursée renvoie Canceled, et une commande partiellement remboursée renvoie Partial. Si une somme a été remboursée, la réponse contient aussi « refunded » avec le montant remboursé en USD.

Exemple de réponse (commande de produit livrée sous forme de fichiers) :

Certains produits (par exemple les comptes Telegram avec archives de session) sont livrés sous forme de fichiers ZIP à la place des identifiants texte, ou en plus de ceux-ci. La réponse contient alors un tableau « files ». Chaque fichier est un élément livré. Téléchargez un fichier avec action=order_file.

{
  "status": "Completed",
  "charge": "12.00",
  "start_count": 0,
  "remains": 0,
  "currency": "USD",
  "entityType": "product",
  "autoDelivery": false,
  "files": [
    {
      "id": "66e6b2f0c3a1d2e4f5a6b7c8",
      "name": "sessions-001.zip",
      "size": 482113,
      "uploaded_at": "2026-09-15T08:30:00.000Z"
    }
  ]
}

Télécharger le fichier de la commande

Télécharge un fichier de livraison (ZIP) de votre commande. En cas de succès, le corps de la réponse est le fichier lui-même (Content-Type: application/zip) ; en cas d'échec, c'est un JSON avec un champ « error ».

Exemple de demande :

curl -X POST https://hstockplus.net/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=order_file" \
  -d "order=23501" \
  -d "file=66e6b2f0c3a1d2e4f5a6b7c8" \
  -o sessions-001.zip

Exemple de réponse d'erreur :

{
  "error": "File not found"
}

Vérifiez l'en-tête Content-Type avant d'enregistrer : application/zip signifie que c'est le fichier, application/json signifie une erreur.

Annuler

Annuler une ou plusieurs commandes (format batch compatible PerfectPanel). Chaque commande éligible est remboursée sur votre solde.

Toutes les conditions suivantes doivent être remplies. Utilisez allowcancel pour vérifier l'éligibilité sans effectuer de remboursement.

• Annulation anticipée : fonctionnalité de la plateforme activée (paramètre administrateur).
• Annulation anticipée : productType est manuel, automatique ou inventaire (les services SMM automatiques utilisent généralement productType auto).
• Annulation anticipée : le statut du paiement est terminé ou partiel.
• Annulation anticipée : le statut de la commande est en attente, en cours de traitement ou en erreur (les erreurs du fournisseur apparaissent comme en cours).
• Annulation anticipée : pas de external_id (commande non encore envoyée à un fournisseur ou prestataire externe).
• Annulation anticipée : au moins N minutes depuis la fin du paiement (auto_order_early_refund_minutes, par défaut 30).
• Annulation anticipée : aucun auto-remboursement anticipé déjà utilisé sur cette commande
• Annulation anticipée : la commande n'est pas entièrement livrée (une livraison partielle donne lieu à un remboursement proportionnel pour la partie non livrée).
• Annulation anticipée : un montant remboursable reste disponible (le montant remboursé est inférieur au total de la commande).
• Annulation anticipée : aucun litige actif sur la commande.
• Annulation anticipée : aucun retrait du fournisseur en statut demandé ou terminé.

Une livraison partielle donne lieu à un remboursement partiel proportionnel ; les comptes livrés sont conservés.

Exemple de demande :

curl -X POST https://hstockplus.net/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=cancel" \
  -d "orders=23501,23502"

Exemple de réponse :

[
  {
    "order": 23501,
    "cancel": 1
  },
  {
    "order": 23502,
    "cancel": {
      "error": "Incorrect order ID"
    }
  }
]

Autoriser l'annulation

Vérifiez si une ou plusieurs commandes peuvent être annulées immédiatement (mêmes règles d'éligibilité que pour l'annulation, mais aucun remboursement n'est traité). Utilisez cette fonction avant d'appeler l'annulation pour éviter des requêtes échouées. Prend en charge les identifiants de commandes groupés (séparés par des virgules, jusqu'à 100).

Toutes les conditions suivantes doivent être remplies. Utilisez allowcancel pour vérifier l'éligibilité sans effectuer de remboursement.

• Annulation anticipée : fonctionnalité de la plateforme activée (paramètre administrateur).
• Annulation anticipée : productType est manuel, automatique ou inventaire (les services SMM automatiques utilisent généralement productType auto).
• Annulation anticipée : le statut du paiement est terminé ou partiel.
• Annulation anticipée : le statut de la commande est en attente, en cours de traitement ou en erreur (les erreurs du fournisseur apparaissent comme en cours).
• Annulation anticipée : pas de external_id (commande non encore envoyée à un fournisseur ou prestataire externe).
• Annulation anticipée : au moins N minutes depuis la fin du paiement (auto_order_early_refund_minutes, par défaut 30).
• Annulation anticipée : aucun auto-remboursement anticipé déjà utilisé sur cette commande
• Annulation anticipée : la commande n'est pas entièrement livrée (une livraison partielle donne lieu à un remboursement proportionnel pour la partie non livrée).
• Annulation anticipée : un montant remboursable reste disponible (le montant remboursé est inférieur au total de la commande).
• Annulation anticipée : aucun litige actif sur la commande.
• Annulation anticipée : aucun retrait du fournisseur en statut demandé ou terminé.

Lorsque allowcancel est à 1, la réponse inclut refundAmount (le montant que l'annulation rembourserait).

Exemple de demande :

curl -X POST https://hstockplus.net/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=allowcancel" \
  -d "orders=23501,23502"

Exemple de réponse :

[
  {
    "order": 23501,
    "allowcancel": 1,
    "refundAmount": 5.00
  },
  {
    "order": 23502,
    "allowcancel": 0,
    "error": "Early auto refund is not available for this order",
    "reason": "BEFORE_MIN_WAIT",
    "eligibleAfter": "2026-06-23T12:30:00.000Z"
  }
]

Solde

Obtenez votre solde actuel.

Exemple de demande :

curl -X POST https://hstockplus.net/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=balance"

Exemple de réponse :

{
  "balance": "100.00",
  "currency": "USD"
}

Orders Summary

Order count and totals for a date range, for reconciliation. Counts the same orders as the Your orders page.

Exemple de demande :

curl -X POST https://hstockplus.net/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=orders_summary" \
  -d "date_from=2026-10-31" \
  -d "date_to=2026-10-31" \
  -d "tz=480"

Exemple de réponse :

{
  "date_from": "2026-10-30T16:00:00.000Z",
  "date_to": "2026-10-31T16:00:00.000Z",
  "orders": 126,
  "refunded_orders": 3,
  "gross": "412.5000",
  "refunded": "6.2000",
  "net": "406.3000",
  "currency": "USD"
}

date_from and date_to echo the range as UTC instants (date_to is exclusive). Only paid orders are counted; unpaid and failed orders are ignored. orders is the number of paid orders, gross is what you paid, refunded is what came back to you, net = gross - refunded. Call at most once every 2 seconds.

API de vérification par SMS

Points de terminaison dédiés pour les services de vérification par SMS.

Les commandes SMS ont leurs propres ID de commande. Utilisez sms_code, sms_status et sms_cancel avec elles ; status, cancel et allowcancel sont réservés aux commandes de produits et SMM.

[
  {
    "project_id": "65f...",
    "name": "OpenAI / ChatGPT",
    "price": "0.5000",
    "country_id": "us",
    "country_title": "United States"
  }
]

[
  {
    "country_code": "+1",
    "country_name": "United States"
  },
  {
    "country_code": "+44",
    "country_name": "United Kingdom"
  }
]

{
  "orders": [
    {
      "order": 12345,
      "phone": "4055123415",
      "dial_code": "+1",
      "phone_full": "+14055123415",
      "country": "US",
      "expires_at": "2026-01-01T12:15:00.000Z",
      "status": "active"
    }
  ]
}

{
  "status": "completed",
  "code": "123456",
  "sms_content": "Your verification code is 123456"
}
// OR
{
  "status": "waiting",
  "message": "Waiting for code"
}
// OR, once expires_at has passed without a code (call sms_cancel for a refund)
{
  "status": "expired",
  "message": "No code arrived before the number expired. Call action=sms_cancel for a refund."
}

{
  "status": "code_received",
  "phone": "4055123415",
  "dial_code": "+1",
  "phone_full": "+14055123415",
  "code": "123456",
  "charge": "0.5000",
  "currency": "USD",
  "refunded": false,
  "expires_at": "2026-01-01T12:15:00.000Z"
}
// status: phone_acquired | code_received | expired | released

{
  "order": 12345,
  "status": "cancelled",
  "refunded": true,
  "refund_amount": "0.5000",
  "currency": "USD"
}
// OR
{
  "error": "Verification code already received, cannot release"
}

Réponses d'erreur

Réponses d'erreur courantes que vous pouvez rencontrer.