Geliştiriciler
Gömülü widget
Müşteri alan adınızdan ayrılmadan öder. Faturayı API üzerinden oluşturur, CryBit ödeme formunu kendi sayfanızda gösterirsiniz.
1. Fatura oluşturun
Aynı POST /api/v1/payments çağrısını kullanın. Yanıt her zaman fatura uuid değerine eşit olan confirmation.confirmation_token alanını içerir. İstekteki confirmation alanı isteğe bağlıdır.
2. Betiği yükleyin ve bir kapsayıcı ekleyin
HTML
<script src="https://pay.crybit.net/widget.js"></script>
<div id="payment-form"></div>3. Formu gösterin
JavaScript
const checkout = new CryBitCheckout({
confirmation_token: 'INVOICE-UUID',
return_url: 'https://merchant.example/thanks',
lang: 'en',
error_callback: (err) => console.log(err),
})
checkout.render('payment-form').then(() => { /* the form is shown */ })
checkout.on('success', () => { /* status paid: confirm the order by webhook or GET */ })
checkout.on('fail', () => { /* expired, cancelled or refunded */ })
checkout.on('complete', () => checkout.destroy())Modal pencere
Sayfada kapsayıcı yoksa widget'ı customization: { modal: true } (veya modal: true) ile site üzerinde açın ve checkout.render() işlevini argümansız çağırın.
Seçenekler ve olaylar
| Seçenek | Anlamı |
|---|---|
confirmation_token | Zorunlu. Fatura uuid değeri (takma adlar: uuid, invoice_uuid). |
return_url | Müşterinin ödemeden sonra yönlendirileceği yer. |
lang | Arayüz dili; belirtilmezse tarayıcı dili. |
modal / customization.modal | Kapsayıcı yerine açılır pencere için true. |
error_callback, success_callback | Hata olduğunda (token yok, kapsayıcı yok) ve durum paid olduğunda çağrılır. |
Olaylar: ready, status, success, fail, complete, close, error. Metotlar: render(id), on(event, fn), destroy().
Siparişi webhook ile veya durumu okuyarak onaylayın. Widget olayı yalnızca kullanıcı arayüzü içindir.
FAQ
Widget'ı test edebilir miyim?
Evet. Test üye işyerinde widget, faturayı ödendi olarak işaretlemek için bir düğme gösterir ve bakiye yüklenmez.