İptal/İade

İade

post
/v2/terminal-host/gmu/payment/refund

Tamamlanmış bir satış işlemi için kısmi veya tam iade gerçekleştirilir. İade yapılabilecek kalemleri öğrenmek için önce İade Edilebilir Satış Bilgisi servisini çağırmanız önerilir.

Authorizations
AuthorizationstringRequired

Access token kullanılarak Bearer Token doğrulaması yapılır.

Header parameters
Content-TypestringRequired

İçerik tipi

Example: application/json
Body
localestringOptional

Dil kodu. Varsayılan TR

Example: TR
conversationIdstringOptional

Korelasyon ID

Example: ref-conv-001
deviceUniqueIdstringRequired

Cihaz benzersiz ID. Maksimum 64 karakter

Example: P00134
paymentIdstringRequired

Satış servisinden dönen paymentId

Example: PAY-9876543
paymentDateintegerRequired

Ödeme tarihi. YYYYMMDD formatında olmalıdır

Example: 20260406
transactionReferenceIdstringRequired

Bu iade işlemine ait referans ID

Example: REF-REFUND-001
saleAppNamestringRequired

Satış uygulaması adı

Example: MyPOS
saleAppVersionstringRequired

Satış uygulaması versiyonu

Example: 1.0.0
notificationPhonestringOptional

SMS bildirimi istenilen telefon numarası

Example: 5551234567
notificationEmailstringOptional

Bildirim istenilen E-posta adresi

Example: [email protected]
Responses
chevron-right
200

Başarılı iade sonucu

application/json
statusstringOptional

success veya failure

Example: success
errorCodestringOptional

Hata kodu

Example: 0
errorMessagestringOptional

Hata mesajı

Example: Hata mesajı
conversationIdstringOptional

Korelasyon ID

Example: ref-conv-001
systemTimeintegerOptional

Zaman damgası epoch ms

Example: 1743980400000
deviceUniqueIdstringOptional

İşlem yapılan cihaz ID

Example: P00134
transactionReferenceIdstringOptional

İade işlemine ait referans ID

Example: REF-REFUND-001
pricedecimalOptional

İade tutarı

Example: 118
vatAmountdecimalOptional

KDV tutarı

Example: 18
currencystringOptional

Para birimi

Example: TRY
invoiceNostringOptional

Fatura numarası

Example: INV-001
authCodestringOptional

Onay kodu

Example: 123456
hostReferencestringOptional

Host referans numarası

Example: HOST-REFUND-001
binNumberstringOptional

Kartın BIN numarası

Example: 454671
lastFourDigitsstringOptional

Kartın son 4 hanesi

Example: 1234
acquirerNamestringOptional

Acquirer banka adı

Example: Bank A
acquirerIdstringOptional

Acquirer banka ID

Example: 12
batchNostringOptional

Batch numarası

Example: 001
post
/v2/terminal-host/gmu/payment/refund

İptal

post
/v2/terminal-host/gmu/payment/void

Aynı gün içinde gerçekleştirilen bir ödeme işlemini iptal eder. Gün sonu yapılmış işlemlerde iptal yerine iade kullanılmalıdır.

Authorizations
AuthorizationstringRequired

Access token kullanılarak Bearer Token doğrulaması yapılır.

Header parameters
Content-TypestringRequired

İçerik tipi

Example: application/json
Body
localestringOptional

Dil kodu. Varsayılan TR

Example: TR
conversationIdstringOptional

Korelasyon ID

Example: void-conv-001
deviceUniqueIdstringRequired

Cihaz benzersiz ID. Maksimum 64 karakter

Example: P00134
paymentIdstringRequired

İptal edilecek ödemenin paymentId’si

Example: PAY-9876543
paymentDateintegerRequired

Ödeme tarihi. YYYYMMDD formatında olmalıdır

Example: 20260406
transactionReferenceIdstringRequired

Bu iptal işlemine ait referans ID

Example: REF-VOID-001
reasonstringOptional

İptal nedeni

Example: Müşteri talebi
descriptionstringOptional

Açıklama

Example: Ürün stoğu yok
Responses
chevron-right
200

Başarılı iptal sonucu

application/json
statusstringOptional

success veya failure

Example: success
errorCodestringOptional

Hata kodu

Example: 0
errorMessagestringOptional

Hata mesajı

Example: Hata mesajı
conversationIdstringOptional

Korelasyon ID

Example: void-conv-001
systemTimeintegerOptional

Zaman damgası epoch ms

Example: 1743980400000
deviceUniqueIdstringOptional

Cihaz ID

Example: P00134
transactionReferenceIdstringOptional

İptal referans ID

Example: REF-VOID-001
paymentIdstringOptional

İptal edilen ödeme ID

Example: PAY-9876543
pricedecimalOptional

İptal tutarı

Example: 118
currencystringOptional

Para birimi

Example: TRY
authCodestringOptional

Onay kodu

Example: 123456
hostReferencestringOptional

Orijinal işlemin host referans numarası

Example: HOST-001
cancelHostReferencestringOptional

İptal işlemine ait host referans numarası

Example: HOST-CANCEL-001
transactionDatestringOptional

İşlem tarihi

Example: 2026-04-06
transactionTimestringOptional

İşlem saati

Example: 10:00:00
paymentDateintegerOptional

Ödeme tarihi. YYYYMMDD formatındadır

Example: 20260406
transactionDateTimestringOptional

İşlem tarih ve saat bilgisi

Example: 2026-04-06 10:00:00
binNumberstringOptional

Kartın BIN numarası

Example: 454671
lastFourDigitsstringOptional

Kartın son 4 hanesi

Example: 1234
post
/v2/terminal-host/gmu/payment/void

İade Edilebilir Satış Bilgisi Alma

post
/v2/terminal-host/gmu/payment/refundable-sale-info

Belirtilen işlem referansına ait satışın iade edilebilir kalem ve tutar bilgisini döndürür. İade işleminden önce çağrılması önerilir; dönen saleUid değeri iade isteğinde relatedSaleId olarak kullanılır.

Authorizations
AuthorizationstringRequired

Access token kullanılarak Bearer Token doğrulaması yapılır.

Header parameters
Content-TypestringRequired

İçerik tipi

Example: application/json
Body
localestringOptional

Dil kodu

Example: TR
conversationIdstringOptional

Korelasyon ID

Example: rsi-conv-001
deviceUniqueIdstringOptional

Cihaz benzersiz ID

Example: P00134
transactionReferenceIdstringRequired

Orijinal satış işleminin referans ID'si

Example: REF-12345
Responses
chevron-right
200

Başarılı iade edilebilir satış bilgisi sonucu

application/json
statusstringOptional

success veya failure

Example: success
errorCodestringOptional

Hata kodu

Example: 0
errorMessagestringOptional

Hata mesajı

Example: Hata mesajı
conversationIdstringOptional

Korelasyon ID

Example: rsi-conv-001
systemTimeintegerOptional

Zaman damgası epoch ms

Example: 1743980400000
saleNumberstringOptional

Satış numarası

Example: SN-001
saleUidstringOptional

Satışın benzersiz ID'si. İade isteğinde relatedSaleId olarak kullanılır.

Example: SALE-001
totalReturnableAmountdecimalOptional

Toplam iade edilebilir tutar

Example: 118
currencystringOptional

Para birimi

Example: TRY
post
/v2/terminal-host/gmu/payment/refundable-sale-info

Last updated