Dokumentasi API Server2

Dokumentasi ini khusus untuk integrasi API OTP menggunakan sistem Server2. Semua endpoint di sini telah dienkapsulasi dan diotomatisasi. Anda wajib menggunakan API Key yang ada di menu Profil Anda untuk mencoba Cek Harga, Order, maupun Cek Status.

Base URL API Endpoint

https:/gateotp.com/api/smscode

Autentikasi (WAJIB!)

Setiap Request API memerlukan otentikasi melalui headers.

Parameter	Tipe	Lokasi	Diperlukan	Deskripsi
x-api-key	string	headers	Ya	Kunci API Anda (Contoh: `wn-123xyz...`)

Simpan API Key Sementara

Simpan API Key Anda di bawah ini agar otomatis terisi ke semua form "Try Endpoint" dan contoh kode di halaman ini.

1. Daftar Layanan

Mengambil daftar seluruh layanan aplikasi (seperti WhatsApp, Telegram, Instagram) yang didukung dan sedang aktif.

GET /api/smscode/services

API Tester

API Key (Header)

Contoh Kode Integrasi:

Contoh Response (Success):

Status: 200 OK

{
  "success": true,
  "data": [
    {
      "id": 3,
      "code": "wa",
      "name": "WhatsApp",
      "active": true
    }
  ]
}

2. Daftar Negara

Mengambil daftar lengkap negara beserta ID dan Emoji benderanya.

GET /api/smscode/countries

API Tester

API Key (Header)

Contoh Kode Integrasi:

Contoh Response (Success):

Status: 200 OK

{
  "success": true,
  "data": [
    {
      "id": 6,
      "name": "Indonesia",
      "emoji": "🇮🇩",
      "active": true
    }
  ]
}

3. Server & Harga

Mendapatkan daftar server (beserta ketersediaan stok & harga) berdasarkan ID Layanan dan ID Negara.

GET /api/smscode/products

Parameter Query	Tipe	Diperlukan	Deskripsi
platform_id	number	Ya	ID Layanan (Cth: 3 untuk WhatsApp)
country_id	number	Opsional	ID Negara (Cth: 6 untuk Indonesia)

API Tester

API Key (Header)

platform_id (App ID)

country_id (Opsional)

Contoh Kode Integrasi:

Contoh Response (Success):

Status: 200 OK

{
  "success": true,
  "data": [
    {
      "id": 142,
      "name": "WhatsApp Indonesia (S1)",
      "country_id": 6,
      "platform_id": 3,
      "available": 42,
      "price": 1500,
      "active": true
    }
  ]
}

4. Order OTP Baru

Endpoint untuk mengeksekusi pembelian nomor virtual. Saldo akan otomatis terpotong dari akun Anda.

POST /api/smscode/order

Body JSON	Tipe	Diperlukan	Deskripsi
product_id	number	Ya	ID Server/Product (Contoh: 142)
app_id	number	Ya	ID Layanan/Aplikasi (Contoh: 3)
country_id	number	Ya	ID Negara (Contoh: 6)
service_name	string	Opsional	Label manual (Contoh: "WhatsApp Indo")

API Tester

API Key (Header)

product_id

app_id

country_id

service_name

Contoh Kode Integrasi:

Success Response:

Status: 200 OK

{
  "success": true,
  "data": {
    "trxId": "WN0000000001",
    "serviceName": "WhatsApp (Indonesia)",
    "phoneNumber": "628123456789",
    "amount": 1500,
    "status": "waiting",
    "createdAt": "2026-05-12T10:00:00.000Z"
  }
}

5. Cek Status OTP

Mengecek status dan kode OTP. Gunakan trxId yang didapat dari balasan saat Order OTP.

GET /api/smscode/status/:trxId

Parameter Path	Tipe	Diperlukan	Deskripsi
trxId	string	Ya	ID Trx Lokal (Cth: WN0000000001)

API Tester

API Key (Header)

trxId

Contoh Kode Integrasi:

Success Response (Saat SMS Masuk):

Status: 200 OK

{
  "success": true,
  "status": "completed",
  "otp_code": "123456"
}

6. Batalkan Order

Membatalkan pesanan yang sedang aktif. Jika berhasil (atau jika dari pusat memang sudah batal/expired), sistem akan otomatis melakukan Refund saldo Anda.

POST /api/smscode/cancel

Body JSON	Tipe	Diperlukan	Deskripsi
trxId	string	Ya	ID Trx Lokal (Cth: WN0000000001)

API Tester

API Key (Header)

trxId

Contoh Kode Integrasi:

Success Response:

Status: 200 OK

{
  "success": true,
  "message": "Berhasil dibatalkan"
}