Developer Hub

DOKUMENTASI API

Integrasikan sistem restoran Anda dengan ekosistem Gercep AI menggunakan API RESTful kami yang tangguh.

Plugins & Integrasi

WCFM (Multivendor)

WCFM (Multivendor)

Integrasikan toko WCFM Anda dengan sinkronisasi produk real-time dan manajemen vendor.

Download / Doc
WooCommerce

WooCommerce

Plugin standar untuk sinkronisasi produk WooCommerce ke platform Gercep.

Download / Doc
Shopify

Shopify

Panduan integrasi Shopify menggunakan Custom App dan Webhook.

Download / Doc
Magento 2

Magento 2

Modul integrasi Magento 2 via REST API untuk sinkronisasi katalog.

Download / Doc

Autentikasi & Keamanan

01Semua request API harus menyertakan header 'X-API-KEY'.
02API Key dapat ditemukan di dashboard Merchant pada bagian Settings > API.
03Gunakan API Key ini untuk mengautentikasi aplikasi eksternal Anda dengan platform Gercep.

API Endpoints

GET/api/partner/sync-products

Ambil Daftar Produk

Mengambil semua daftar produk yang saat ini terdaftar di Gercep untuk toko Anda. Berguna untuk memverifikasi hasil sinkronisasi.

Request Body

null

Response

{
  "success": true,
  "store": "Nama Toko Anda",
  "products": [
    {
      "id": 123,
      "externalId": "POS-123",
      "name": "Nasi Goreng",
      "price": 25000,
      "stock": 100
    }
  ]
}
POST/api/partner/sync-products

Tambah / Edit Produk (Upsert)

Endpoint tunggal untuk menambah produk baru ATAU memperbarui yang sudah ada. Jika 'externalId' sudah ada, sistem akan memperbarui data. Jika belum, sistem akan membuat produk baru.

Request Body

{
  "action": "upsert",
  "products": [
    {
      "externalId": "POS-123",
      "name": "Nasi Goreng Spesial",
      "price": 25000,
      "category": "Makanan Utama",
      "description": "Nasi goreng dengan telur dan ayam",
      "image": "https://example.com/image.jpg",
      "stock": 100
    }
  ]
}

Response

{
  "success": true,
  "results": [
    {
      "name": "Nasi Goreng Spesial",
      "status": "success",
      "id": 123,
      "externalId": "POS-123"
    }
  ]
}
POST/api/partner/sync-products

Hapus Produk

Menghapus produk dari sistem Gercep. Anda dapat menghapus berdasarkan 'externalId' (ID sistem Anda) atau 'name'.

Request Body

{
  "action": "delete",
  "products": [
    {
      "externalId": "POS-123"
    },
    {
      "name": "Menu Lama"
    }
  ]
}

Response

{
  "success": true,
  "results": [
    {
      "externalId": "POS-123",
      "status": "deleted"
    },
    {
      "name": "Menu Lama",
      "status": "deleted"
    }
  ]
}
WEBHOOKURL Anda (Konfigurasi di Dashboard)

Notifikasi Order (Paid)

Gercep akan mengirimkan data pesanan ke URL Webhook Anda setiap kali ada pesanan yang berhasil dibayar (Lunas).

Request Body

{
  "event": "order.paid",
  "data": {
    "id": 456,
    "storeSlug": "nama-toko",
    "customerPhone": "08123456789",
    "totalAmount": 50000,
    "paymentMethod": "qris",
    "orderType": "DELIVERY",
    "items": [
      {
        "externalId": "POS-123",
        "name": "Nasi Goreng Spesial",
        "quantity": 2,
        "price": 25000
      }
    ]
  }
}

Response

"HTTP 200 OK"