Ne zaman rezerv web kancaları kullanmalısınız
Bunu, satın alma sırasında kendi sisteminizde anahtarlar veya hesaplar oluşturduğunuzda KOMPLEKS (benzersiz birim) envanter için kullanın. Yerel stok her zaman tercih edilir; webhook yalnızca eksikliği doldurur.
- Her birim gerçekten atanmışsa, yalnızca ANINDA otomatik teslimat ile çalışır.
- Bir teklif düzeyinde varsayılanı yapılandırın veya fiyatlandırma seçeneğine göre geçersiz kılın.
- Sadece HTTPS. İsteğe bağlı HMAC imzalama, dışa aktarılan web kancaları ile eşleşir.
Ödeme güvenli hatalar
Eğer uç noktanız zaman aşımına uğrarsa veya geçersiz veri döndürürse, sipariş ÖDENMİŞ kalır. Alıcıya ücretlendirilir; sipariş üzerinde bir hata görürsünüz ve rezervi yeniden deneyebilir veya anahtarları manuel olarak ekleyebilirsiniz.
Sözleşme talep et
Ödeme yapıldıktan sonra, RMT, eksik birim başına bir reserve.item çağrısı yapar; sipariş, teklif, seçenek, alan şeması ve miktar 1 ile birlikte. İsteğe bağlı istek şablonu JSON, {{placeholders}} ile birleştirilir.
Kanonik POST gövdesi (kısaltılmış)
{
"id": "rsv_…",
"type": "reserve.item",
"order": { "uid": "…", "reference": "…", "url": "…" },
"offer": { "url": "…", "title": "…", "pageUrl": "…" },
"option": { "id": 1, "name": "Standart" },
"fields": [{ "id": 10, "name": "Lisans", "type": "text", "required": true }],
"quantity": 1
}Yanıt ve alan eşlemesi
2xx JSON döndürün. Yolları, Item alanlarına $.license gibi eşleyin veya { "entries": [{ "fieldId": 10, "value": "KEY-…" }] } döndürün.
Kolaylık yanıtı
{
"entries": [
{ "name": "Lisans", "value": "AAAA-BBBB-CCCC" }
]
}- Sadece lisans: $.license veya $.key'den bir metin alanını eşleyin.
- Hesap: $.email ve $.password'dan e-posta ve şifre alanlarını eşleyin.
- Eşlemeden sonra eksik zorunlu alanlar hata olarak sayılır.
Test, yeniden deneme ve güvenlik
Teklif editöründe Test'i kullanın (dryRun: true gönderir). Sipariş sayfasında, uç noktanızı düzeltikten sonra rezervi yeniden deneyin. Anahtarları veya tam anahtarları e-postalarda asla kaydetmeyin.
- 1Teklif Öğeleri adımında HTTPS URL'sini, yanıt haritasını ve isteğe bağlı gizli anahtarı kaydedin.
- 2Test'i çalıştırın ve eşlenmiş önizlemeleri onaylayın.
- 3Başarısızlık durumunda, siparişi açın, rezervi yeniden deneyin veya manuel olarak bir anahtar oluşturun/ata.
Ödeme öncesinde rezerv çağrısı yapmayın
RMT, yalnızca ödeme başarılı olduktan sonra uç noktanızı çağırır, bu nedenle terkedilmiş ödemeler lisansları yakmaz.