Dokumentasi API

Panduan lengkap untuk mengintegrasikan TokogarPay ke dalam aplikasi Anda.

Profil Pengguna

Dapatkan detail profil pengguna saat ini. Endpoint ini memerlukan API Key.

POST /api/profile

POST https://api.tokogar.com/api/profile

Headers:

Content-Type: application/x-www-form-urlencoded

Field	Tipe	Deskripsi
api_key	string	API Key merchant Anda.

curl -X POST https://api.tokogar.com/api/profile \
  -d "api_key=betas921"

Contoh Response (200 OK)

{
  "success": true,
  "message": "Profile retrieved successfully",
  "data": {
    "id": "usr_8723",
    "name": "TokogarPay",
    "email": "tokogarpay@example.com",
    "merchant_id": "mch_9921"
  }
}

Buat Pesanan

Buat pesanan pembayaran baru. Anda akan mendapatkan URL pembayaran atau instruksi Virtual Account.

POST /api/order

Field	Tipe	Deskripsi
api_key	string	API Key merchant Anda.
ref_id	string	ID Referensi unik order Anda.
method_id	string	ID Metode pembayaran.
amount	integer	Jumlah pembayaran (IDR).
fee_type	integer	Tipe biaya (1: Merchant, 2: Customer).
note	string	Catatan transaksi.
redirect_url	string	URL redirect setelah pembayaran.
callback_url	string	URL Callback untuk notifikasi.

Field

Tipe

Deskripsi

amount

integer

Jumlah pembayaran (IDR).

Field

Tipe

Deskripsi

method

string

Kode metode (misal: 'va_bca').

Field

Tipe

Deskripsi

items

array

Daftar item pembelian.

{
  "api_key": "betas921",
  "ref_id": "test020",
  "method_id": "7",
  "amount": "10000",
  "fee_type": "1",
  "note": "note from cust",
  "redirect_url": "https://tokogar.com/helper/log-request",
  "callback_url": "https://tokogar.com/helper/log-request"
}

{
    "success": true,
    "message": "Order created successfully",
    "data": {
        "pay_id": "TGP2601102JHRHG",
        "ref_id": "test020",
        "checkout_url": "https://payment.tokogar.com/invoice/TGP123***",
        "method": "QRIS",
        "amount": 10000,
        "fee": 0,
        "additional_fee": 0, // Khusus untuk non mitra tokogar
        "total_amount": 10000,
        "received_amount": 10000,
        "expired_at": "2026-02-06 23:26:10",
        "payment_data": {
            "type": "QRIS",
            "qris_content_static": "00020101021226590013ID.CX.PROD...",
            "qris_content_dynamic": "00020101021226590013ID.CX.PROD...",
            "qris_url_static": "https://payment.tokogar.com/qris/.....",
            "qris_url_dynamic": "https://payment.tokogar.com/qris/....."
        },
        "status": "Pending"
    }
}

{
    "success": true,
    "message": "Order created successfully",
    "data": {
        "pay_id": "TGP2601102ABCDEF",
        "ref_id": "test021",
        "checkout_url": "https://payment.tokogar.com/invoice/TGP123***",
        "method": "BANK",
        "amount": 15000,
        "fee": 0,
        "additional_fee": 0, // Khusus untuk non mitra tokogar
        "total_amount": 15000,
        "received_amount": 15000,
        "expired_at": "2026-02-06 23:26:10",
        "payment_data": {
            "type": "BANK",
            "target_account": "1234567890",
            "payment_name": "BCA"
        },
        "status": "Pending"
    }
}

{
    "success": true,
    "message": "Order created successfully",
    "data": {
        "pay_id": "TGP2601102VAXYZ",
        "ref_id": "test022",
        "checkout_url": "https://payment.tokogar.com/invoice/TGP123***",
        "method": "VA",
        "amount": 20000,
        "fee": 0,
        "additional_fee": 0, // Khusus untuk non mitra tokogar
        "total_amount": 20000,
        "received_amount": 20000,
        "expired_at": "2026-02-06 23:26:10",
        "payment_data": {
            "type": "VA",
            "va_number": "8808123456789012",
            "expired_at": "2026-02-06 22:41:25"
        },
        "status": "Pending"
    }
}

{
    "success": true,
    "message": "Order created successfully",
    "data": {
        "pay_id": "TGP2601102EWALLET",
        "ref_id": "test023",
        "checkout_url": "https://payment.tokogar.com/invoice/TGP123***",
        "method": "EWALLET",
        "amount": 25000,
        "fee": 0,
        "additional_fee": 0, // Khusus untuk non mitra tokogar
        "total_amount": 25000,
        "received_amount": 25000,
        "expired_at": "2026-02-06 23:26:10",
        "payment_data": {
            "type": "EWALLET",
            "target_account": "08123456789",
            "payment_name": "DANA",
        },
        "status": "Pending"
    }
}

