OxaPay ile White Label Kripto Ödeme Geçidi Nasıl Entegre Edilir

Bir White Label kripto ödeme geçidini entegre etmek yalnızca bir APIye bağlanmak değildir. Bu, müşteri deneyiminin kontrolünü elinizde tutarken web sitenize veya uygulamanıza eksiksiz bir kripto ödeme akışı eklemek anlamına gelir.

Bu OxaPay White Label çözümüyle işletmeniz ödeme adresini, QR kodunu, tutarı, ağı ve ödeme durumunu kendi arayüzünde gösterebilir. Bu sırada OxaPay; ödeme oluşturma, blokzincir izlemeve işlem güncellemeleri dahil olmak üzere alttaki ödeme altyapısını yönetir.

Bu yaklaşım, işletmelerin blokzincir ödeme altyapısını kendi bünyelerinde kurup sürdürmeden kendi markaları altında kripto ödemeler sunmasına olanak tanır.

Bu rehberde OxaPay White Label geçidinin nasıl entegre edileceğini, işletmenizin başlamadan önce nelere ihtiyaç duyduğunu ve canlıya geçmeden önce hangi ödeme durumlarının dikkate alınması gerektiğini açıklıyoruz.

White Label İşletmeniz İçin Uygun mu?

Entegrasyona başlamadan önce White Label çözümünün ödeme akışınız için doğru seçenek.

Bir barındırılan kripto ödeme sayfası genellikle kripto para kabul etmeye hızlıca başlamakisteyen işletmeler için yeterlidir. Bu modelde müşteriler işlemi tamamlamak için ödeme geçidinin sağladığı bir ödeme sayfasına yönlendirilir.

White Label, ödeme deneyimi ürününüzün veya müşteri yolculuğunuzun önemli bir parçası olduğunda daha uygundur. Müşterileri harici bir ödeme sayfasına yönlendirmek yerine ödeme bilgilerini kendi web siteniz, uygulamanız, platformunuz veya checkout akışınız içinde gösterirsiniz.

Bu çözüm özellikle şunları isteyen işletmeler için kullanışlıdır:

• checkout boyunca tutarlı marka deneyimini korumak
• müşterileri kendi platformunda tutmak
• ödeme talimatlarının ve durumlarının nasıl gösterileceğini kontrol etmek
• kripto ödemeleri mevcut sipariş sürecine bağlamak
• blokzincir ödeme altyapısını sıfırdan kurmaktan kaçınmak

Temel fark kontrol düzeyidir. Müşterinin gördüğü deneyimi işletmeniz yönetirken, arka plandaki ödeme altyapısını OxaPay yönetir.

Başlamadan Önce Neye İhtiyacınız Var

White Label entegrasyonu bir miktar hazırlık gerektirir, ancak işletmenizin blokzincir düğümleri çalıştırmasına veya kendi işlem izleme sistemini kurmasına gerek yoktur.

Web sitenizin veya uygulamanızın OxaPay APIile güvenli biçimde iletişim kurabilen, ödeme bilgilerini saklayabilen ve her ödemeyi doğru siparişle eşleştirebilen bir backend'e sahip olması gerekir.

Ayrıca OxaPay'den ödeme güncellemelerini alabilecek bir callback endpoint gerekir. Bu güncellemeler sisteminizin müşterinin ödemeye ne zaman başladığını ve ödemenin ne zaman tamamlandığını bilmesini sağlar.

Son olarak, ödeme arayüzünüz şu temel bilgileri gösterebilmelidir:

• ödeme tutarı
• seçilen kripto para
• blokzincir ağı
• ödeme adresi
• QR kodu
• kalan ödeme süresi
• en güncel ödeme durumu

Arayüz özellikle seçilen ağı ve sona erme süresini açıkça göstermelidir; çünkü bu alanlardaki hatalar ödeme sorunlarına yol açabilir.

OxaPay ile White Label kripto ödeme geçidi entegrasyonu

