v1

latestOpenAPI 3.0.32026-07-232073105.4 KB
Installment

Taksit Sorgulama

API, taksit sayısı, oranları ve tutarlarının yanı sıra; kartın bankası, kart ailesi ve kart şeması gibi özelliklerini sağlar. Belirtilen BIN ve tutar bilgisine göre uygun taksit seçeneklerini listeler. Ayrıca yalnızca BIN veya yalnızca tutar bilgisiyle de taksit oranları sorgulanabilir.

post/payment/iyzipos/installment

Headers

Authorizationstring required

Authorization header, IYZWSv2 ile başlayan ve base64 formatında üretilmiş imzalı hash değeridir.

Content-Typestring required

Content-Type değeri.

Request body

locale'tr' | 'en'

İstek ve dönüş mesajlarında kullanılacak dil bilgisi.

pricenumber required

Taksit hesaplaması yapılacak tutar.

binNumberstring

8 Haneli kart BIN’i. Gönderilirse kart/banka bazında uygunluk döner. Gönderilemezse tutara göre taksit oranları alınabilir.

conversationIdstring

İstek/yanıt eşleştirme ID’si. İstekte gönderilen değer, response'da aynen geri döner.

Response

Başarılı yanıt

status'success' | 'failure'

Yapılan isteğin sonucu.

localestring

Yanıt dili.

systemTimeinteger

İşlem zamanı (epoch ms).

conversationIdstring

İstek ile eşleşen ID.