{
    "success": true,
    "message": "Order created successfully",
    "data": {
        "pay_id": "TGP2601102RETAIL",
        "ref_id": "test024",
        "checkout_url": "https://payment.tokogar.com/invoice/TGP123***",
        "method": "RETAIL",
        "amount": 30000,
        "fee": 0,
        "additional_fee": 0, // Khusus untuk non mitra tokogar
        "total_amount": 30000,
        "received_amount": 30000,
        "expired_at": "2026-02-06 23:26:10",
        "payment_data": {
            "type": "RETAIL",
            "payment_code": "1234567890123456",
            "store_name": "Indomaret",
        },
        "status": "Pending"
    }
}

{
    "success": true,
    "message": "Order created successfully",
    "data": {
        "pay_id": "TGP2601102PULSA",
        "ref_id": "test025",
        "checkout_url": "https://payment.tokogar.com/invoice/TGP123***",
        "method": "PULSA",
        "amount": 12000,
        "fee": 0,
        "additional_fee": 0, // Khusus untuk non mitra tokogar
        "total_amount": 12000,
        "received_amount": 12000,
        "expired_at": "2026-02-06 23:26:10",
        "payment_data": {
            "type": "PULSA",
            "phone": "081234567890",
        },
        "status": "Pending"
    }
}

Cek Status

Lihat status transaksi berdasarkan ID referensi pesanan.

POST /api/status

POST https://api.tokogar.com/api/status

Headers:

Content-Type: application/x-www-form-urlencoded

Field	Tipe	Deskripsi
api_key	string	API Key merchant Anda.
ref_id	string	ID Referensi order.
pay_id	string	ID Transaksi Tokogar (Opsional).

curl -X POST https://api.tokogar.com/api/status \
  -d "api_key=betas921" \
  -d "ref_id=CLIENT6973AB800AB8E" \
  -d "pay_id=TGP260123UMIWML"

Contoh Response (200 OK)

{
    "success": true,
    "message": "Order status retrieved",
    "data": {
        "pay_id": "TGP2601102JHRHG",
        "ref_id": "test002",
        "method": "BCA Transfer",
        "amount": 10000,
        "fee": 0,
        "total_amount": 10000,
        "received_amount": 10000,
        "status": "Paid"
    }
}

Generate QRIS Dinamis

Generate QRIS dinamis secara instan berdasarkan nominal dari QRIS statis yang telah dikonfigurasi. Anda juga dapat menambahkan angka unik acak pada nominal.

POST /api/qris

POST https://api.tokogar.com/api/qris

Headers:

Content-Type: application/json

Accept: application/json

Field	Tipe	Deskripsi
api_key	string	API Key merchant Anda.
amount	integer	Jumlah pembayaran (minimal 1).
is_unique	integer	Tambahkan nominal unik (0 jika tidak, 1 jika ya).
unique_range	integer	Rentang angka unik acak (minimal 100).

curl -X POST https://api.tokogar.com/api/qris \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "api_key": "betas921",
    "amount": 10000,
    "is_unique": 1,
    "unique_range": 100
  }'

Contoh Response (200 OK)

{
    "success": true,
    "message": "QRIS created successfully",
    "data": {
        "status": "success",
        "amount": 10000,
        "total_amount": 10029,
        "expired_at": "2026-03-16 02:26:10",
        "qris_content_static": "00020101021226590013ID.CX.PROD...",
        "qris_content_dynamic": "00020101021226590013ID.CX.PROD...",
        "qris_url_static": "https://payment.tokogar.com/qris/19312......png",
        "qris_url_dynamic": "https://payment.tokogar.com/qris/43211......png"
    }
}

Callback / Webhooks

Kami akan mengirimkan HTTP POST ke URL callback Anda setiap kali status pembayaran berubah.

POST /callback_url_anda

Field	Tipe	Deskripsi
pay_id	string	ID Transaksi Tokogar.
ref_id	string	ID Referensi order Anda.
status	string	Status pembayaran (e.g. 'Paid').
amount	integer	Jumlah pembayaran.

Field

Tipe

Deskripsi

status

string

'paid', 'expired', atau 'failed'.

Field

Tipe

Deskripsi

reference_id

string

ID untuk pesanan Anda.

Field

Tipe

Deskripsi

signature

string

Untuk verifikasi keamanan.

{
  "success": true,
  "message": "Payment successful",
  "data": {
    "pay_id": "TGP2601102JHRHG",
    "ref_id": "test002",
    "method": "BCA Transfer",
    "amount": 10000,
    "fee": 0,
    "total_amount": 10000,
    "received_amount": 10000,
    "status": "Paid"
  }
}

Respon yang Diharapkan dari Server Anda

{
  "status": "ok"
}