Sell virtual numbers inside your own app.

Quick start

Base address for every request:

https://pluggafrica.com/api/v1

Send your key in the Authorization header on every request:

Authorization: Bearer plg_live_your_key_here

Buy a WhatsApp number from the USA

# 1. Buy the number
curl -X POST https://pluggafrica.com/api/v1/orders \
  -H "Authorization: Bearer $PLUGG_KEY" \
  -H "Content-Type: application/json" \
  -d '{"service":"whatsapp","country":"usa"}'

# 2. Check it every 5 seconds until "code" is filled in
curl https://pluggafrica.com/api/v1/orders/ORDER_ID \
  -H "Authorization: Bearer $PLUGG_KEY"

# 3. No code? Cancel and get your money back
curl -X POST https://pluggafrica.com/api/v1/orders/ORDER_ID/cancel \
  -H "Authorization: Bearer $PLUGG_KEY"

const API = "https://pluggafrica.com/api/v1";
const H = { Authorization: "Bearer " + process.env.PLUGG_KEY, "Content-Type": "application/json" };

const buy = await (await fetch(API + "/orders", {
  method: "POST", headers: H,
  body: JSON.stringify({ service: "whatsapp", country: "usa" }),
})).json();
if (!buy.ok) throw new Error(buy.error.message);
console.log("Number:", buy.order.phone);

// check every 5 seconds for up to 15 minutes
for (let i = 0; i < 180; i++) {
  await new Promise(r => setTimeout(r, 5000));
  const o = await (await fetch(API + "/orders/" + buy.order.id, { headers: H })).json();
  if (o.order.code) { console.log("Code:", o.order.code); break; }
  if (o.order.status !== "waiting") break;
}

import os, time, requests
API = "https://pluggafrica.com/api/v1"
H = {"Authorization": "Bearer " + os.environ["PLUGG_KEY"]}

buy = requests.post(API + "/orders", headers=H, json={"service": "whatsapp", "country": "usa"}).json()
if not buy["ok"]: raise SystemExit(buy["error"]["message"])
print("Number:", buy["order"]["phone"])

for _ in range(180):  # up to 15 minutes
    time.sleep(5)
    o = requests.get(API + "/orders/" + buy["order"]["id"], headers=H).json()["order"]
    if o["code"]: print("Code:", o["code"]); break
    if o["status"] != "waiting": break

$api = "https://pluggafrica.com/api/v1";
$h = ["Authorization: Bearer " . getenv("PLUGG_KEY"), "Content-Type: application/json"];

$ch = curl_init($api . "/orders");
curl_setopt_array($ch, [CURLOPT_POST => true, CURLOPT_HTTPHEADER => $h, CURLOPT_RETURNTRANSFER => true,
  CURLOPT_POSTFIELDS => json_encode(["service" => "whatsapp", "country" => "usa"])]);
$buy = json_decode(curl_exec($ch), true);
echo "Number: " . $buy["order"]["phone"];
// then GET $api/orders/{id} every 5 seconds until ["order"]["code"] is set

Endpoints

Example answer from POST /orders

{
  "ok": true,
  "order": { "id": "912345678", "phone": "+12543410365", "service": "whatsapp",
             "country": "usa", "price_ngn": 5800, "status": "waiting", "code": null },
  "balance_ngn": 9200
}

Order status is one of waiting, received, refunded or cancelled. A number stays open for about 15 minutes. If no code arrives in that time, the money goes back to your wallet by itself.

Errors

Every error looks like {"ok":false,"error":{"code":"...","message":"..."}}. The message is safe to show to your own customers.

Questions