> ## Documentation Index
> Fetch the complete documentation index at: https://docs.orkesta.com.tr/llms.txt
> Use this file to discover all available pages before exploring further.

# Saklı Kart Kayıt Tamamla

> 3D Secure doğrulama sonrası saklı kart kaydını tamamlar ve token döner

## ✅ 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`

<Info>
  İş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.
</Info>

## Request Body

```json theme={null}
{
  "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](/fincraft/sakli-kart/sakli-kart-baslat) işleminde kullanılan referans ID'si. |

## Response Body

```json theme={null}
{
    "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. |

<Note>
  Response yapısı [3D Secure Ödeme Tamamla](/fincraft/3d-secure/3d-odeme-tamamla) ile aynıdır. Farklar: `transactionType` değeri `STORE_CARD` olur, ek olarak `token` alanı döner ve `products` alanı bulunmaz.
</Note>

## cURL Örneği

```bash theme={null}
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:

```json theme={null}
{
  "card": {
    "cardToken": "8604943011799428"
  }
}
```

<Warning>
  **Dikkat**: Saklı kart ile CVV'siz ödeme yapılabilmesi için kullanılan PSP'nin CVV'siz ödemeyi destekliyor olması gerekmektedir.
</Warning>

<Check>
  **Ö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.
</Check>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.