Dokumentasi API Toko Voucher

Webhook - POST/GET

Webhook - POST/GET

Halaman ini menjelaskan format webhook (callback) yang kami kirimkan ke server Anda setiap kali ada perubahan status transaksi.

Penting: Pastikan IP kami sudah di-whitelist di server Anda: 188.166.243.56

Setiap request webhook menyertakan header untuk validasi:

Header KeyValue
X-TokoVoucher-Authorizationmd5(MEMBER_CODE:SECRET:REF_ID)

Contoh:

"X-TokoVoucher-Authorization": "bd134207f74532a8b094676c4a2ca9ed"

Gunakan header ini untuk memvalidasi bahwa request benar-benar dari Toko Voucher.

Format Webhook

Transaksi Sukses

{
    "status": "sukses",
    "message": "Transaksi berhasil",
    "sn": "02806600001851150526",
    "ref_id": "tes12",
    "trx_id": "123jad",
    "produk": "FF5",
    "sisa_saldo": 1000000,
    "price": 10000
}

Transaksi Gagal

{
    "status": "gagal",
    "message": "Nomor tujuan tidak valid",
    "sn": "",
    "ref_id": "tes12",
    "trx_id": "123jad",
    "produk": "FF5",
    "sisa_saldo": 1000000,
    "price": 10000
}

Penjelasan Field

FieldDeskripsi
statusStatus akhir transaksi (sukses atau gagal)
messagePesan detail transaksi
snSerial Number/kode voucher (jika ada)
ref_idID referensi dari Anda
trx_idID transaksi dari Toko Voucher
produkKode produk yang dibeli
sisa_saldoSisa saldo Anda setelah transaksi
priceHarga transaksi

Tips Implementasi

  1. Validasi Header - Selalu cek header X-TokoVoucher-Authorization untuk memastikan request valid
  2. Response 200 - Pastikan server Anda mengembalikan HTTP 200 agar kami tahu webhook berhasil diterima
  3. Idempotency - Simpan trx_id untuk menghindari pemrosesan duplikat jika webhook dikirim ulang

Prev

Inquiry

Next

Via IP (Otomax, IRS, Dll)

On this page