API Reference

Dokumentasi API Terintegrasi

Panduan integrasi lengkap untuk seluruh endpoint API pembayaran (V1 & V2) dan penarikan instan. Dilengkapi dengan fitur Try It Out (Live Test) untuk langsung menguji response dari server.

Langkah 1

Persiapan & Otentikasi

Seluruh komunikasi dengan API harus diotentikasi menggunakan API Key rahasia Anda. Kirimkan kunci tersebut melalui HTTP Header x-api-key: YOUR_API_KEY atau sebagai Query Parameter ?apikey=YOUR_API_KEY.

Status: Belum Login

Silakan Login ke dashboard terlebih dahulu agar dapat menggunakan fitur eksekusi (Try It Out) pada dokumentasi ini.

Endpoint B

Cek Saldo (Balance)

GET

cURL Request

curl -X GET "/api/v1/balance" \
  -H "x-api-key: "

Live Test Runner

Ambil data saldo akun utama secara real-time.

Response JSON Example

{
  "balance": 150000
}

API Versi 1 (Payment Link)

Endpoint C1

Generate Invoice V1 (Payment URL)

GET

Endpoint V1 dirancang khusus untuk mengembalikan atribut payment_url (Tako Checkout). Redirect pengguna Anda ke URL tersebut untuk menyelesaikan pembayaran.

cURL Request

curl -X GET "/api/v1/invoice?amount=50000" \
  -H "x-api-key: "

Query Parameter Test

Response JSON Example

{
  "success": true,
  "invoice_id": "INVXYZ123",
  "amount": 50000,
  "fee": 1500,
  "total": 51500,
  "payment_url": "https://tako.id/pay/XYZ123",
  "qris_image": "https://ndikapedia.id/api/v1/invoice/qr/...",
  "expired_at": "2026-10-09T10:00:00Z"
}

Endpoint D1

Cek Status Invoice V1

GET

cURL Request

curl -X GET "/api/v1/invoice/status?invoice_id=INV-X89J21" \
  -H "x-api-key: "

Query Parameter Test

Response JSON Example

{
  "success": true,
  "invoice_id": "INV-X89J21",
  "amount": 50000,
  "fee": 1500,
  "total": 51500,
  "status": "paid",
  "payment_url": "https://tako.id/pay/XYZ123",
  "qris_image": "https://tako.id/pay/XYZ123",
  "expired_at": "2026-10-09T10:00:00.000Z",
  "created_at": "2026-10-09T09:30:00.000Z"
}

API Versi 2 (Direct QRIS)

Endpoint C2

Generate Invoice V2 (Direct QRIS Image)

GET

Endpoint V2 mengembalikan atribut qris_image berupa tautan gambar QR Code secara langsung. Sangat cocok jika Anda ingin menampilkan Barcode QRIS di dalam sistem antarmuka aplikasi internal Anda (in-app payment) tanpa me-redirect pengguna.

cURL Request

curl -X GET "/api/v2/invoice?amount=50000" \
  -H "x-api-key: "

Query Parameter Test

Response JSON Example

{
  "success": true,
  "invoice_id": "INV-Q99K32",
  "amount": 50000,
  "fee": 1500,
  "total": 51500,
  "qris_image": "https://ndikapedia.id/api/v1/invoice/qr/...",
  "expired_at": "2026-10-09T10:20:00Z"
}

Endpoint D2

Cek Status Invoice V2

GET

cURL Request

curl -X GET "/api/v2/invoice/status?invoice_id=INV-X89J21" \
  -H "x-api-key: "

Query Parameter Test

Response JSON Example

{
  "invoice_id": "INV-Q99K32",
  "amount": 50000,
  "fee": 1500,
  "total": 51500,
  "status": "pending",
  "qris_image": "https://ndikapedia.id/api/v1/invoice/qr/...",
  "expired_at": "2026-10-09T10:20:00.000Z",
  "created_at": "2026-10-09T09:50:00.000Z"
}

Endpoint E

Batalkan Invoice (V1 & V2)

POST

Gunakan endpoint ini untuk membatalkan tagihan Anda. Invoice hanya dapat dibatalkan apabila statusnya saat ini masih pending. Baik tagihan V1 maupun V2 dapat dibatalkan di endpoint universal ini.

cURL Request

curl -X POST "/api/v2/invoice/INV-X89J21/cancel" \
  -H "x-api-key: "

Path Parameter Test

Response JSON Example

{
  "success": true,
  "message": "Transaksi berhasil dibatalkan."
}

API Penarikan (Withdraw)

Endpoint F

Direktori Metode Withdraw Instan

GET

Gunakan endpoint ini untuk mengambil seluruh daftar bank atau e-wallet (beserta kode resminya) yang didukung dan sedang aktif untuk pencairan instan H2H.

cURL Request

curl -X GET "/api/v1/withdraw/methods" \
  -H "x-api-key: "

Live Test Runner

Ambil daftar metode penarikan.

Response JSON Example

{
  "success": true,
  "methods": [
    {
      "name": "Dana",
      "code": "DANA",
      "fee": 1000,
      "min_amount": 10000,
      "max_amount": 1000000
    },
    {
      "name": "GoPay",
      "code": "GOPAY",
      "fee": 2000,
      "min_amount": 10000,
      "max_amount": 1000000
    }
  ]
}

Endpoint G

Pemrosesan Withdraw Instan

POST

Gunakan endpoint ini untuk mencairkan saldo Anda ke rekening / e-wallet. Pemrosesan dilakukan secara otomatis dan instan melalui server H2H.

cURL Request (JSON)

curl -X POST "/api/v1/withdraw/instant" \
  -H "x-api-key: " \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 50000,
    "method_code": "DANA",
    "destination": "081234567890"
  }'

JSON Body Test

Response JSON Example

{
  "success": true,
  "withdraw_id": "IWDXYZ123456",
  "status": "success"
}

Endpoint H

Validasi Status Withdraw

GET

cURL Request

curl -X GET "/api/v1/withdraw/status?withdraw_id=IWDXYZ123456" \
  -H "x-api-key: "

Query Parameter Test

Response JSON Example

{
  "withdraw_id": "IWDXYZ123456",
  "status": "success",
  "created_at": "2026-10-09T10:45:30Z"
}