🔌 Informasi Server
GET
https://api-point.kkisyariah.com
Base URL untuk semua endpoint API sistem poin. Pastikan semua request mengarah ke server ini.
🛒 Transaksi Toko
Endpoint untuk mencatat transaksi poin dari pembelian di toko. Poin akan dihitung berdasarkan jumlah transaksi dan metode pembayaran.
Endpoint
POST
https://api-point.kkisyariah.com/api/kkimart_transaction
Header
| Key | Value | Required |
|---|---|---|
| Content-Type | application/json | Ya |
| Accept | application/json | Ya |
Request Body
{
"no_transaksi": "TRX12345", // Nomor transaksi unik (string) max 50
"tgl_transaksi": "2024-08-28", // Format YYYY-MM-DD
"nik": "123456789", // NIK anggota (string)
"nama": "Arif Hidayatulloh", // Nama anggota (string)
"jumlah_tunai": 50000, // Nominal pembayaran tunai (number) | Kosongkan jika pembayaran hanya kredit
"jumlah_kredit": 100000, // Nominal pembayaran kredit (number) | Kosongkan jika pembayaran hanya tunai
"kasir": "nama kasir" // Nama kasir (string)
}
Response Sukses
200 OK
Pembayaran Kredit dan Tunai
{
"success": true,
"message": "Transaksi Point Toko Berhasil",
"data": {
"no_transaksi": "TRX12345",
"tgl_transaksi": "2024-08-28",
"nik": "123456789",
"nama": "Arif Hidayatulloh",
"jumlah": 150000,
"point": 3,
"keterangan": "Pembayaran Kredit: Rp 100.000 + Tunai: Rp 50.000",
"id_users": "nama kasir",
"status": "N",
"updated": "2024-08-28 12:00:00"
}
}
Pembayaran Kredit
{
"success": true,
"message": "Transaksi Point Toko Berhasil",
"data": {
"no_transaksi": "TRX12345",
"tgl_transaksi": "2024-08-28",
"nik": "123456789",
"nama": "Arif Hidayatulloh",
"jumlah": 100000,
"point": 2,
"keterangan": "Pembayaran Kredit: Rp 100.000",
"id_users": "nama kasir",
"status": "N",
"updated": "2024-08-28 12:00:00"
}
}
Pembayaran Tunai
{
"success": true,
"message": "Transaksi Point Toko Berhasil",
"data": {
"no_transaksi": "TRX12345",
"tgl_transaksi": "2024-08-28",
"nik": "123456789",
"nama": "Arif Hidayatulloh",
"jumlah": 50000,
"point": 1,
"keterangan": "Pembayaran Tunai: Rp 50.000",
"id_users": "nama kasir",
"status": "N",
"updated": "2024-08-28 12:00:00"
}
}
Error Responses
400 Bad Request
NIK Tidak Terdaftar
{
"message": "NIK/No Kartu Anggota Tidak Terdaftar"
}
422 Unprocessable Entity
NIK Tidak Aktif
{
"message": "NIK Anggota Tidak Aktif"
}
422 Unprocessable Entity
Tanggal Tidak Sesuai
{
"message": "Tanggal Transaksi Tidak Sesuai (Harus di tahun yang sama) 2026-04-18"
}
500 Internal Server Error
Kesalahan Server
{
"error": "Pesan kesalahan dari server"
}
⛽ Transaksi SPBU
Endpoint untuk mencatat transaksi poin dari pembelian bahan bakar di SPBU. Poin dihitung berdasarkan jenis produk dan jumlah transaksi.
Endpoint
POST
https://api-point.kkisyariah.com/api/spbu_transaction
Header
| Key | Value | Required |
|---|---|---|
| Content-Type | application/json | Ya |
| Accept | application/json | Ya |
Kode Produk
| ID | Nama Produk |
|---|---|
| 1 | Pertamax |
| 2 | Pertalite |
| 3 | Dexlite |
| 4 | Biosolar |
Request Body
{
"no_transaksi": "SPBU98765", // Nomor transaksi unik (string) max 50
"tgl_transaksi": "2025-04-13", // Format YYYY-MM-DD
"nik": "1234567890", // NIK anggota (string)
"nama": "Arif Hidayatulloh", // Nama anggota (string)
"jumlah": 500000, // Jumlah transaksi (number)
"produk": 1, // ID produk sesuai tabel
"bayar": "T", // K: Kredit, T: Tunai
"kasir": "nama petugas" // Nama petugas (string)
}
Response Sukses
200 OK
{
"success": true,
"message": "Transaksi Point SPBU Berhasil",
"data": {
"no_transaksi": "SPBU98765",
"tgl_transaksi": "2025-04-13",
"nik": "1234567890",
"nama": "Arif Hidayatulloh",
"jumlah": 500000,
"point": 50,
"jenis": 2,
"produk": "Pertamax",
"bayar": "T",
"id_users": "nama petugas",
"status": "N",
"updated": "2025-04-13T12:34:56"
}
}
Error Responses
400 Bad Request
NIK Tidak Terdaftar
{
"message": "NIK/No Kartu Anggota Tidak Terdaftar"
}
422 Unprocessable Entity
NIK Tidak Aktif
{
"message": "NIK Anggota Tidak Aktif"
}
422 Unprocessable Entity
Tanggal Beda Tahun
{
"message": "Tanggal Transaksi Tidak Sesuai (Harus dalam Tahun 2025)"
}
500 Internal Server Error
Kesalahan Server
{
"error": "Pesan kesalahan dari server"
}
🚀 Endpoint Lainnya
Endpoint lainnya sedang dalam pengembangan dan akan segera hadir!