3D Secure Ödeme Başlat

🔐 3D Secure Ödeme Başlat (3D Secure Init)

3D Secure güvenlik protokolü ile ödeme işlemini başlatır. Kullanıcıya banka tarafından gönderilen HTML form döndürülür. POST https://api-test.fincraft.com.tr/api/v1/payments/3d/init

3D Secure Özellikleri

Visa Secure, Mastercard SecureCode, Amex SafeKey desteği
SMS, Email, Mobile App doğrulama yöntemleri
Risk bazlı kimlik doğrulama (Risk-Based Authentication)
Frictionless ve Challenge akışları
PCI DSS Level 1 uyumluluğu

Request Body

{
  "correlationId": "string",
  "referenceId": "uuid",
  "amount": 100.50,
  "finalAmount": 100.50,
  "walletAmount": 0.0,
  "installment": 1,
  "clientIpAddress": "192.168.1.1",
  "walletMemberId": "string",
  "currency": "TRY",
  "transactionType": "AUTH",
  "card": {
    "cardHolderName": "John Doe",
    "cardNumber": "1234567890123456",
    "expireYear": "25",
    "expireMonth": "12",
    "cvc": "123"
  },
  "products": [
    {
      "name": "Ürün Adı",
      "externalId": "string",
      "price": 100.50,
      "subMerchantPrice": 95.0,
      "subMerchantMemberId": "string"
    }
  ],
  "additionalParams": {},
  "callbackUrl": "https://example.com/callback",
  "additionalData": "{\"msisdn\":\"\"}",
  "bankOrderId": "string",
  "reward": null
}

Ek Parametreler (3D Secure için)

Parametre	Tip	Zorunlu	Validation	Açıklama
`callbackUrl`	String	Evet	@NotBlank, @URL	3D Secure doğrulama tamamlandıktan sonra kullanıcının yönlendirileceği URL. HTTPS olmalıdır.
`bankOrderId`	String	Hayır	-	İzin verilen terminallere iletilecek banka sipariş numarası. Zorunlu değildir; gönderilmediği durumda otomatik olarak üretilir.
`additionalData`	String	Hayır	-	Sağlayıcıya iletilecek ek veriler; JSON string beklenir. Örn (Paycell için): `{"msisdn":""}`.

Response Body (HTML Form)

<!DOCTYPE html>
<html>
<head>
    <title>3D Secure Doğrulama</title>
</head>
<body>
    <form id="3dsForm" method="POST" action="https://3dsecure.bank.com/verify">
        <input type="hidden" name="MD" value="merchant_data" />
        <input type="hidden" name="PaReq" value="payment_request" />
        <input type="hidden" name="TermUrl" value="https://api.fincraft.com.tr/callback" />
    </form>
    <script>
        document.getElementById('3dsForm').submit();
    </script>
</body>
</html>

cURL Örneği

curl -X POST https://api-test.fincraft.com.tr/api/v1/payments/3d/init \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "referenceId": "123e4567-e89b-12d3-a456-426614174000",
    "amount": 100.50,
    "finalAmount": 100.50,
    "walletAmount": 0.0,
    "installment": 1,
    "clientIpAddress": "192.168.1.1",
    "currency": "TRY",
    "transactionType": "AUTH",
    "callbackUrl": "https://yourdomain.com/payment/callback",
    "card": {
      "cardHolderName": "John Doe",
      "cardNumber": "1234567890123456",
      "expireYear": "25",
      "expireMonth": "12",
      "cvc": "123"
    },
    "products": [
      {
        "name": "Test Ürünü",
        "externalId": "PROD001",
        "price": 100.50
      }
    ]
  }'

Önemli Notlar

Callback URL mutlaka HTTPS olmalıdır
HTML form otomatik olarak submit edilir
3D Secure sadece destekleyen kartlarda çalışır
Doğrulama süresi genelde 5-10 dakikadır
Başarısız doğrulamalarda işlem otomatik iptal edilir

Başlangıç

Genel

Non-Secure Ödeme

3D Secure Ödeme

Ortak Ödeme/Link/QR

Sorgulamalar

İptal/İade

Provizyon

Ürün İşlemleri

Bayi İşlemleri

APM (Alternative Payment Method) ile Ödeme

3D Secure Ödeme Başlat

🔐 3D Secure Ödeme Başlat (3D Secure Init)

Request Body

Ek Parametreler (3D Secure için)

Response Body (HTML Form)

cURL Örneği

​🔐 3D Secure Ödeme Başlat (3D Secure Init)

​Request Body

​Ek Parametreler (3D Secure için)

​Response Body (HTML Form)

​cURL Örneği

🔐 3D Secure Ödeme Başlat (3D Secure Init)

Request Body

Ek Parametreler (3D Secure için)

Response Body (HTML Form)

cURL Örneği