Kimlik Bilgileri

Entegrasyon için gereken bilgilerin hepsi panelin Entegrasyon sayfasındadır.

Bilgi	Biçim	Nerede kullanılır
API Anahtarı	key_ + 40 karakter	Her istekte X-Api-Key başlığında.
Gizli Anahtar	secret_ + 40 karakter	İstek imzasını üretmek ve yanıt/webhook imzasını doğrulamak için. Hiçbir istekte gönderilmez.
Çalışma Alanı Kimliği	10 haneli sayı	Adreste: /api/{team}/gateway/...
Kanal token'ı	UUID	İstek gövdesinde channel_token alanında.
Ödeme hesabı token'ı	UUID	İsteğe bağlı; gövdede payment_provider_token alanında.

API anahtarı ve gizli anahtar

• Bir anahtar çifti tek bir çalışma alanına aittir. API anahtarı, adresteki çalışma alanına ait değilse istek 401 ile reddedilir.
• Entegrasyon sayfasından anahtar çifti yenilenebilir. Yenileme anında eski anahtar ve eski gizli anahtar geçersiz olur; eski çifti kullanan istekler 401 alır.

Kanal

Kanal, müşterinin size ulaştığı satış noktasıdır (web sitesi, mobil uygulama vb.). Kanallar panelde tanımlanır ve istekte token'ıyla adlandırılır.

• channel_token, bulunduğu her uçta zorunludur ve çalışma alanınıza ait bir kanalın token'ı olmalıdır; değilse istek 422 ile reddedilir.
• Müşteriler ve ürünler kanal içinde adlandırılır: aynı kanalda aynı channel_reference, aynı müşteri ya da aynı üründür.
• SDK'larda kanal token'ı yapılandırmada bir kez verilir; istek bazında değiştirilebilir.

Ödeme hesabı

Ödeme hesabı, ödemenin geçeceği sağlayıcı hesabıdır. Panelde tanımlanır ve istekte payment_provider_token ile adlandırılır.

• payment_provider_token gönderilirse istek o hesaptan geçer.
• Gönderilmezse çalışma alanının panelde tanımlı yönlendirme kuralları ve varsayılan ödeme hesabı kullanılır. Ayrıntılar: Ödeme hesabı seçimi.
• Varsayılan ödeme hesabı yoksa ve istekte hesap gönderilmediyse istek 422 ile reddedilir.

Token'lar

Gateway'in döndürdüğü bütün kimlikler UUID biçiminde token'dır: işlem (transaction.token), sipariş (order.token), abonelik (subscription.token), kayıtlı kart (saved_card.token). Sizin sisteminizdeki kimlikler ise channel_reference alanlarında gönderilir.