Tentang API Digiflazz

Digiflazz menyediakan API (Application Programming Interface) untuk memudahkan developer mengintegrasikan layanan pulsa, paket data, PLN, e-wallet, dan produk digital lainnya ke dalam:

• Website PPOB
• Aplikasi Android/iOS
• Sistem BUMDes
• ERP / Sistem Keuangan
• Website Desa

API Digiflazz berbasis HTTP + JSON, sehingga mudah digunakan dengan berbagai bahasa pemrograman seperti PHP, Python, NodeJS, dll.

🔑 1️⃣ Mendapatkan API Key

Sebelum integrasi, Anda harus:

1. Login ke akun Digiflazz
2. Masuk ke menu Setting → API
3. Salin:

• 🔐 Username
• 🔐 API Key (Production)

⚠ Simpan API Key dengan aman dan jangan dibagikan ke publik.

🌐 2️⃣ Endpoint API Digiflazz

Base URL Production:

https://api.digiflazz.com/v1/

Semua request menggunakan metode:

POST

Dengan format:

Content-Type: application/json

📦 3️⃣ Struktur Dasar Request

Semua request membutuhkan:

• username
• sign
• body

Cara Membuat SIGN (Penting!)

sign = md5(username + api_key + ref_id)

Contoh di PHP:

$sign = md5($username.$api_key.$ref_id);

📋 4️⃣ Contoh Cek Daftar Produk

Endpoint:

https://api.digiflazz.com/v1/price-list

Contoh PHP:

<?php

$username = "USERNAME_ANDA";
$api_key  = "API_KEY_ANDA";
$sign     = md5($username.$api_key."pricelist");

$data = [
    "cmd" => "prepaid",
    "username" => $username,
    "sign" => $sign
];

$ch = curl_init("https://api.digiflazz.com/v1/price-list");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
curl_setopt($ch, CURLOPT_HTTPHEADER, ["Content-Type: application/json"]);

$response = curl_exec($ch);
curl_close($ch);

echo $response;

💳 5️⃣ Contoh Transaksi Pulsa

Endpoint:

https://api.digiflazz.com/v1/transaction

Contoh PHP:

<?php

$username = "USERNAME_ANDA";
$api_key  = "API_KEY_ANDA";
$ref_id   = "INV001"; // unik
$sign     = md5($username.$api_key.$ref_id);

$data = [
    "username" => $username,
    "buyer_sku_code" => "XL10", // kode produk
    "customer_no" => "08123456789",
    "ref_id" => $ref_id,
    "sign" => $sign
];

$ch = curl_init("https://api.digiflazz.com/v1/transaction");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
curl_setopt($ch, CURLOPT_HTTPHEADER, ["Content-Type: application/json"]);

$response = curl_exec($ch);
curl_close($ch);

echo $response;

🔄 6️⃣ Cek Status Transaksi

Gunakan endpoint yang sama /transaction dengan ref_id yang sama.

$data = [
    "username" => $username,
    "buyer_sku_code" => "",
    "customer_no" => "",
    "ref_id" => $ref_id,
    "sign" => $sign
];

📊 7️⃣ Response API (Contoh)

{
  "data": {
    "ref_id": "INV001",
    "status": "Sukses",
    "price": 10500,
    "message": "Transaksi berhasil"
  }
}

Status yang mungkin muncul:

• Pending
• Sukses
• Gagal

🛡️ Best Practice Keamanan

✅ Simpan API key di file config (jangan di frontend)

✅ Gunakan HTTPS

✅ Validasi saldo sebelum transaksi

✅ Gunakan ref_id unik

✅ Log semua transaksi ke database

🏗️ Skema Integrasi ke Sistem Anda

Alur Umum:

1. User pilih produk
2. Sistem cek saldo internal
3. Generate ref_id unik
4. Kirim request ke Digiflazz
5. Simpan response
6. Update status transaksi

🚀 Bisa Dikembangkan Menjadi

• Website PPOB otomatis
• Sistem konter pulsa online
• Aplikasi Android PPOB
• Sistem BUMDes Digital
• Website Desa + Payment