kt.hgs

HGS servisleri · 3 uç nokta

Asenkron istemcide (AsyncKuveytTurk) aynı metotlar await ile çağrılır. Her metot ayrıca extra_query, extra_body ve request_options kabul eder (ayrıntı).

Metot	İstek	Akış	Sandbox	Canlı
hgs_balance_information	POST /v1/hgs/balance-info	CC	kısmen test edildi	test edilmedi
hgs_product_information	POST /v1/hgs/product-info	CC	kısmen test edildi	test edilmedi
hgs_usage_transactions	POST /v1/hgs/usage-transactions	CC	kısmen test edildi	test edilmedi

hgs_balance_information

HGS Balance Information · POST /v1/hgs/balance-info · kapsam public · client credentials

This API takes plate and HGS barcode numbers as request parameters and returns the HGS balance information in detail. The response includes barcode number, balance, system date, and transaction status information.

yanit = kt.hgs.hgs_balance_information(plate_no=..., barcodeno=...)

Ortam	Durum	Sonuç	Tarih
Sandbox	kısmen test edildi	erişilebilir, parametre/iş kuralı hatası — MessageResourceError:Message_PaymentSystems.PlateNoAndBarcodeNotMatch	2026-10-04
Canlı	test edilmedi	henüz denenmedi

Parametre	API'deki adı	Yer	Tür	Zorunlu	Açıklama
plate_no	plateNo	gövde	metin	evet	Represents the plate number of the vehicle.
barcodeno	barcodeno	gövde	metin	evet	Represents the HGS barcode number.

Yanıt alanları (dokümana göre): barcodeNo, Status, balance, systemDate

Resmî doküman

hgs_product_information

HGS Product Information · POST /v1/hgs/product-info · kapsam public · client credentials

This API takes plate number and HGS barcode number as request parameters and returns the product details of the related HGS barcode. The response includes barcode number, plate number, balance, product status, cancellation date, sales date, vehicle class, and payment type information.

yanit = kt.hgs.hgs_product_information(plate_no=..., barcodeno=...)

Ortam	Durum	Sonuç	Tarih
Sandbox	kısmen test edildi	erişilebilir, parametre/iş kuralı hatası — MessageResourceError:Message_PaymentSystems.PlateNoAndBarcodeNotMatch	2026-10-04
Canlı	test edilmedi	henüz denenmedi

Parametre	API'deki adı	Yer	Tür	Zorunlu	Açıklama
plate_no	plateNo	gövde	metin	evet	Represents the plate number of the vehicle.
barcodeno	barcodeno	gövde	metin	evet	Represents the HGS barcode number.

Yanıt alanları (dokümana göre): barcodeNo, plateNo, balance, productStatusDescription, cancelDate, salesDate, vehicleClass, paymentType

Resmî doküman

hgs_usage_transactions

HGS Usage Transactions · POST /v1/hgs/usage-transactions · kapsam public · client credentials

This API returns HGS usage transaction information for the customer. It takes plate number, HGS barcode number, start date, and end date as request parameters. The response includes order number, entry and exit date/time, entry and exit locations, description, and amount information.

yanit = kt.hgs.hgs_usage_transactions(plate_no=..., barcode_no=..., start=..., end=...)

Ortam	Durum	Sonuç	Tarih
Sandbox	kısmen test edildi	erişilebilir, parametre/iş kuralı hatası — MessageResourceError:Message_PaymentSystems.PlateNoAndBarcodeNotMatch	2026-10-04
Canlı	test edilmedi	henüz denenmedi

Parametre	API'deki adı	Yer	Tür	Zorunlu	Açıklama
plate_no	plateNo	gövde	metin	evet	Represents the plate number of the vehicle.
barcode_no	barcodeNo	gövde	metin	evet	Represents the HGS barcode number.
start	start	gövde	metin	evet	Represents the start date for querying HGS usage transactions.
end	end	gövde	metin	evet	Represents the end date for querying HGS usage transactions.

Yanıt alanları (dokümana göre): OrderNo, entryDateTime, exitDateTime, entryLocation, exitLocation, description, amount

Resmî doküman