Panel Kurulumu

API'ye istek atmadan önce çalışma alanınızda en az bir ödeme hesabı olmalıdır. Ödeme hesabı olmadan ödeme isteği 422 ile reddedilir (Ödeme hesabı belirtilmedi ve çalışma alanınızın varsayılan ödeme hesabı yok.).

Ödeme hesapları panelin Ödeme Ayarları menüsünden tanımlanır. Token'ları Entegrasyon sayfasından alırsınız.

Ödeme hesabı bağlamak (iyzico örneği)

Ödeme hesabı, ödemenin geçeceği sağlayıcı hesabıdır. Aşağıdaki adımlar iyzico içindir; diğer sağlayıcılarda yalnızca istenen alanlar değişir.

1. Ödeme Ayarları → Hesaplar sayfasını açın ve Hesap Ekle'ye tıklayın.

   

2. Listeden iyzico'yu seçin. Arama kutusuyla sağlayıcıyı adıyla bulabilirsiniz.

   

3. Formu doldurun.

   

   Alan	Açıklama
   Hesap Adı	Listede görünecek ad. Birden fazla hesap varsa ayırt edici bir ad verin.
   API Anahtarı	iyzico üye işyeri panelinde Ayarlar → Firma Ayarları altındaki API anahtarı.
   Güvenlik Anahtarı	Aynı yerdeki güvenlik anahtarı (secret key).

   Formun başlığı çalışma alanının moduna göre Test Kimlik Bilgileri ya da Canlı Kimlik Bilgileri'dir. Hangi moddaysanız o modun anahtarlarını girersiniz; diğer modun anahtarlarına dokunulmaz. Test modunda iyzico'nun sandbox anahtarlarını girin; gateway test modunda sandbox-api.iyzipay.com, canlı modda api.iyzipay.com adresine gider.

4. Bağlantıyı Test Et'e tıklayın. iyzico gibi bağlantı testi destekleyen sağlayıcılarda Kaydet düğmesi, girilen bilgiler sağlayıcıda doğrulanana kadar kapalıdır. Test başarısızsa sağlayıcının döndüğü mesaj formda gösterilir; bilgileri düzeltip yeniden test edin.

5. Kaydet'e tıklayın. Hesap listeye eklenir; çalışma alanının ilk hesabı otomatik olarak varsayılan olur.

Canlı anahtarları girmek

Sandbox'ta canlı moda geçilmez; canlı anahtarlar app.odemehub.com üzerindeki çalışma alanına girilir. Orada canlı anahtarlar aynı hesaba, çalışma alanı canlı moddayken girilir:

1. Sol alttaki Test / Canlı anahtarını Canlı konumuna getirin (ya da üstteki uyarı çubuğundaki Canlıya geç'e tıklayın).
2. Hesaplar sayfasında hesabı açıp Düzenle'ye tıklayın. Form artık Canlı Kimlik Bilgileri başlığıyla gelir.
3. Canlı anahtarları girin, bağlantıyı test edin ve kaydedin.

Mod değişikliği API isteklerini de etkiler: aynı adres ve aynı API anahtarıyla gelen istekler, çalışma alanı hangi moddaysa hesabın o moddaki ayarlarıyla işlenir. Bkz. Ortamlar ve Adresler.

Varsayılan hesabı değiştirmek

İstekte payment_provider_token gönderilmezse ödeme, yönlendirme kuralları (Gate) bir hesap seçmediği sürece varsayılan hesaptan geçer. Varsayılanı değiştirmek için:

1. Hesaplar sayfasında varsayılan yapmak istediğiniz hesaba tıklayın.
2. Hesap sayfasının altındaki Varsayılan ata düğmesine tıklayın.

Düğme yalnızca varsayılan olmayan hesaplarda görünür; varsayılan hesapta yerinde Varsayılan hesap yazar. Çalışma alanının her zaman tek bir varsayılan hesabı vardır.

not

Çalışma alanının planı eklenebilecek ödeme hesabı sayısını sınırlar. Sınıra ulaşıldığında Hesap Ekle düğmesi yerine izin verilen sayı gösterilir.

Modülleri açmak

Sipariş, ödeme linki, abonelik ve kayıtlı kart uçları birer modüle bağlıdır: Siparişler, Link ile Ödeme, Abonelikler, Kayıtlı Kartlar. Yeni bir çalışma alanında modüllerin hepsi kapalıdır; panelde Modüller sayfasından açılır. Planınızın kapsadığı ama açılmamış bir modülün uçları 403 döner: Çalışma alanınızda bu modül kapalı; panelde Modüller sayfasından açılabilir. Abonelik açmak için Kayıtlı Kartlar modülü de açık olmalıdır.

Token'ları almak

Ödeme hesabı token'ları ile API anahtarı, gizli anahtar ve Çalışma Alanı Kimliği Genel Ayarlar → Entegrasyon sayfasındadır. Her değerin yanındaki düğme değeri panoya kopyalar.

Sayfadaki bölüm	API'de
API Anahtarı	X-Api-Key başlığı
Gizli Anahtar	İstek imzası; hiçbir istekte gönderilmez
Çalışma Alanı	Adresteki {team}
Ödeme Hesapları	Gövdedeki payment_provider_token (isteğe bağlı)

Alanların ayrıntısı için Kimlik Bilgileri sayfasına bakın.