Saklı Kart Kayıt Tamamla

✅ Saklı Kart Kayıt Tamamla (Store Card 3D Complete)

3D Secure doğrulama sonrası saklı kart kayıt işlemini tamamlar. İşlem başarılı olduğunda saklı kart için kullanılacak token değeri response içerisinde döner. POST https://api-test.fincraft.com.tr/api/v1/payments/store-card/3d/complete

İşlem tipi STORE_CARD olarak döner. Doğrulama amaçlı çekilen 1 TL bu adım sonrasında otomatik olarak iade edilir. products alanı bu response’ta bulunmaz.

Request Body

{
  "referenceId": "123e4567-e89b-12d3-a456-426614174000"
}

Request Parametreleri

Parametre	Tip	Zorunlu	Validation	Açıklama
`referenceId`	UUID	Evet	@NotNull	Orijinal Saklı Kart Kayıt Başlat işleminde kullanılan referans ID’si.

Response Body

{
    "message": "Saklı kart başarıyla oluşturuldu",
    "response": {
        "cardDetails": {
            "cardHolderName": "Alper Tunç Erdur",
            "cardNumber": "100000****0016",
            "cardBrand": "BONUS",
            "cardBank": "TFKB",
            "cardSchema": "MASTERCARD"
        },
        "id": "25282QdQI07035348",
        "createdDate": "2025-10-09 16:29:16",
        "amount": 1.0,
        "finalAmount": 1.0,
        "walletAmount": 0.0,
        "currency": "TRY",
        "installment": 1,
        "correlationId": "CONV-1760016535238",
        "usedTerminalInfo": "ISBANK_CONFIG_1",
        "referenceId": "dc3a5902-df5e-47af-9fc0-31205b879fd3",
        "source": "API",
        "paymentStatus": "SUCCESS",
        "transactionType": "STORE_CARD",
        "authCode": "P82141",
        "hostReferenceNo": "528200439774",
        "transactionId": "25282QdQI07035348",
        "orderId": "f5acb745-8b97-4624-b919-0bec8a2b1c73",
        "bankCardHolderName": "Alper Tunç Erdur",
        "bankCode": "010",
        "token": "8604943011799428",
        "riskAssessment": "APPROVED"
    }
}

Response Parametreleri (Ek Alanlar)

Parametre	Tip	Açıklama
`transactionType`	String	Saklı kart kayıt işlemlerinde `STORE_CARD` değeri döner.
`token`	String	Saklı kart token değeri. Sonraki ödemelerde `card.cardToken` alanında bu değer kullanılır.

Response yapısı 3D Secure Ödeme Tamamla ile aynıdır. Farklar: transactionType değeri STORE_CARD olur, ek olarak token alanı döner ve products alanı bulunmaz.

cURL Örneği

curl -X POST https://api-test.fincraft.com.tr/api/v1/payments/store-card/3d/complete \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "referenceId": "dc3a5902-df5e-47af-9fc0-31205b879fd3"
  }'

Saklı Kart ile Ödeme

Kayıt işlemi tamamlandıktan sonra ödemelerde card alanına sadece cardToken değeri gönderilerek işlem yapılabilir:

{
  "card": {
    "cardToken": "8604943011799428"
  }
}

Dikkat: Saklı kart ile CVV’siz ödeme yapılabilmesi için kullanılan PSP’nin CVV’siz ödemeyi destekliyor olması gerekmektedir.

Önemli Notlar

referenceId ile orijinal init işlemi mutlaka bulunmalıdır.
Başarılı doğrulama sonrası çekilen 1 TL otomatik iade edilir.
Dönen token değeri güvenli bir şekilde saklanmalıdır.
Timeout durumunda işlem otomatik olarak iptal edilir.

Başlangıç

Genel

Non-Secure Ödeme

3D Secure Ödeme

Saklı Kart İşlemleri

Ortak Ödeme/Link/QR

Sorgulamalar

İptal/İade

Provizyon

Ürün İşlemleri

Bayi İşlemleri

APM (Alternative Payment Method) ile Ödeme

Saklı Kart Kayıt Tamamla