1. Bir OxaPay Merchant Hesabı Oluşturun

İlk adım bir OxaPay hesabı oluşturmak ve merchant paneline erişmektir.

Panelden Merchant API Key'inizi, ödeme ayarlarını, desteklenen para birimlerini, işlem kayıtlarını ve diğer merchant araçlarını yönetebilirsiniz.

Bu aşamada işletme hesabınızı OxaPay ile iletişim kurmaya hazırlarsınız. Her sipariş için ayrı blokzincir cüzdanları oluşturmanız veya kendi işlem izleme sisteminizi kurmanız gerekmez.

2. Merchant API Key'inizi Oluşturun

Ardından OxaPay hesabınızdan bir Merchant API Key oluşturun.

Bu anahtar, sisteminizin OxaPay API'ye gönderilen ödeme isteklerini doğrulamasını sağlar. Her zaman güvenli şekilde saklanmalıdır backend sunucunuzda.

Merchant API Key frontend koduna, herkese açık depolara, tarayıcı scriptlerine veya müşterilerin erişebileceği başka herhangi bir konuma yerleştirilmemelidir.

Backend'iniz White Label ödeme istekleri oluştururken bu anahtarı kullanmalıdır. Frontend yalnızca müşteriye göstermek için ihtiyaç duyduğu ödeme bilgilerini almalıdır.

3. White Label Ödeme İsteği Oluşturun

Bir White Label ödemeoluşturmak için sisteminiz aşağıdaki endpoint'e bir istek gönderir:

POST https://api.oxapay.com/v1/payment/white-label

Zorunlu iki ödeme alanı şunlardır:

• Tutar: ödeme değeri
• pay_currency: ödeme için kullanılan kripto para

Ödeme akışınıza bağlı olarak başka alanlar da eklenebilir.

Örneğin:

• currency siparişin fiyatlandırılmasında kullanılan para birimini tanımlar; örneğin USD.
• Ağ kripto para birden fazla ağda kullanılabiliyorsa blokzincir ağını seçer.
• order_id ödemeyi kendi sisteminizdeki bir siparişe bağlar.
• callback_url OxaPay'e ödeme güncellemelerini nereye göndereceğini söyler.
• lifetime ödemenin ne kadar süre geçerli kalacağını belirler.
• under_paid_coverage istenen ve alınan tutarlar arasındaki kabul edilebilir farkı tanımlar.

Bu currency, Ağ, order_idve callback_url alanları API'de isteğe bağlıdır. Ancak güvenilir sipariş takibine ihtiyaç duyan işletmeler için order ID ve callback URL kullanılması önemle tavsiye edilir.

İstek başarılı olduğunda OxaPay bir ödeme oturumu oluşturur ve sisteminizin ödemeyi göstermesi için gereken bilgileri döndürür.

4. Ödeme Bilgilerini Alın ve Gösterin

Ödeme isteği oluşturulduktan sonra OxaPay yapılandırılmış ödeme bilgilerini döndürür.

Bunlar şunları içerebilir:

• benzersiz bir track_id
• tam ödeme tutarı
• ödeme kripto parası
• blokzincir ağı
• ödeme adresi
• bir QR kodu
• sona erme süresi

Sisteminiz track_id değerini saklamalı ve doğru dahili siparişle eşleştirmelidir. Bu tanımlayıcı işletmenizin ödemeyi takip etmesine ve gerektiğinde daha sonra incelemesine yardımcı olur.

Frontend'iniz daha sonra döndürülen bilgileri kendi markanıza ait bir ödeme sayfası oluşturmak için kullanabilir.

Müşteri şunları yapabilmelidir:

• QR kodunu taramak
• ödeme adresini kopyalamak
• tam tutarı kopyalamak
• gerekli kripto para ve ağı görmek
• ne kadar süre kaldığını kontrol etmek
• mevcut ödeme durumunu takip etmek

