Kapan menggunakan cadangkan webhook
Gunakan ini untuk inventaris KOMPLEKS (unit unik) ketika Anda menghasilkan kunci atau akun di sistem Anda sendiri pada saat pembelian. Stok lokal selalu lebih disukai; webhook hanya mengisi kekurangan.
- Bekerja dengan pengiriman otomatis INSTANT hanya ketika setiap unit benar-benar ditugaskan.
- Konfigurasikan default tingkat tawaran, atau ganti per opsi harga.
- HTTPS saja. Penandatanganan HMAC opsional mencocokkan webhook keluar.
Kegagalan yang aman untuk pembayaran
Jika titik akhir Anda kehabisan waktu atau mengembalikan data yang tidak valid, pesanan tetap DIBAYAR. Pembeli dikenakan biaya; Anda melihat kesalahan pada pesanan dan dapat mencoba ulang cadangan atau melampirkan kunci secara manual.
Permintaan kontrak
Setelah pembayaran, RMT POSTs satu panggilan reserve.item per unit yang hilang dengan pesanan, tawaran, opsi, skema bidang, dan jumlah 1. Template permintaan JSON opsional digabungkan dengan {{placeholders}}.
Badan POST kanonik (dipotong)
{
"id": "rsv_…",
"type": "reserve.item",
"order": { "uid": "…", "reference": "…", "url": "…" },
"offer": { "url": "…", "title": "…", "pageUrl": "…" },
"option": { "id": 1, "name": "Standar" },
"fields": [{ "id": 10, "name": "Lisensi", "type": "text", "required": true }],
"quantity": 1
}Respons dan pemetaan bidang
Kembalikan 2xx JSON. Peta jalur seperti $.license ke bidang Item, atau kembalikan { "entries": [{ "fieldId": 10, "value": "KEY-…" }] }.
Respons kenyamanan
{
"entries": [
{ "name": "Lisensi", "value": "AAAA-BBBB-CCCC" }
]
}- Hanya lisensi: peta satu bidang teks dari $.license atau $.key.
- Akun: peta bidang email dan kata sandi dari $.email dan $.password.
- Bidang yang diperlukan yang hilang setelah pemetaan dihitung sebagai kegagalan.
Uji, coba ulang, dan keamanan
Gunakan Uji di editor tawaran (mengirim dryRun: true). Di halaman pesanan, Coba ulang cadangan setelah memperbaiki titik akhir Anda. Jangan pernah mencatat rahasia atau kunci lengkap dalam email.
- 1Simpan URL HTTPS, peta respons, dan rahasia opsional di langkah Item tawaran.
- 2Jalankan Uji dan konfirmasi pratinjau yang dipetakan.
- 3Jika gagal, buka pesanan, coba ulang cadangan, atau buat/tugaskan kunci secara manual.
Jangan panggil cadangan sebelum pembayaran
RMT hanya memanggil titik akhir Anda setelah pembayaran berhasil, sehingga checkout yang ditinggalkan tidak membakar lisensi.