3D Secure Tekrarlayan Ödeme
Testing
POST
/ccpayment/api/paySmart3D
order_type parametresi 1 olarak gönderilmeli ve aşağıdaki parametreler boş bırakılmamalıdır:order_type
Zorunlu
Tip: Integer
Değer: 1Sipariş tipini belirler.
Tip: Integer
Değer: 1
recurring_payment_number
Zorunlu
Tip: IntegerToplam tekrarlayan ödeme sayısını belirtir. Örnek:
İlk ödeme tutarı 100 USD ve Her işlem için ek işlem ücretleri uygulanabilir.
Tip: Integer
İlk ödeme tutarı 100 USD ve
recurring_payment_number değeri 5 olarak gönderilirse, toplam işlem tutarı 100 USD × 5 = 500 USD olacaktır.recurring_payment_cycle
Zorunlu
Tip: StringTekrarlayan ödeme periyodunun birim tipini belirtir. Olası değerler: D → Gün
M → Ay
Y → Yıl
Tip: String
M → Ay
Y → Yıl
recurring_payment_interval
Zorunlu
Tip: StringSeçilen periyot tipine göre tekrarlayan ödeme sıklığını belirler. Örnek:
Bu değerler, ödemenin her ay tahsil edileceği anlamına gelir.
Tip: String
recurring_payment_cycle = Mrecurring_payment_interval = 1recurring_web_hook_key
Zorunlu
Tip: StringTekrarlayan ödeme durumlarıyla ilgili bildirimlerin sisteminize iletilmesi için kullanılan anahtardır. Bu anahtar Sipay panel üzerinden alınabilir.
Tip: String
Hash key değeri istekte gönderilmelidir.
Request
Body Params application/jsonRequired
Responses
Request Request Example
Shell
JavaScript
Java
Swift
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)
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"Response Response Example
200 - Success
{
"sipay_status": "1",
"order_no": "VP17768537044151193",
"order_id": "VP17768537044151193",
"invoice_id": "FPSFD18IVEODV2Z-1776853703",
"status_code": "100",
"status_description": "Payment Successfully Completed",
"sipay_payment_method": "1",
"credit_card_no": "554960****6017",
"transaction_type": "Auth",
"payment_status": "1",
"payment_method": "1",
"error_code": "100",
"error": "Payment Successfully Completed",
"auth_code": "674910",
"merchant_commission": "0.02",
"user_commission": "0",
"merchant_commission_percentage": "1",
"merchant_commission_fixed": "0",
"installment": "1",
"amount": "2",
"payment_reason_code": null,
"payment_reason_code_detail": null,
"hash_key": "b870ca0d31b19848:67af:W+FPwXGs8LmTEkThkEdcxkcQujsxarqXeWYx1mdu26645y2hss6Lbapbvaci7U4zFKu9Bpf9wyk4tQ2K90JRvA3W__Q3S9hVPfw==",
"md_status": "1",
"original_bank_error_code": null,
"original_bank_error_description": null,
"host_reference_id": null
}Modified at 2026-07-10 12:24:33