Skip to main content

​
🚀 Checkout/Link/QR Ödemesi Başlatma

Checkout oturumu oluşturur ve token döner. Bu token ile müşteri ödeme sayfasına yönlendirilir. POST https://api-test.fincraft.com.tr/api/v1/checkout/process

​
Request Body

{
    "referenceId": "{{$guid}}",
    "amount": 100,
    "currency": "TRY",
    "clientIpAddress": "1.1.1.1",
    "phoneNumber": "+905551234567",
    "tokenExpireTimeInMillis": 600000,
    "products": [
        {
            "name": "Test Product 1",
            "price": 50,
            "externalId": "1",
            "subMerchantMemberId": "EXT1234567"
        },
        {
            "name": "Test Product 2",
            "price": 50,
            "externalId": "2",
            "subMerchantMemberId": "EXT1234567"
        }
    ]
}

​
Request Parametreleri

ParametreTipZorunluValidationAçıklama
referenceIdUUIDEvet-Referans kimliği, 3D complete, sorgulama, iade vs işlemleri için kullanılır
phoneNumberStringHayır-Müşteri telefon numarası
tokenExpireTimeInMillisLongHayır-Token geçerlilik süresi (milisaniye). Default: 3600000 (1 saat)
productsListEvet@NotEmpty, @ValidSatın alınan ürünlerin listesi. En az 1 ürün olmalıdır.

​
Response Body

{
    "status": "INIT",
    "systemTime": 1760110755,
    "locale": "TR",
    "referenceId": "367f8c72-487a-4aba-a7b4-3220e74d9ee0",
    "token": "e3efc47d-ddeb-471e-bf31-43c8a58b1c4d",
    "tokenExpireTimeInMillis": 600000,
    "fullPageUrl": "https://checkout-dev.fincraft.com.tr/checkout?token=e3efc47d-ddeb-471e-bf31-43c8a58b1c4d",
    "qrCodeUrl": "https://api-test.fincraft.com.tr/api/v1/qr/62f04494-4960-4d85-9e8e-891873e0cb36"
}

​
cURL Örneği

curl -X POST https://api-test.fincraft.com.tr/api/v1/checkout/process \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "referenceId": "{{$guid}}",
    "amount": 100,
    "currency": "TRY",
    "clientIpAddress": "1.1.1.1",
    "phoneNumber": "+905551234567",
    "tokenExpireTimeInMillis": 600000,
    "products": [
        {"name": "Test Product 1", "price": 50, "externalId": "1"},
        {"name": "Test Product 2", "price": 50, "externalId": "2"}
    ]
  }'
Önemli Notlar
  • Checkout token tek kullanımlıktır (başarılı ödeme sonrası tekrar kullanılamaz)
  • Token süresi dolmadan ödeme tamamlanmalıdır
  • Her checkout için yeni token oluşturulmalıdır
  • Status SUCCESS veya WAITING olan checkout’lar tekrar kullanılamaz