Lewati ke konten

Pengembang dan API

Dapatkan webhook setiap kali Anda menerima pesanan tiket

Webhook mengirim setiap pesanan ke alamat milik Anda beberapa detik setelah pembeli membayar. Agensi dan promotor yang memiliki CRM, sistem gudang, atau sistem pemenuhan pesanan sendiri dapat menerima setiap penjualan saat terjadi, tanpa menunggu ekspor malam hari.

Minta Ticket Fairy mengirim setiap pesanan baru ke alamat milik Anda beberapa detik setelah pembeli membayar, agar sistem Anda menerima penjualan tanpa perlu memintanya berkala.

Untuk
Mengirim setiap penjualan tiket ke sistem Anda saat terjadi
Perlu waktu
8 menit

Sebelum mulai

  • Anda memiliki alamat yang menerima POST dan merespons dengan cepat. Gunakan HTTPS untuk endpoint sungguhan karena setiap permintaan membawa detail pesanan dan pembeli.
  • Anda memiliki token akses pribadi untuk baris perintah. Panduan untuk membuatnya tersedia secara terpisah.
  • Anda tahu event mana yang harus mengirim data: satu event, semua event di bawah satu brand, atau semua event dalam satu tur.

  1. Buat kunci webhook

    Buka pengaturan akun Anda, lalu pilih Buat Kunci API Webhook di bawah Kunci API Webhook.

    Catatan: Platform seperti Zapier meminta kunci ini saat Anda menghubungkannya. Webhook yang Anda buat sendiri memanggil alamat Anda secara langsung dan tidak memerlukan apa pun dari kartu ini.

    Kartu Kunci API Webhook Ticket Fairy yang menampilkan kunci, dengan kontrol untuk menyalin dan membuatnya kembali
    Kunci webhook setelah dibuat.

  2. Arahkan webhook ke alamat Anda

    Jalankan ticketfairy webhook create --url https://example.com/hooks/tickets --on order pada brand yang sedang Anda kerjakan.

    Catatan: Setiap pesanan dikirim ke alamat tersebut sebagai JSON. Balas dengan kode sukses secepatnya, lalu lakukan pekerjaan yang lebih lama setelahnya agar penjualan yang ramai tidak perlu menunggu Anda.

  3. Pilih pemicunya

    Masukkan hal yang ingin Anda terima di --on: order untuk pesanan, atau new_event, update_event, publish_event, dan find_event untuk event itu sendiri.

    Catatan: Satu webhook membawa satu notifikasi. Jadi, sistem yang ingin menerima pesanan dan publikasi memerlukan dua webhook.

Tentukan kapan memasang webhook pada brand, bukan event

Pasang webhook pada satu event jika hanya event tersebut yang harus mengirim data ke sistem Anda, atau pada brand jika semua event harus mengirim data. Satu tur memiliki pemasangannya sendiri. Empat notifikasi event menjadi pengecualian: new_event, update_event, publish_event, dan find_event hanya menjangkau webhook brand dan tur, bukan webhook yang dipasang pada satu event. Jadi, pasang webhook pada brand jika sistem Anda ingin menerima notifikasi publikasi.

  1. Pasang di tempat yang harus menerimanya

    Masukkan --event, --brand, atau --tour pada perintah yang membuat webhook.

    Catatan: Jika tidak ada satu pun dari ketiganya, perintah akan menggunakan brand yang sedang Anda kerjakan.

  2. Jual tiket dan lihat hasilnya masuk

    Beli satu tiket sendiri, lalu periksa apakah permintaan sampai ke alamat Anda.

    Catatan: Pengiriman berlangsung di latar belakang, bukan di dalam proses checkout, jadi tunggu beberapa detik. Setelah itu, refund pesanan Anda sendiri.

Atau minta dikerjakan untuk Anda

Fai dapat membuka halaman yang berisi kunci webhook. Webhook dibuat dari baris perintah, dan langkah-langkah di bawah ini menunjukkan perintahnya.

Di dasbor Anda, dengan Fai

Buka pengaturan akun saya agar saya bisa mendapatkan kunci webhook

Dari asisten Anda sendiri, lewat MCP

Hubungkan asisten Anda ke server MCP kami lalu minta:

Biarkan --read-only dalam konfigurasi MCP Anda. Tugas ini hanya membaca data, jadi asisten Anda tidak memerlukan alat yang membuat perubahan.

Pilih brand <BRAND NAME> dan tampilkan event-nya

Dari terminal Anda

Pasang CLI dari halaman CLI kami, masuk dengan ticketfairy auth login, lalu pilih brand yang Anda kerjakan dengan ticketfairy brand use <BRAND_ID>. ticketfairy brand list dan ticketfairy event list menampilkan ID yang digunakan perintah lain.

