Events & Payload

Webhook akan mengirimkan notifikasi untuk berbagai event order. Setiap callback berisi payload JSON dengan informasi lengkap.

bolt Event Types

order.paid

Dikirim ketika pembayaran order berhasil. Order sedang diproses.

order.completed

Dikirim ketika order selesai diproses. Produk sudah dikirim/diaktifkan. Informasi hasil proses dikirim sesuai tipe produk, misalnya licenses, h2h_results, atau smm_results.

order.canceled

Dikirim ketika order dibatalkan. Saldo akan dikembalikan jika sudah dibayar.

order.item.sent MANUAL ONLY

Dikirim ketika admin mengirim item pesanan untuk produk manual. Berisi lisensi/kode yang dikirim. Event ini dikirim per-item, bukan per-order.

webhook.test

Dikirim saat Anda menjalankan test webhook untuk verifikasi konfigurasi.

code HTTP Headers

Setiap callback dikirim dengan headers berikut:

Header	Deskripsi
Content-Type	application/json
X-Signature	SHA256 signature untuk verifikasi
X-Timestamp	Waktu pengiriman (ISO8601)
X-Event	Tipe event (order.paid, dll)
User-Agent	SekalipayWebhook/1.0

data_object Payload Structure

Field	Tipe	Deskripsi
event	string	Tipe event
timestamp	string	Waktu event (ISO8601)
data.invoice	string	Nomor invoice
data.ref_id	string	Reference ID Anda
data.status	string	Status order
data.price	integer	Harga produk
data.fees	integer	Biaya admin
data.amount	integer	Total bayar
data.items	array	Daftar item order

inventory_2 Item Fields

Field	Tipe	Deskripsi
variant_id	integer	ID variant produk
variant_name	string	Nama variant
product_name	string	Nama produk
quantity	integer	Jumlah
note	string	Customer ID, Zone ID, dll
order_process	string	Tipe proses item: `auto`, `manual`, `h2h`, `smm`
licenses	array\|null	Untuk `auto`: daftar lisensi/kode yang terkirim
h2h_results / smm_results	object\|null	Untuk `h2h`/`smm`: hasil proses provider (SN, order_id, remains, dll)
target	string\|null	Target order customer (contoh user id game atau link sosial media)
status	string	Status item

check_circle Expected Response

Endpoint Anda harus merespons dengan HTTP 2xx (200, 201, 202, 204) agar dianggap sukses.

info

Tips: Langsung response OK terlebih dahulu, lalu proses data secara async. Ini mencegah timeout jika proses Anda memakan waktu lama.

Payload Example (order.completed)

{
  "event": "order.completed",
  "timestamp": "2024-01-15T10:30:00+07:00",
  "data": {
    "invoice": "INV-20240115-XXXXX",
    "ref_id": "your-ref-123",
    "status": "completed",
    "price": 50000,
    "fees": 1000,
    "amount": 51000,
    "payment_code": "saldo",
    "items": [
      {
        "variant_id": 123,
        "variant_name": "Diamond 100",
        "product_id": 45,
        "product_name": "Mobile Legends",
        "order_process": "h2h",
        "quantity": 1,
        "price": 50000,
        "subtotal": 50000,
        "note": "123456789|1234",
        "h2h_results": {
          "sn": "SN123456789",
          "dispatch_status": "Success",
          "dispatch_message": "Transaksi sukses",
          "ref_id": "TRX123456789"
        },
        "target": "123456789|1234",
        "status": "completed"
      }
    ]
  }
}

Payload (order.item.sent) MANUAL

{
  "event": "order.item.sent",
  "timestamp": "2024-01-15T10:30:00+07:00",
  "data": {
    "invoice": "INV-20240115-XXXXX",
    "ref_id": "your-ref-123",
    "transaction_status": "paid",
    "item": {
      "order_item_id": "01kh6vpatp6yhphh181zz3a8qv",
      "variant_id": 456,
      "variant_name": "Windows 11 Pro",
      "product_id": 77,
      "product_name": "License Key",
      "order_process": "manual",
      "quantity": 2,
      "price": 15000,
      "subtotal": 30000,
      "note": "[email protected]",
      "status": "sent",
      "licenses": [
        {
          "product_license": "XXXXX-XXXXX-XXXXX-XXXXX",
          "note": null
        },
        {
          "product_license": "YYYYY-YYYYY-YYYYY-YYYYY",
          "note": null
        }
      ],
      "sent_at": "2024-01-15T10:30:00+07:00"
    }
  }
}

💡 Event ini dikirim per-item saat admin mengirim pesanan manual.

Your Response

200 OK

{
  "status": "ok"
}