Kimlik Bilgileri
Entegrasyon için gereken bilgilerin hepsi panelin Entegrasyon sayfasındadır. Henüz ödeme hesabı yoksa önce Panel Kurulumu sayfasındaki adımları izleyin.
| 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/... |
| Ö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
401ile reddedilir. - Entegrasyon sayfasından anahtar çifti yenilenebilir. Yenileme anında eski anahtar ve eski gizli anahtar geçersiz olur; eski çifti kullanan istekler
401alır.
Ö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_tokengö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
422ile 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), ödeme linki (payment_link.token), link ödemesi (link_payment.token), abonelik (subscription.token), kayıtlı kart (saved_card.token) ve ödeme hesabı. Sizin sisteminizdeki kimlikler reference ve customer.reference alanlarında gönderilir; müşteriler yalnızca customer.reference ile anılır.