1. Kayıtlı Kart ile Ödeme
Sipay API Documentation
TR
  • EN
  • TR
  • Genel Bakış
    • Başlangıç
    • Test Kartları
  • Kimlik Doğrulama
    • Token Oluşturma
      POST
  • Non-Secure Ödeme
    • Non-Secure Ödeme Akışı
    • Non-Secure Kart Ödemesi
      POST
    • Non-Secure Tekrarlayan Ödeme
      POST
    • Non-Secure Sigorta Ödemesi
      POST
    • Non-Secure Ön Provizyon Ödemesi
      POST
    • Ödeme Onaylama
      POST
  • 3D Secure Ödemesi
    • 3D Secure Ödeme Akışı
    • 3D Secure Kredi Kart Ödemesi
      POST
    • 3D Secure Tekrarlayan Ödeme
      POST
    • 3D Secure Ön Provizyon Ödemesi
      POST
    • Ödeme Tamamlama
      POST
    • Ödeme Onaylama
      POST
    • 3D Secure Tarım Ödemesi
      POST
  • Sipay ile Non-Secure ve 3D Ödeme
    • Purchase Link Örneği
    • Sipay ile Non-Secure ve 3D Secure Ödeme
      POST
  • Ödeme Durumu Sorgulama
    • Durum Sorgulama
  • Taksitler & Komisyonlar
    • Taksit Bilgisi Sorgulama
    • Komisyon Bilgisi Sorgulama
    • Üye İşyeri Taksit Bilgisi Sorgulama
  • HASH
    • Hash Oluşturma
    • Hash Doğrulama
  • Kayıtlı Kart ile Ödeme
    • 3D Secure Kart Token ile Ödeme
      POST
    • Kart Kaydetme
      POST
    • Kayıtlı Kart Bilgilerini Sorgulama
      GET
    • Kayıtlı Kart Düzenleme
      POST
    • Kayıtlı Kart Silme
      POST
    • Non-Secure Kart Token ile Ödeme
      POST
  • Tekrarlayan Ödeme
    • Tekrarlayan Ödeme Sorgulama
    • Tekrarlayan Ödeme Plan Süreci
    • Tekrarlayan Ödeme Planı Güncelleme
  • İade
    • İade
  • Para Dağıtımı
    • Banka Hesabına Para Aktarımı
  • Webhook
    • Webhook
  • Hata Statü Kodları
    • Statü Kodları
  1. Kayıtlı Kart ile Ödeme

Kart Kaydetme

Testing
POST
/ccpayment/api/saveCard
Kart Kayıt endpoint'i, kart bilgilerinin Sipay sistemi içerisinde güvenli bir şekilde saklanmasını sağlar.
Başarılı bir kayıt işleminin ardından sistem, saklanan kart verilerini temsil eden benzersiz bir card_token oluşturur ve döner.
Bu token, sonraki ödeme işlemlerinde payByCardToken API üzerinden kullanılır ve hassas kart bilgilerinin tekrar gönderilmesi gerekliliğini ortadan kaldırır. Bu servis, ödeme süreçlerini daha hızlı ve verimli hale getirir, tekrarlayan işlemlerde kullanıcı deneyimini iyileştirir ve hassas kart bilgilerinin güvenli ve uyumlu standartlara uygun şekilde işlenmesini sağlar.
Hash key istekte gönderilmelidir.
Örnek hash key değerleri, seçilen programlama diline karşılık gelen yan taraftaki istek örnekleri 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.
merchant_key
customer_number
card_holder_name
expiry_month
expiry_year
app_secret

Request

Authorization
Bearer Token
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
or
Header Params

Body Params application/jsonRequired

Examples

Responses

🟢200Success
application/json
Bodyapplication/json

🟠400Failed
Request Request Example
Shell
JavaScript
Java
Swift
generate_save_card_create_hash_key() {
  local merchant_key="$1"
  local customer_number="$2"
  local card_holder_name="$3"
  local card_number="$4"
  local expiry_month="$5"
  local expiry_year="$6"
  local app_secret="$7"

  local data="${merchant_key}|${customer_number}|${card_holder_name}|${card_number}|${expiry_month}|${expiry_year}"

  local iv
  iv=$(openssl rand -hex 16 | openssl sha1 | awk '{print $2}' | cut -c1-16)

  local password
  password=$(printf "%s" "$app_secret" | openssl sha1 | awk '{print $2}')

  local salt
  salt=$(openssl rand -hex 16 | 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)

  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="${iv}:${salt}:${encrypted_base64}"
  msg="${msg//\//__}"

  echo "$msg"
}

result=$(generate_save_card_create_hash_key \
  "123456789" \
  "CUST001" \
  "AHMET YILMAZ" \
  "4111111111111111" \
  "12" \
  "2028" \
  "mySecretKey123")

echo "$result"
Response Response Example
200 - Success
{
    "status_code": 100,
    "status_description": "The card token saved successfully",
    "card_token": "3acb729f7341c4fa4971a5b81b76189e"
}
Modified at 2026-07-10 13:55:19
Previous
3D Secure Kart Token ile Ödeme
Next
Kayıtlı Kart Bilgilerini Sorgulama
Built with