Sandbox

İlgili: README · Kimlik doğrulama

#Erişim

1. Önce işletmenizin CardV tarafından onaylanmış olması gerekir.
2. Portal'a giriş yapın ve üst menüden Sandbox'ı seçin. Sandbox'a doğrudan giriş yapılamaz.
3. İlk seferde CardV, Sandbox hesabınızı oluşturur. Hesap aynı Merchant ID'ye ve 1.000 USD test parasına sahiptir.
4. Sandbox'ta bir Owner, Sandbox API anahtarı oluşturur ve görüntüler. Live anahtarları burada çalışmaz.
5. İsteğe bağlı: Bir Sandbox Webhook'u kurun. Bu Webhook'un kendi imzalama sırrı vardır.

#Neler ayrı

• Sandbox'ın kendi anahtarları, cüzdanı, siparişleri, Webhook'ları, IP izin listesi ve denetim kaydı vardır.
• Ayarlar paylaşılmaz. Anahtarları, Webhook'ları ve IP izin listesini her ortamda ayrı ayrı kurun.
• Sandbox siparişleri hiçbir zaman gerçek ürün satın almaz. Test kodları kullanılamaz.
• Test parasının değeri yoktur. Sandbox'ta bakiye yükleyemez, para çekemez veya Live'a aktaramazsınız.
• Test paranız biterse CardV destek ekibinden ek bakiye isteyin.

#Test parası

Siparişler test parasını, Live siparişlerin gerçek parayı kullandığı şekilde kullanır. Başarısız test siparişleri de aynı şekilde iade edilir. Test parası hareketlerini Portal'daki hesap hareketleri sayfasında görebilirsiniz.

#Test kataloğu

• Sandbox kataloğu küçüktür ve yalnızca test ürünleri içerir.
• SKU numaraları Live'dakilerden farklıdır. Onları her zaman Sandbox'ta GET/skus ile bulun.
• Sandbox numaralarını Live ayarlarınıza (veya tersi yönde) asla kopyalamayın.
• Sandbox'taki fiyatlar, stok durumu ve teslimat hızı Live ile aynı değildir.

#Test kontrol listesi

• GET/account, Merchant ID'nizi ve "api_access_enabled": true değerini gösteriyor.
• GET/balance çalışıyor.
• GET/skus sonuçlarında sayfa sayfa gezebiliyorsunuz ve yalnızca available SKU'ları sipariş ediyorsunuz.
• İmzalı bir sipariş başarılı oluyor. Hatalı imza HTTP 403 alıyor.
• Her sipariş satırında expected_unit_price gönderiyorsunuz.
• amount ile aralıklı bir SKU siparişi çalışıyor (Sandbox'ta böyle bir ürün varsa).
• Aynı siparişi iki kez gönderdiğinizde (yeni nonce, aynı gövde ve aynı sipariş numarası) aynı order_id ile HTTP 200 dönüyor. Bakiyenizden yalnızca bir kez düşülüyor.
• Aynı sipariş numarasıyla farklı bir gövde gönderildiğinde external_order_id için HTTP 400 dönüyor.
• Zaman aşımından sonra kodunuz yeni sipariş numarası üretmek yerine aynı siparişi yeniden gönderiyor.
• deliveries[].display_fields alanını okuyup müşteriye iletiyorsunuz.
• failed, refunded ve partially_succeeded durumlarını ele alıyorsunuz.
• Webhook kodunuz önce test verisini, sonra gerçek bir Sandbox Webhook'unu doğruluyor. Tekrarlanan mesajlar yok sayılıyor.
• HTTP 429 sonrasında Retry-After kadar bekliyorsunuz.
• Loglarınızda API anahtarı, imza, kod veya müşteri hesap bilgisi bulunmuyor.

#Canlıya geçiş kontrol listesi

• Live Portal'da bir Live API anahtarı oluşturun. Anahtarı üretim ortamının gizli bilgi deposunda saklayın.
• Ayarlarınızda API adresini https://b2b.cardv.net/api/v1 olarak değiştirin.
• Live kataloğunu yükleyin ve ürünlerinizi Live SKU numaralarıyla eşleştirin.
• Portal'dan Live cüzdanınıza bakiye yükleyin. Düşük bakiye uyarısını ayarlayın.
• İsteğe bağlı: Sunucu IP adreslerinizi Live IP izin listesine ekleyin.
• Bir Live Webhook'u kurun ve imzalama sırrını sunucunuza dağıtın.
• Sipariş limitlerinizi ve istek limitinizi CardV ile teyit edin.
• Küçük tutarlı tek bir Live sipariş verin. Ödemeyi, kodları ve Webhook'u kontrol edin. Ardından trafiği adım adım artırın.
• Portal'daki hesap hareketleri sayfası ve dışa aktarmalarla her gün mutabakat yapın.
• Tüm Owner kullanıcıları için iki adımlı doğrulamayı açın.

#Sorun giderme

HTTP 403 error code: 1010

Sandbox sunucusu bir ağ güvenlik katmanının arkasındadır. Bazı HTTP istemcileri, error code: 1010 düz metniyle HTTP 403 alır. İstek CardV'ye hiç ulaşmamıştır, bu yüzden anahtarı veya imzayı değiştirmek işe yaramaz.

• Anlaşılır bir User-Agent belirleyin.
• Sorun devam ederse sunucu IP adresinizi, User-Agent değerinizi ve saati CardV destek ekibine gönderin.
• Bunun yerine asla Live ortamında test yapmayın.