Geliştiriciler/Ekosistem ve kaynaklar
Dujiao-Next için CardV
CardV'yi Dujiao-Next mağazanıza tedarikçi olarak ekleyin. CardV hediye kartlarını ve oyun yüklemelerini kendi ürünleriniz olarak içe aktarır, fiyatlarınızı kendiniz belirlersiniz. Bir alıcı ödeme yaptığında mağazanız ürünü CardV bakiyenizle CardV'den satın alır ve kod, alıcının sipariş sayfasında otomatik olarak görünür.
#Gerekenler
| Dujiao-Next | v1.5.0 veya üzeri, üst kaynak bağlantısı özelliğiyle (Integration menüsü) |
| CardV hesabı | API erişimi açık, onaylı bir üye işyeri hesabı |
| API anahtarı | Merchant Portal'dan imzalı bir API anahtarı (anahtar kimliği + imzalama sırrı) |
| Bakiye | USD cinsinden ön ödemeli CardV bakiyesi. Mağazanızın verdiği her sipariş bu bakiyeden ödenir |
Alıcılarınıza karşı satıcı sizsiniz: fiyatları siz belirler, sorularını siz yanıtlar ve iadelerini siz yürütürsünüz.
#1. Adım: API anahtarınızı alın
Merchant Portal içinde API ve Webhook'lar > API anahtarları altında zaten sahip olduğunuz API anahtarını kullanın. Dujiao-Next için ayrı bir anahtara gerek yoktur.
- Anahtar kimliği (Key ID)
ck_live_ile başlar. - İmzalama sırrı
cs_live_ile başlar. Yalnızca bir kez, anahtar oluşturulduğunda gösterilir. Artık elinizde değilse anahtarda Sırrı yeniden oluştur seçeneğini kullanın. Anahtar kimliği aynı kalır ve eski sır hemen çalışmaz hale gelir.
Anahtar kimliği olmayan eski anahtarlar kullanılamaz. Bunun yerine Portal'da yeni bir anahtar oluşturun.
#2. Adım: Bağlantıyı ekleyin
Dujiao-Next yönetim panelinde Integration > Connection Management > New Connection sayfasını açın ve formu doldurun:
| Alan | Ne girilir | Neden |
|---|---|---|
| Name | Örneğin CardV (USD) | Bunu yalnızca siz görürsünüz. Para birimini eklemek ileride karışıklığı önler |
| Base URL | https://b2b.cardv.net/dujiao | /dujiao dahil olsun, sonrasında hiçbir şey olmasın, sonda eğik çizgi olmasın |
| API Key | Anahtar kimliğiniz (ck_live_…) | |
| API Secret | İmzalama sırrınız (cs_live_…) | Bağlantıyı daha sonra düzenlerken kayıtlı sırrı korumak için alanı boş bırakın |
| Protocol | dujiao-next | |
| Callback URL | Boş bırakın | CardV geri çağrı (callback) göndermez. Mağazanız her siparişin sonucunu kendisi kontrol eder (bkz. Teslimat nasıl çalışır) |
| Max Retries / Retry Intervals | Varsayılanları koruyun (3 / 30,60,120) | Yeniden denemeler yalnızca geçici hatalar için geçerlidir |
| Exchange Rate | Kendiniz girdiğiniz sabit bir sayı: USD'den mağaza para biriminize bugünkü gerçek kur, tampon olarak biraz üzerinde. Mağazanız USD ile satıyorsa 1 girin | CardV fiyatları her zaman USD cinsindendir. Dujiao-Next güncel kurları çekmez ve CardV bu değeri sizin yerinize ayarlayamaz. Varsayılan değer 1 olduğundan, başka bir para birimiyle satan bir mağaza 10 USD'lik bir kartı kendi para biriminde 10'a listelerdi |
| Price Markup (%) | Kâr payınız, örneğin 15 | Varsayılan değer 0'dır, yani kâr yoktur |
| Price Rounding | Round up (0.1) veya Round up (integer) | Yukarı yuvarlama fiyatınızı asla maliyetinizin altına düşürmez |
| Auto-update price on sync | Yes | Bir CardV fiyatı değiştiğinde satış fiyatınız bir sonraki senkronizasyonda yeniden hesaplanır |
Kur ve kâr payı şöyle birleşir: CardV fiyatı × kur × (1 + kâr payı), ardından yuvarlama. Örneğin 7.2 kur (yalnızca örnek; baktığınız güncel kuru girin) ve %15 kâr payıyla 5.78 USD'lik bir kart 47.9'a satılır.
Kur değiştiğinde bağlantıda güncelleyin ve önceden içe aktardığınız ürünlerin fiyatlarını güncellemek için Reapply Markup düğmesine tıklayın. Kâr payını değiştirdiğinizde de aynısını yapın.
#3. Adım: Bağlantıyı test edin
Bağlantıda Ping düğmesine tıklayın. Ping succeeded anahtarınızın çalıştığı anlamına gelir ve bağlantı durumu Active olur. Bunun yerine bir hata görürseniz Sorun giderme bölümüne bakın.
#4. Adım: Ürünleri içe aktarın
- Integration > Product Mappings > Import from Upstream sayfasını açın ve CardV bağlantınızı seçin.
- Kategoriye göre göz atın veya tek tek ürün seçmek için Flat List görünümüne geçin.
- Yerel bir kategori seçin veya Auto-create local categories seçeneğini işaretleyin. Bir ürünü kaydetmeden önce kategorisi olmalıdır.
- İçe aktarın. Her ürün başlığını, açıklamasını, kullanım talimatlarını ve nominal değerlerini (örneğin
10 USD) korur.
İçe aktarılan ürünler satışta değildir. Her birini kontrol edin, ardından ürün düzenleyicide Active seçeneğini açın.
#5. Adım: Sipariş başına tek ürün ayarlayın
İçe aktarılan her ürün için ürün düzenleyiciyi açın ve Max purchase quantity değerini 1 yapın.
CardV sipariş başına bir ürün teslim eder. Bir alıcı tek siparişte iki kod için ödeme yaparsa CardV satın almayı reddeder ve bu siparişi elle çözmeniz gerekir. Dujiao-Next bu sınırı CardV'den otomatik olarak alamaz, bu yüzden kendiniz ayarlayın.
Düzenleyicideyken şunları da öneririz:
- Vitrinde stok gösterimi: Hide quantity seçin. CardV, sipariş geldiğinde markadan satın alır; bu yüzden mağazanızın gösterdiği stok sayısı yalnızca "mevcut" anlamına gelir.
- Görseller: Bir ürünün görseli yoksa kendi görselinizi ekleyin.
#Teslimat nasıl çalışır
- Alıcı mağazanızda ödeme yapar.
- Mağazanız satın alımı CardV'ye gönderir ve CardV, CardV bakiyenizden ücreti düşer.
- Mağazanız siparişi CardV'de kontrol eder. Testlerimizde kod bir dakika içinde geldi.
- Kod, alıcının sipariş sayfasında
Code,PIN(kartta varsa) veExpires(kartın son kullanma tarihi varsa) olarak görünür. Her zaman bir koddur, asla bir bağlantı değildir.
Doğrudan yüklemeler. Bazı ürünler doğrudan alıcının oyun veya uygulama hesabına yüklenir. Alıcı, ödeme sırasında ürünün gerektirdiği bilgileri, örneğin oyuncu kimliğini veya telefon numarasını girer. Yükleme tamamlandığında alıcının sipariş sayfasında Top-up completed. gösterilir.
CardV teslim edemezse. CardV siparişin bedelini CardV bakiyenize iade eder ve mağazanız satın alımı iptal edildi olarak işaretler. Ardından alıcıya mağazanızda iade yapar veya yardımcı olursunuz.
#Neler kullanılamaz
İçe aktarma listesi yalnızca mağazanızın bu bağlantı üzerinden satabileceği ürünleri gösterir:
- Yalnızca sabit nominal değerler. Alıcının kendi tutarını girdiği kartlar listelenmez.
- Listelenmeyenler: mobil hat yüklemeleri, ödeme ve cüzdan ürünleri, kripto ve ön ödemeli ödeme kartları.
- Yalnızca kodlar. Yalnızca bağlantı olarak teslim edilebilen ürünler listelenmez.
Gördüğünüz fiyatlar, USD cinsinden kendi CardV fiyatlarınızdır.
#IP beyaz listesi
Merchant Portal'da bir IP beyaz listesi ayarladıysanız, Dujiao-Next mağazanızı çalıştıran sunucunun genel IP adresini ekleyin. Aksi halde CardV bu sunucudan gelen her isteği reddeder. CardV API ve Dujiao-Next için aynı anahtar, aynı beyaz liste ve aynı istek sınırları geçerlidir.
#Sorun giderme
Bu mesajları Dujiao-Next yönetim panelinde, Ping sonrasında, içe aktarma sırasında veya Procurement Orders içindeki bir satın alımda görürsünüz.
| Mesaj | Neden | Ne yapmalı |
|---|---|---|
status 401 (invalid_signature): signature verification failed | API Secret yanlış veya Portal'da yeniden oluşturdunuz | Güncel imzalama sırrını bağlantıya kopyalayın |
status 403 (invalid_api_key): api key is invalid or disabled | API Key bir anahtar kimliği (ck_live_…) değil veya anahtar devre dışı | Etkin bir anahtarın anahtar kimliğini kullanın |
status 403 (user_disabled): merchant API access is not enabled | Hesabınız henüz API erişimi için onaylanmadı | Portal'da işletme incelemesini tamamlayın |
status 403 (forbidden): source IP is not allowed for this merchant | IP beyaz listeniz mağazanızın sunucusunu içermiyor | Sunucunun genel IP adresini Portal'da ekleyin |
status 401 (timestamp_expired): timestamp expired | Sunucu saatiniz 60 saniyeden fazla sapmış | Sunucuda otomatik saat senkronizasyonunu (NTP) açın |
status 404 ardından bir web sayfası | Base URL yanlış, genellikle /dujiao eksik | https://b2b.cardv.net/dujiao kullanın |
CardV wallet balance is insufficient | CardV bakiyeniz satın alımı karşılamıyor. Alıcının siparişi ödenmiş olarak kalır | CardV bakiyenizi yükleyin, ardından Procurement Orders içindeki satın alımda Retry düğmesine tıklayın |
quantity must be 1: CardV accepts one item per order | Bir alıcı bir üründen birden fazla sipariş etti | Max purchase quantity değerini 1 yapın (5. Adım), ardından siparişi elle çözün |
sku is invalid or not available | Ürün artık CardV'de mevcut değil | Eşleştirmede bir senkronizasyon çalıştırın. CardV'nin artık sunmadığı ürünler satıştan kalkar |
status 429 (rate_limited) | Bir dakika içinde çok fazla istek | Mağazanız kendisi yeniden dener. Tekrarlamaya devam ederse senkronizasyon sıklığını azaltın |
#SSS
Dujiao-Next için yeni bir API anahtarına ihtiyacım var mı? Hayır. Zaten sahip olduğunuz imzalı API anahtarını kullanın. Anahtarı kendi CardV API entegrasyonunuz için de kullanıyorsanız, ikisi aynı istek sınırlarını paylaşır.
Callback URL neden boş bırakılıyor? CardV mağazalara geri çağrı göndermez. Dujiao-Next mağazanız, sonuç kesinleşene kadar her siparişi kendisi kontrol eder.
CardV fiyatları değişince ne olur? Auto-update price on sync açıksa satış fiyatlarınız bir sonraki senkronizasyonda kurunuz ve kâr payınızla yeniden hesaplanır. Kapalıysa mağazanız eski fiyattan satmaya devam eder.
Bu siparişleri CardV'de nerede görürüm? Merchant Portal'daki Siparişler sayfasında. Sipariş ID'niz sütunu dujiao: ile başlar, ardından Dujiao-Next alt sipariş numarası gelir (örneğin dujiao:DJ…-01). CardV webhook'larını ayarladıysanız bu siparişler için de tetiklenirler.
Ürün başlıklarını, açıklamalarını ve görsellerini değiştirebilir miyim? Evet. Senkronizasyon fiyatları ve stok durumunu günceller. Başlıklarınızın veya görsellerinizin üzerine yazmaz.
Özel tutarlar satabilir miyim? Dujiao-Next üzerinden henüz hayır. Yalnızca sabit nominal değerler kullanılabilir.
#Destek
Merchant ID'nizi, Dujiao-Next sipariş numarasını ve hata mesajını belirterek [email protected] adresine e-posta gönderin. CardV kullanımınız Hizmet Şartlarımıza tabidir.
Entegrasyonla ilgili sorunuz mu var? Merchant ID’nizi ve sipariş ya da istek kimliğini ekleyerek [email protected] adresine yazın.