1. Ödeme Durumu Sorgulama
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
      POST
  • Taksitler & Komisyonlar
    • Taksit Bilgisi Sorgulama
      POST
    • Komisyon Bilgisi Sorgulama
      POST
    • Üye İşyeri Taksit Bilgisi Sorgulama
      POST
  • HASH
    • Hash Oluşturma
    • Hash Doğrulama
  • Kayıtlı Kart ile Ödeme
    • 3D Secure Kart Token ile Ödeme
    • Kart Kaydetme
    • Kayıtlı Kart Bilgilerini Sorgulama
    • Kayıtlı Kart Düzenleme
    • Kayıtlı Kart Silme
    • Non-Secure Kart Token ile Ödeme
  • 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. Ödeme Durumu Sorgulama

Durum Sorgulama

Testing
POST
/ccpayment/api/checkstatus
Bu endpoint, bir işlemin durumunu kontrol etmek için kullanılmaktadır. Üye işyerlerinin, bir ödemenin başarıyla tamamlanıp tamamlanmadığını, beklemede olup olmadığını veya başarısız sonuçlanıp sonuçlanmadığını doğrulamasını sağlar.
Bu endpoint kullanılarak, sağlanan işlem bilgilerine göre işlemin güncel durumu gerçek zamanlı olarak alınabilir. Bu sayede ödeme takibinin doğru şekilde yapılması ve ödeme sürecinin nihai sonucunun sistem üzerinden güvenilir bir şekilde doğrulanması sağlanır.

Hash key değeri istekte gönderilmelidir.
Örnek hash key değerleri, seçilen programlama diline göre sağ tarafta yer alan istek örnekleri panelinde bulunmaktadır.

Hash Parametreleri#

hash algoritması içerisinde kullanılacak parametreler ve kullanım sıraları aşağıdaki gibidir.
invoice_id
merchant_key
app_secret

Request

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

Examples

Responses

🟢200Success
application/json
Bodyapplication/json

⚪68Failed
🔵32Invalid Invoice ID
Request Request Example
Shell
JavaScript
Java
Swift
#!/usr/bin/env bash

 

generate_hash_key() {
  local invoice_id="$1"
  local merchant_key="$2"
  local app_secret="$3"

 

  local data="${invoice_id}|${merchant_key}"

 

  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"
}

 

invoice_id=""
merchant_key=""
app_secret=""

 

result=$(generate_hash_key "$invoice_id" "$merchant_key" "$app_secret")
echo "Hash Key: $result"
Response Response Example
200 - Pending Status
{
    "status_code": 69,
    "status_description": "Oder is not processed yet!",
    "transaction_status": "Pending",
    "order_id": "VP17695169711851953",
    "transaction_id": "VSu7l-NpEs-TC10-18309-270126",
    "message": "Oder is not processed yet!",
    "reason": "User did not complete the process",
    "bank_status_code": "",
    "bank_status_description": "",
    "invoice_id": "1234tsd122349",
    "total_refunded_amount": 0,
    "product_price": "5",
    "transaction_amount": 5,
    "ref_number": "",
    "transaction_type": "Auth",
    "original_bank_error_code": "",
    "original_bank_error_description": "",
    "cc_no": "45080345****4509",
    "refund_info": [],
    "payment_reason_code": "",
    "payment_reason_code_detail": "",
    "merchant_commission": "0.10",
    "user_commission": "0.00",
    "settlement_date": "2026-01-27",
    "installment": 1,
    "card_type": "CREDIT CARD"
}
Modified at 2026-07-10 13:46:17
Previous
Ödeme Durumu Sorgulama
Next
Taksitler & Komisyonlar
Built with