3D Secure Kart Token ile Ödeme

Kayıtlı Kart ile Ödeme servisi, daha önce kaydedilmiş karta ait card_token kullanılarak ödeme yapılmasını sağlar. Bu yöntemde hassas kart bilgilerinin yeniden gönderilmesine gerek kalmaz.

Ödeme isteği, üye işyerinin sunucusundan Sipay ödeme entegrasyon sistemine sunucudan sunucuya (server-to-server) gönderilir. 3D Secure doğrulaması gerekiyorsa, Sipay’in yanıtında iletilen bilgiler doğrultusunda üye işyeri tarafından 3D Secure doğrulama akışı başlatılır.

Doğrulama; SMS ile gönderilen tek kullanımlık şifre (OTP), mobil bankacılık uygulaması veya banka tarafından sunulan diğer 3D Secure yöntemleriyle gerçekleştirilebilir.

Ödeme sonucuna göre kullanıcı yönlendirmeleri üye işyeri tarafından yönetilir. Ödeme başarılı olduğunda kullanıcı return URL adresine, işlem başarısız olduğunda veya iptal edildiğinde ise cancel URL adresine yönlendirilir.

Kart token ile ödeme başlatma istekleri, üye işyerinin sunucusundan server-to-server olarak gönderilmelidir. Erişim token’ı Authorization: Bearer {token} başlığında iletilmeli ve yalnızca sunucu tarafında tutulmalıdır. Standart HTML formları bu başlığı desteklemez; token form alanlarına eklenmemelidir.

Hash key istekte gönderilmelidir.

Örnek hash key değerleri, seçilen programlama diline karşılık gelen yan taraftaki Request alanında bulunabilir.

Hash algoritmasına ait örnek implementasyon istekte yer almaktadır.

Hash Parametreleri

hash algorithm içerisinde kullanılacak parametreler ve sıralaması aşağıdaki gibidir.
total
installment
currency_code
merchant_key
invoice_id
app_secret

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

#!/usr/bin/env bash generate_hash_key() { local total="$1" local installment="$2" local currency_code="$3" local merchant_key="$4" local invoice_id="$5" local app_secret="$6" local data="${total}|${installment}|${currency_code}|${merchant_key}|${invoice_id}" local rand1 rand1=$(openssl rand -hex 16) local iv iv=$(printf "%s" "$rand1" | openssl sha1 | awk '{print $2}' | cut -c1-16) local password password=$(printf "%s" "$app_secret" | openssl sha1 | awk '{print $2}') local rand2 rand2=$(openssl rand -hex 16) local salt salt=$(printf "%s" "$rand2" | openssl sha1 | awk '{print $2}' | cut -c1-4) local salt_with_password salt_with_password=$(printf "%s" "${password}${salt}" | openssl sha256 | awk '{print $2}' | cut -c1-32) # Python kodunda key ve iv doğrudan ASCII byte olarak veriliyor. local key_hex key_hex=$(printf "%s" "$salt_with_password" | xxd -p -c 256) local iv_hex iv_hex=$(printf "%s" "$iv" | xxd -p -c 256) local encrypted_base64 encrypted_base64=$(printf "%s" "$data" | openssl enc -aes-256-cbc -K "$key_hex" -iv "$iv_hex" -base64) local msg_encrypted_bundle="${iv}:${salt}:${encrypted_base64}" msg_encrypted_bundle="${msg_encrypted_bundle//\//__}" echo "$msg_encrypted_bundle" } total="100" installment="1" currency_code="TRY" merchant_key="merchant_key" invoice_id="invoice_id" app_secret="app_secret" result=$(generate_hash_key "$total" "$installment" "$currency_code" "$merchant_key" "$invoice_id" "$app_secret") echo "$result"

Hash Parametreleri#

Request

Responses

Hash Parametreleri