REST API

Dokumentasi API Topup Game

Referensi endpoint dibuat dengan layout responsif ala Swagger. Semua contoh memakai placeholder aman dan base URL frontend agar dokumentasi tidak mengarah ke domain backend.

Base URL

https://topup.ferdiananda.web.id/api

Header umum

Accept: application/json
X-API-KEY: <api_key>

Endpoint publik

Menampilkan 5 dari 5 endpoint publik.

Autentikasi

Gunakan skema autentikasi sesuai endpoint. Jangan pernah menaruh secret atau API key asli di frontend publik.

X-API-KEY

Public REST

Dipakai untuk katalog publik, pembuatan order, detail invoice, dan polling status pembayaran.

Accept: application/json
X-API-KEY: <server-api-key>

Format sukses

{
  "success": true,
  "message": "Request berhasil.",
  "data": {}
}

Format error

{
  "success": false,
  "message": "Validasi gagal.",
  "error_code": "VALIDATION_ERROR",
  "errors": {}
}

Response JSON

Semua endpoint direkomendasikan mengirim header Accept: application/json agar response error maupun sukses konsisten.

Katalog Publik

Endpoint untuk membaca daftar game dan route detail game yang tersedia untuk publik.

Request

URL lengkap

https://topup.ferdiananda.web.id/api/games

Header

Nama	Tipe	Wajib	Deskripsi	Contoh
Accept	string	Ya	Gunakan application/json agar response selalu dikembalikan dalam format JSON.	application/json
X-API-KEY	string	Ya	API key publik yang diverifikasi oleh ApiKeyMiddleware untuk seluruh route public API.	server-api-key

Contoh request

curl -X GET 'https://topup.ferdiananda.web.id/api/games' \
  -H 'Accept: application/json' \
  -H 'X-API-KEY: <server-api-key>'

Response

Status code

200

Daftar game berhasil dibaca

401

X-API-KEY tidak valid atau tidak dikirim

Contoh response sukses

{
  "success": true,
  "games": [
    {
      "id": 11,
      "image": "https://topup.ferdiananda.web.id/storage/games/mobile-legends.jpg",
      "banner": "https://topup.ferdiananda.web.id/storage/banner/mobile-legends-banner.jpg",
      "title": "Mobile Legends",
      "developers": "Moonton",
      "brand": "MLBB",
      "category_id": 1,
      "slug": "mobile-legends",
      "description": "Top up diamond Mobile Legends.",
      "status": true,
      "populer": true,
      "sort": 1,
      "category": {
        "id": 1,
        "title": "MOBA"
      }
    }
  ],
  "populerGames": [
    {
      "id": 11,
      "image": "https://topup.ferdiananda.web.id/storage/games/mobile-legends.jpg",
      "banner": "https://topup.ferdiananda.web.id/storage/banner/mobile-legends-banner.jpg",
      "title": "Mobile Legends",
      "developers": "Moonton",
      "brand": "MLBB",
      "category_id": 1,
      "slug": "mobile-legends",
      "description": "Top up diamond Mobile Legends.",
      "status": true,
      "populer": true,
      "sort": 1
    }
  ]
}

Contoh response error

Unauthorized

401

{
  "message": "Unauthorized"
}

Order & Invoice

Endpoint untuk membuat transaksi dan memantau invoice pembayaran.

Request

URL lengkap

https://topup.ferdiananda.web.id/api/order

Header

Nama	Tipe	Wajib	Deskripsi	Contoh
Accept	string	Ya	Gunakan application/json agar response selalu dikembalikan dalam format JSON.	application/json
X-API-KEY	string	Ya	API key publik yang diverifikasi oleh ApiKeyMiddleware untuk seluruh route public API.	server-api-key

Body request

Nama	Tipe	Wajib	Deskripsi	Contoh
id	string	Ya	User ID atau game ID target transaksi.	12345678
server	string	Tidak	Server ID bila game memerlukannya.	2012
game	string	Ya	Slug game yang aktif.	mobile-legends
product_id	integer	Ya	ID produk yang dipilih.	901
payment_method_id	integer	Ya	ID metode pembayaran yang dipilih.	12
email	string	Tidak	Email pemesan.	[email protected]
whatsapp	string	Ya	Nomor WhatsApp pemesan.	081234567890
nickname	string	Tidak	Nickname game bila tersedia.	FerdiML
promo_code	string	Tidak	Kode promo yang ingin diterapkan.	RAMADAN10
quantity	integer	Tidak	Jumlah item. Default 1.	2

