Developer Hub

DOKUMENTASI API

Integrate your store system with Gercep using our REST API and webhooks.

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

01Every API request must include the 'X-API-KEY' header.
02You can find your API Key in the Merchant dashboard under Settings > API.
03Use this API Key to authenticate your external integration with Gercep.

API Endpoints

GET/api/partner/sync-products

Fetch Product List

Returns all products currently registered in Gercep for your store. Useful to verify sync results.

Request Body

null

Response

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

Upsert Products

A single endpoint to create new products or update existing ones. If 'externalId' exists, the product is updated; otherwise, a new product is created.

Request Body

{
  "action": "upsert",
  "products": [
    {
      "externalId": "POS-123",
      "name": "Nasi Goreng Spesial",
      "price": 25000,
      "category": "Main Dishes",
      "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

Delete Products

Deletes products from Gercep. You can delete by 'externalId' (your system ID) or by 'name'.

Request Body

{
  "action": "delete",
  "products": [
    {
      "externalId": "POS-123"
    },
    {
      "name": "Old Item"
    }
  ]
}

Response

{
  "success": true,
  "results": [
    {
      "externalId": "POS-123",
      "status": "deleted"
    },
    {
      "name": "Old Item",
      "status": "deleted"
    }
  ]
}
WEBHOOKYour URL (configured in Dashboard)

Order Paid Webhook

Gercep sends order data to your webhook URL whenever an order is successfully paid.

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"