Ana içeriğe geç

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.

BilgiBiçimNerede kullanılır
API Anahtarıkey_ + 40 karakterHer istekte X-Api-Key başlığında.
Gizli Anahtarsecret_ + 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ği10 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 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.

Ö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), ö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.