DuniaTopUp API

Dokumentasi API Partner

API untuk reseller/partner agar bisa ambil layanan, order via saldo, cek status, dan cek saldo. Format dibuat sederhana seperti panel PPOB/topup pada umumnya.

Base URL Partner

https://103.247.8.54.nip.io/api/v1

Content-Type

application/json

Method

POST

1. Buat API Key

Admin masuk ke detail user, bagian API Partner, lalu generate API key.

2. Isi Saldo

Order API memakai saldo akun partner. Pastikan saldo cukup sebelum order.

3. Integrasi Endpoint

Gunakan endpoint service, order, status, dan saldo dengan body JSON.

Format Umum

Response Sukses

{
  "status": true,
  "msg": "berhasil",
  "data": {}
}

Response Error

{
  "status": false,
  "msg": "Incorrect API Key",
  "data": []
}

Status Order	Arti
pending	Order dibuat tapi belum diproses.
processing	Order sedang diproses ke provider.
success	Order sukses. Keterangan bisa berisi SN/token/voucher.
cancel	Order gagal atau dibatalkan.
refund	Order direfund.

Endpoint Partner

Daftar Layanan

Mengambil semua layanan aktif beserta harga partner.

POST

https://103.247.8.54.nip.io/api/v1/service

Parameter	Tipe	Wajib	Keterangan
api_key	string	Wajib	API key partner dari admin DuniaTopUp.

Request Body

{
  "api_key": "DTXXXXXXXXXXXXXXXX"
}

Success Response

{
  "status": true,
  "msg": "Berhasil Mendapatkan Data Layanan",
  "data": [
    {
      "id": "ML86",
      "item_id": "uuid-item",
      "nama_layanan": "86 Diamond",
      "kategori": "Mobile Legends",
      "kategori_grup": "Game",
      "harga": 21000,
      "status": "aktif"
    }
  ]
}

Buat Pesanan

Membuat order baru memakai saldo akun partner. Saldo langsung dipotong saat order diterima.

POST

https://103.247.8.54.nip.io/api/v1/order

Parameter	Tipe	Wajib	Keterangan
api_key	string	Wajib	API key partner.
service_id	string	Wajib	ID layanan dari endpoint service. Bisa SKU Digiflazz atau item_id UUID.
target	string	Wajib	ID tujuan. Untuk game/server gunakan format user_id\|server_id.
kontak	string	Wajib	Nomor WhatsApp/customer partner.
idtrx	string	Wajib	ID transaksi unik dari sistem partner.
callback	url	Opsional	Disimpan untuk integrasi callback lanjutan.

Request Body

{
  "api_key": "DTXXXXXXXXXXXXXXXX",
  "service_id": "ML86",
  "target": "12345678|1234",
  "kontak": "628123456789",
  "idtrx": "ORDER123456",
  "callback": "https://domainanda.com/callback"
}

Success Response

{
  "status": true,
  "msg": "Pesanan berhasil! Pesanan akan diproses",
  "data": {
    "id": "ORDER123456",
    "service_name": "86 Diamond",
    "service_id": "ML86",
    "target": "12345678|1234",
    "kontak": "628123456789",
    "keterangan": "",
    "status": "processing"
  }
}

Cek Status

Mengecek status order. Jika sukses, token/voucher/SN muncul di field keterangan.

POST

https://103.247.8.54.nip.io/api/v1/status

Parameter	Tipe	Wajib	Keterangan
api_key	string	Wajib	API key partner.
order_id	string	Wajib	ID transaksi/idtrx yang dikirim saat order.

Request Body

{
  "api_key": "DTXXXXXXXXXXXXXXXX",
  "order_id": "ORDER123456"
}

Success Response

{
  "status": true,
  "msg": "berhasil mengecek status",
  "data": {
    "id": "ORDER123456",
    "keterangan": "SN/TOKEN/VOUCHER",
    "status": "success"
  }
}

Cek Saldo

Melihat saldo akun partner yang tersedia untuk order API.

POST

https://103.247.8.54.nip.io/api/v1/saldo

Parameter	Tipe	Wajib	Keterangan
api_key	string	Wajib	API key partner.

Request Body

{
  "api_key": "DTXXXXXXXXXXXXXXXX"
}

Success Response

{
  "status": true,
  "msg": "berhasil",
  "data": {
    "saldo": 500000
  }
}

Contoh cURL

curl -X POST https://103.247.8.54.nip.io/api/v1/saldo \
  -H "Content-Type: application/json" \
  -d '{"api_key":"DTXXXXXXXXXXXXXXXX"}'