White Label modelinin temel avantajı budur. Müşteri ödemeyi işletmeniz tarafından tasarlanmış ve markalanmış bir deneyim içinde tamamlar.

Ödeme sayfası ayrıca ödeme süresi dolduktan sonra müşterileri fon göndermemeleri konusunda uyarmalıdır. OxaPay dokümantasyonuna göre oluşturulan White Label adresleri yalnızca belirtilen ödeme lifetime süresi boyunca geçerlidir.

5. Ödeme Durumunu Takip Edin

Müşteri kripto parayı gönderdikten sonra OxaPay ödemeyi izler ve ilerlemesini bildirir.

OxaPay ödeme durumları şu durumları içerebilir:

• ödeme bekleniyor
• ödeme devam ediyor
• paid
• underpaid
• expired
• manuel olarak kabul edildi
• refunded

İşletmenizin müşteriye her dahili durumu göstermesi gerekmez. Arayüz bu durumları “Ödeme bekleniyor”, “Ödeme algılandı”, “Ödeme tamamlandı” veya “Ödeme süresi doldu” gibi basit mesajlara dönüştürebilir.

Önemli nokta, sisteminizin siparişi çok erken tamamlamamasıdır.

OxaPay ödeme etkinliği algılandığında paying güncellemesi gönderir. Sisteminiz normalde ürün teslim etmeden, hizmeti etkinleştirmeden veya siparişi tamamlandı olarak işaretlemeden önce son paid durumunu beklemelidir.

6. Ödeme Güncellemelerini Alın ve Doğrulayın

OxaPay ödeme güncellemelerini ödeme isteğinde yer alan callback_url adresine gönderir.

Bu bildirimler sisteminizin şunları yapmasını sağlar:

• ilgili ödemeyi tanımlamak
• dahili sipariş durumunu güncellemek
• müşteriyi ilerleme hakkında bilgilendirmek
• başarılı ödemeden sonra siparişi tamamlamak

Callback endpoint herkese açık olduğundan sisteminiz gelen bildirimleri doğrulamalıdır herhangi bir işlem yapmadan önce.

OxaPay callback'leriyle birlikte bir güvenlik imzası sağlar. Teknik ekibiniz bu imzayı doğrulamalı ve ödeme bilgilerinin saklanan sipariş ayrıntılarıyla eşleştiğini teyit etmelidir.

Bunun müşteriye görünmesi gerekmez, ancak ödeme sürecini korumanın önemli bir parçasıdır.

Sisteminiz aynı güncellemeyi birden fazla kez almaya da hazır olmalıdır. Tekrarlanan bir callback ürünün iki kez teslim edilmesine, bakiyenin tekrar kredilenmesine veya siparişin birden fazla kez onaylanmasına yol açmamalıdır.

Sisteminiz callback'in alındığını başarıyla doğrulamazsa OxaPay callback'i yeniden göndermeyi deneyebilir.

Eksik Ödeme Yönetimi

Bazen müşteri istenen ödeme tutarından daha az gönderebilir.

OxaPay, merchant'ın beklenen ve alınan tutarlar arasında kabul edilebilir bir fark belirlemesini sağlayan eksik ödeme toleransı seçeneği sunar.

Fark kabul edilen aralık içindeyse ödeme yapılandırılmış politikaya göre devam edebilir. Tutar kabul edilen eşiğin altındaysa ödeme için başka bir işlem gerekebilir.

İş modelinize bağlı olarak şunları yapabilirsiniz:

• müşteriden kalan tutarı tamamlamasını istemek
• ödemeyi manuel olarak incelemek
• ödemeyi dahili bir politika kapsamında kabul etmek
• uygun olduğunda siparişi iptal etmek veya iade etmek

Eksik ödemeler otomatik olarak başarısız ödemelerle aynı şekilde ele alınmamalıdır. Müşterilerin ve destek ekiplerinin sonraki adımı bilmesi için net bir süreçleri olmalıdır.

