3D Secure Card Payment
Testing
Testing Env
https://provisioning.sipay.com.tr
Testing Env
https://provisioning.sipay.com.tr
POST
/ccpayment/api/paySmart3D
After submitting the payment form (HTML) on the merchant website, the user is redirected to the bank's 3D Secure page, where the payment is verified using an SMS code. Upon successful payment, the user is redirected to the success URL specified by the merchant. If the payment is unsuccessful or cancelled, the user is redirected to the cancellation URL specified by the merchant.
The /api/paySmart3D endpoint must be accessed via an HTML form submission.
Response Details:
In order to withdraw the blocked amount from the card,
Complete Payment Endpoint and Confirm Payment Endpoint must be called.
The hash key must be sent in the request.
Request
Body Params application/jsonRequired
Responses
Request Request Example
Shell
JavaScript
Java
Swift
HASH
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": "VP17749690188158024",
"order_id": "VP17749690188158024",
"invoice_id": "7PAXU5D2IMBQ3KD-1774969017",
"status_code": "100",
"status_description": "Payment Successfully Completed",
"sipay_payment_method": "1",
"credit_card_no": "450803****4509",
"transaction_type": "Auth",
"payment_status": "1",
"payment_method": "1",
"error_code": "100",
"error": "Payment Successfully Completed",
"auth_code": "P54802",
"merchant_commission": "0.1",
"user_commission": "0",
"merchant_commission_percentage": "1",
"merchant_commission_fixed": "0",
"installment": "1",
"amount": "5",
"payment_reason_code": null,
"payment_reason_code_detail": null,
"hash_key": "7fa34583e3b2dd60:32f6:6sEV__qFOEiSvNHEVXCW4EJaJvD+dzeQzqoKiQG0kEDADdcGcrniJFJh5jdM+r2aBAMkOn71VUffdxEZ9BaEpUg==",
"md_status": "1",
"original_bank_error_code": null,
"original_bank_error_description": null,
"host_reference_id": "609000105269"
}