Catatan implementasi

Field game harus berisi slug game aktif, bukan title game.
Gunakan orderId pada response untuk membuka detail invoice dan polling status pembayaran.
Jika payload dasar tidak valid, Laravel validation akan mengembalikan response 422 dengan field message dan errors.

Contoh request

curl -X POST 'https://topup.ferdiananda.web.id/api/order' \
  -H 'Accept: application/json' \
  -H 'X-API-KEY: <server-api-key>' \
  -H 'Content-Type: application/json' \
  -d '{"id":"12345678","server":"2012","game":"mobile-legends","product_id":901,"payment_method_id":12,"email":"[email protected]","whatsapp":"081234567890","nickname":"FerdiML","promo_code":"RAMADAN10","quantity":2}'

Response

Status code

201

Order berhasil dibuat

404

Game, produk, atau metode pembayaran tidak ditemukan

422

Produk tidak sesuai game, promo tidak valid, atau payload tidak lolos validasi

500

Gagal membuat transaksi pembayaran atau menyimpan order

Contoh response sukses

{
  "success": true,
  "message": "Pesanan berhasil dibuat.",
  "orderId": "INV-20260329093000-ABCDEFGH",
  "data": {
    "order_id": "INV-20260329093000-ABCDEFGH",
    "payment_status": "UNPAID",
    "buy_status": "Pending",
    "payment_url": "https://gateway.example/pay/INV-20260329093000-ABCDEFGH",
    "payment_code": "INV-20260329093000-ABCDEFGH",
    "payment_reference": "INV-20260329093000-ABCDEFGH",
    "qr_url": null,
    "expired_at": "2026-03-29T10:00:00+07:00",
    "quantity": 2,
    "total_price": 40000,
    "pricing": {
      "quantity": 2,
      "has_promo": true,
      "promo_code": "RAMADAN10",
      "unit_price_before_promo": 22000,
      "unit_discount": 2000,
      "unit_price_after_promo": 20000,
      "subtotal_before_promo": 44000,
      "promo_discount": 4000,
      "subtotal_after_promo": 40000,
      "payment_fee": 0,
      "unique_code": 0,
      "total_price": 40000
    }
  }
}

Contoh response error

Produk tidak sesuai game

422

{
  "success": false,
  "message": "Produk tidak sesuai dengan game yang dipilih."
}

Validasi payload gagal

422

{
  "message": "The id field is required. (and 2 more errors)",
  "errors": {
    "id": [
      "The id field is required."
    ],
    "game": [
      "The game field is required."
    ],
    "whatsapp": [
      "The whatsapp field is required."
    ]
  }
}

Nama

Tipe

Wajib

Deskripsi

Contoh

string

Gunakan application/json agar response selalu dikembalikan dalam format JSON.

application/json

X-API-KEY

string

API key publik yang diverifikasi oleh ApiKeyMiddleware untuk seluruh route public API.

server-api-key

{ "success": true, "games": [ { "id": 11, "image": "https://topup.ferdiananda.web.id/storage/games/mobile-legends.jpg", "banner": "https://topup.ferdiananda.web.id/storage/banner/mobile-legends-banner.jpg", "title": "Mobile Legends", "developers": "Moonton", "brand": "MLBB", "category_id": 1, "slug": "mobile-legends", "description": "Top up diamond Mobile Legends.", "status": true, "populer": true, "sort": 1, "category": { "id": 1, "title": "MOBA" } } ], "populerGames": [ { "id": 11, "image": "https://topup.ferdiananda.web.id/storage/games/mobile-legends.jpg", "banner": "https://topup.ferdiananda.web.id/storage/banner/mobile-legends-banner.jpg", "title": "Mobile Legends", "developers": "Moonton", "brand": "MLBB", "category_id": 1, "slug": "mobile-legends", "description": "Top up diamond Mobile Legends.", "status": true, "populer": true, "sort": 1 } ] }

Nama

Tipe

Wajib

Deskripsi

Contoh

string

Gunakan application/json agar response selalu dikembalikan dalam format JSON.

application/json

X-API-KEY

string

API key publik yang diverifikasi oleh ApiKeyMiddleware untuk seluruh route public API.

server-api-key

Nama

Tipe

Wajib

Deskripsi

Contoh

string

User ID atau game ID target transaksi.

12345678

server

string

Tidak

Server ID bila game memerlukannya.

2012

game

string

Slug game yang aktif.

mobile-legends

product_id

integer