7. Tüm Ödeme Akışını Test Edin

Entegrasyonu yayına almadan önce tam müşteri yolculuğunu ödeme oluşturmadan siparişin tamamlanmasına kadar test edin.

Testleriniz şunları içermelidir:

• başarılı ödeme oluşturma
• adres ve QR kodunun doğru görüntülenmesi
• doğru ödeme tutarı ve ağ bilgileri
• ödeme durumu güncellemeleri
• başarılı sipariş tamamlama
• süresi dolmuş ödemeler
• eksik ödeme senaryoları
• tekrarlanan ödeme bildirimleri
• gecikmiş ödeme güncellemeleri

Ödeme sayfasının mobil cihazlarda nasıl çalıştığını da kontrol etmelisiniz. Birçok müşteri QR kodunu başka bir cihazla tarar veya adresi doğrudan mobil cüzdana kopyalar.

Yalnızca ilk API isteğini test etmek yeterli değildir. Ödeme güncellemeleri ve fulfillment dahil tüm sipariş süreci, entegrasyon müşterilere sunulmadan önce güvenilir şekilde çalışmalıdır.

Önemli Entegrasyon Hususları

Güvenilir bir White Label ödeme deneyimi birkaç pratik ayrıntıya bağlıdır.

Sona Erme Yönetimi

Bir ödemenin süresi dolduğunda sisteminiz onu aktif olarak göstermeyi bırakmalıdır. Müşteriye süresi dolmuş ödeme bilgilerini kullanmaya devam etmek yerine yeni bir ödeme isteği oluşturma seçeneği verilmelidir.

Doğru Ağ Seçimi

Bir kripto para birden fazla ağda destekleniyorsa seçilen ağı açıkça gösterin.

Yanlış ağ üzerinden fon gönderen bir müşterinin destekle iletişime geçmesi gerekebilir ve kurtarma her zaman mümkün olmayabilir. Açık talimatlar bu hataların çoğunu önleyebilir.

Açık Ödeme Talimatları

Müşteriler hemen şunları anlayabilmelidir:

• hangi kripto parayı gönderecekleri
• hangi ağı kullanacakları
• ne kadar gönderecekleri
• nereye gönderecekleri
• ödemenin ne kadar süre geçerli olduğu
• ödemeden sonra ne olacağı

Açık bir ödeme sayfası kafa karışıklığını azaltır ve daha güvenilir bir checkout deneyimi oluşturur.

White Label Entegrasyon Akışı

Tüm süreç yedi adımda özetlenebilir:

1. Sisteminiz dahili bir sipariş oluşturur.
2. Backend'iniz OxaPay'e White Label ödeme isteği gönderir.
3. OxaPay ödeme ayrıntılarını döndürür.
4. Web siteniz veya uygulamanız ödemeyi kendi arayüzünde gösterir.
5. Müşteri istenen kripto parayı gönderir.
6. OxaPay işlemi izler ve ödeme güncellemelerini gönderir.
7. Sisteminiz ödemeyi doğrular ve siparişi tamamlar.

Sonuç

OxaPay White Label kripto ödeme geçidini entegre etmek, bir işletmenin alttaki blokzincir altyapısını kendisi kurmadan ödeme deneyimini kontrol etmesini sağlar.

OxaPay ödeme oluşturma, işlem izleme ve ödeme güncellemelerini yönetir. İşletmeniz markalama, müşteri arayüzü, sipariş yönetimi ve son fulfillment sürecini kontrol eder.

Fikir basittir: müşteri deneyimi işletmenize aittir, arka plandaki ödeme altyapısını ise OxaPay sağlar.

Net bir ödeme sayfası, güvenilir durum takibi ve uygun testlerle White Label entegrasyonu, müşterilere web sitenize veya uygulamanıza tamamen bağlı kalan tutarlı bir kripto ödeme deneyimi sunabilir.