Ana içeriğe geç

Booking Cancel API

Bu yöntem, mevcut bir rezervasyonu iptal etmek için kullanılır.

📍 Endpoint

POST https://mg.mescogo.com/gw/api/booking/cancel
ÖzellikDeğer
URIBaseURL/api/booking/cancel
MethodPOST
Content-Typeapplication/json

📋 Request Parametreleri

ParametreTipAçıklama
ConfirmationNumberStringİptal edilecek rezervasyonun onay numarası

🔐 Yetkilendirme

Bu uç nokta, diğer booking endpointleriyle aynı API istemci kimlik bilgilerini kullanan bir Basic Authorization başlığı gerektirir.

📤 Örnek Request

{
"ConfirmationNumber": "1531561"
}

📥 Başarılı Response

{
"Status": {
"Code": 200,
"Description": "Canceled"
},
"ConfirmationNumber": "1531561"
}

📥 Response Parametreleri

ParametreTipAçıklama
StatusObjectYanıt durumu
Status.CodeIntegerAPI durum kodu
Status.DescriptionStringBaşarılı response açıklaması
ConfirmationNumberStringİstekte gönderilen onay numarası

⚠️ Hata Durumları

İşleme Hatası

İptal tamamlanamazsa veya işlem sırasında hata oluşursa API 200 HTTP ile aşağıdaki payload'i döndürür:

{
"StatusCode": 500,
"Message": "An error occurred during processing",
"Error": "An error occurred during processing"
}

Yetkilendirme Hatası

Basic Authorization başlığı eksik veya geçersiz olduğunda endpoint hata yanıtı döndürür:

{
"Status": {
"Code": 401,
"Description": "No Header in Authorization"
}
}

⚠️ Notlar

  • Başarılı yanıt CancellationStatus, CancellationCharge, RefundAmount ve Currency alanlarını içermez.
  • İptal akışı, bu endpointin yanıt şemasına göredir; onay numarası aktarımı dışında ek ödeme detayları döndürülmez.
  • Geçersiz API kimlik bilgileri 401 veya 404 ile hata yanıtı döner.