Buat webhook, lalu baca kembali apa yang sedang menerima data.

Panggil alamat Anda setiap kali pesanan dibuat

ticketfairy webhook create --url https://example.com/hooks/tickets --on order

Tampilkan webhook pada brand aktif

ticketfairy webhook list

Biarkan Fai mengerjakannya untuk Anda

Fai bekerja di dalam dasbor Ticket Fairy Anda. Buat akun Anda, buka Fai dan tempel perintah di atas.

Buat akun gratis Pesan demo

Tanpa biaya pemasangan. Tanpa biaya bulanan wajib. Tanpa kartu kredit.

Nonaktifkan salah satunya

  1. Matikan saat Anda memperbaikinya

    Jalankan ticketfairy webhook update <ID> --disable, menggunakan ID dari ticketfairy webhook list.

    Catatan: Webhook yang dinonaktifkan menyimpan pengaturannya dan berhenti menerima data. Aktifkan kembali dengan perintah yang sama dan --enable.

  2. Hapus yang sudah selesai digunakan

    Jalankan ticketfairy webhook delete <ID> setelah tidak ada lagi yang memerlukannya.

    Catatan: Penghapusan bersifat permanen. Jika Anda hanya ingin menjedanya, nonaktifkan terlebih dahulu.

Fai dapat membuka dashboard untuk Anda. Saat ini, webhook dibaca dan diubah dari baris perintah.

Di dasbor Anda, dengan Fai

Buka pengaturan akun saya

Dari asisten Anda sendiri, lewat MCP

Biarkan --read-only dalam konfigurasi MCP Anda. Tugas ini hanya membaca data, jadi asisten Anda tidak memerlukan alat yang membuat perubahan.

Pilih brand <BRAND NAME> dan tampilkan event-nya

Dari terminal Anda

Baca webhook, lalu matikan atau hapus salah satunya.

Tampilkan webhook pada brand aktif

ticketfairy webhook list

Hentikan penerimaan webhook tanpa menghapusnya

ticketfairy webhook update <WEBHOOK_ID> --disable

Hapus webhook secara permanen

ticketfairy webhook delete <WEBHOOK_ID>

Pertanyaan yang mungkin Anda punya

Mengapa tidak ada yang masuk saat event saya ditayangkan?
Periksa webhook tersebut dipasang pada apa. Notifikasi event hanya menjangkau webhook brand dan tur, jadi webhook yang dipasang pada satu event hanya menerima pesanan.
Apa yang terjadi jika alamat saya tidak aktif?
Pengiriman tersebut gagal, lalu pengiriman berikutnya dicoba seperti biasa. Balas dengan 410 Gone dan kami akan menghapus webhook dari daftar. Ini cara yang tepat untuk berhenti berlangganan dari sisi Anda.
Bisakah saya memeriksa apakah permintaan benar-benar berasal dari Ticket Fairy?
Bisa. Minta dukungan Ticket Fairy menambahkan secret penandatanganan ke event Anda. Setelah itu, setiap permintaan membawa header X-Signature yang dapat dihitung ulang oleh endpoint Anda menggunakan secret yang sama.
Apakah pesanan yang sama bisa sampai kepada saya lebih dari sekali?
Bisa. Seluruh pesanan dikirim ulang setiap kali berubah, jadi refund, pembatalan, penjualan kembali, atau transfer akan mengirimkannya masing-masing. Cocokkan berdasarkan nomor pesanan dan terapkan data yang Anda terima, bukan menghitung setiap pengiriman sebagai penjualan baru.
Bisakah saya menguji dengan alamat lokal?
Alamat http biasa di komputer Anda sendiri diterima, jadi tunnel hanya kemudahan, bukan keharusan. Setiap permintaan membawa detail pesanan dan pembeli. Gunakan http untuk pengujian, lalu berikan alamat HTTPS untuk sistem live.

Masih ada pertanyaan?

Jadwalkan demo dan kami akan menjawabnya lewat panggilan, sesuai jenis acara Anda. Atau buat akun Anda dan lihat sendiri.

Pesan demo Buat akun gratis

Tanpa biaya pemasangan. Tanpa biaya bulanan wajib. Tanpa kartu kredit.

Panduan terkait

Lakukan ini di acara Anda sendiri

Buat akun, susun acara, dan ikuti langkah-langkahnya di dasbor Anda. Anda tidak perlu memesan panggilan penjualan.

Buat akun gratis Pesan demo

Pesan demo

Lihat bagaimana Ticket Fairy menangani tiket, penjualan, dan akses masuk acara Anda. Pilih waktu yang cocok untuk Anda.

Panggilan Video 45 Menit
Pilih Waktu yang Cocok untuk Anda