ID produk yang dipilih.

901

payment_method_id

integer

ID metode pembayaran yang dipilih.

string

Tidak

Email pemesan.

[email protected]

string

Nomor WhatsApp pemesan.

081234567890

nickname

string

Tidak

Nickname game bila tersedia.

FerdiML

promo_code

string

Tidak

Kode promo yang ingin diterapkan.

RAMADAN10

quantity

integer

Tidak

Jumlah item. Default 1.

curl -X POST 'https://topup.ferdiananda.web.id/api/order' \ -H 'Accept: application/json' \ -H 'X-API-KEY: <server-api-key>' \ -H 'Content-Type: application/json' \ -d '{"id":"12345678","server":"2012","game":"mobile-legends","product_id":901,"payment_method_id":12,"email":"[email protected]","whatsapp":"081234567890","nickname":"FerdiML","promo_code":"RAMADAN10","quantity":2}'

{ "success": true, "message": "Pesanan berhasil dibuat.", "orderId": "INV-20260329093000-ABCDEFGH", "data": { "order_id": "INV-20260329093000-ABCDEFGH", "payment_status": "UNPAID", "buy_status": "Pending", "payment_url": "https://gateway.example/pay/INV-20260329093000-ABCDEFGH", "payment_code": "INV-20260329093000-ABCDEFGH", "payment_reference": "INV-20260329093000-ABCDEFGH", "qr_url": null, "expired_at": "2026-03-29T10:00:00+07:00", "quantity": 2, "total_price": 40000, "pricing": { "quantity": 2, "has_promo": true, "promo_code": "RAMADAN10", "unit_price_before_promo": 22000, "unit_discount": 2000, "unit_price_after_promo": 20000, "subtotal_before_promo": 44000, "promo_discount": 4000, "subtotal_after_promo": 40000, "payment_fee": 0, "unique_code": 0, "total_price": 40000 } } }

{ "message": "The id field is required. (and 2 more errors)", "errors": { "id": [ "The id field is required." ], "game": [ "The game field is required." ], "whatsapp": [ "The whatsapp field is required." ] } }

Dokumentasi API Topup Game

Autentikasi

Public REST

Katalog Publik

GET/api/gamesDaftar game publikMengembalikan daftar game dari GameController::index beserta daftar game populer. Response memakai dua koleksi top-level: games dan populerGames.X-API-KEY

GET/api/games/{slug}Detail game berdasarkan slugRoute ini terdaftar pada routes/api.php sebagai GameController::show, tetapi method show() tidak ditemukan pada source GameController yang aktif saat ini.X-API-KEY

Order & Invoice

POST/api/orderBuat order publikMembuat transaksi baru melalui OrderController::store. Endpoint ini memvalidasi game, produk, metode pembayaran, promo, lalu membuat referensi pembayaran dan menyimpan order.X-API-KEY

GET/api/invoice/{order_id}Detail invoiceMengembalikan detail invoice dari InvoiceController::show. Response memuat object order, object game hasil mapGame(), dan object product hasil mapProduct().X-API-KEY

GET/api/invoice/{order_id}/payment-statusStatus pembayaran invoiceEndpoint ringan untuk polling payment_status dan buy_status dari InvoiceController::paymentStatus. Response sukses selalu memakai top-level success dan data.X-API-KEY

Dokumentasi API Topup Game

Autentikasi

Public REST

Katalog Publik

GET/api/gamesDaftar game publikMengembalikan daftar game dari GameController::index beserta daftar game populer. Response memakai dua koleksi top-level: games dan populerGames.X-API-KEY

GET/api/games/{slug}Detail game berdasarkan slugRoute ini terdaftar pada routes/api.php sebagai GameController::show, tetapi method show() tidak ditemukan pada source GameController yang aktif saat ini.X-API-KEY

Order & Invoice

POST/api/orderBuat order publikMembuat transaksi baru melalui OrderController::store. Endpoint ini memvalidasi game, produk, metode pembayaran, promo, lalu membuat referensi pembayaran dan menyimpan order.X-API-KEY

GET/api/invoice/{order_id}Detail invoiceMengembalikan detail invoice dari InvoiceController::show. Response memuat object order, object game hasil mapGame(), dan object product hasil mapProduct().X-API-KEY

GET/api/invoice/{order_id}/payment-statusStatus pembayaran invoiceEndpoint ringan untuk polling payment_status dan buy_status dari InvoiceController::paymentStatus. Response sukses selalu memakai top-level success dan data.X-API-KEY