Cancelling
You cancel a whole booking in a single call. The API cancels the full booking and emails the confirmation on its own.
All cancellation requests are approved, and the associated tickets are cancelled within the cancellationTimeLimit period. The refund amount, however, differs depending on the agreed policies with SAR.
Send the cancel
Call OTA_CancelRQ with the W1 record locator in uniqueID (type 14) and set cancelType to Commit.
What comes back
The response returns status CANCELLED for the same locator.
The railway sends the cancellation email to the CTC contact automatically. You do not send it yourself. If the traveler needs it again, resend it.
This covers full cancellation, which is what production supports. For the complete request and response, see the GO7 cancel_booking page.
How is the refund amount determined?
The refund amount is calculated based on the fare and cancellation policies agreed with SAR. This includes the refund amount, the refund percentage, and any other refund-related terms defined in that agreement. The system checks those rules for your agency on every cancellation and applies the matching one.
You are responsible for refunding your clients. The refunded amount is credited to your wallet. Returning that amount to your clients is your responsibility, not SAR’s.
SAR credits the refund to your wallet. You are responsible for passing it on to your clients.
Read the penalty before you cancel
The booking tells you what a cancellation costs, so you can show the traveler the charge before you commit. Every booking response, and OTA_ReadRQ, carries the penalty rules for each segment under fareInfos.fareInfo[].ruleInfo.chargesRules. The ones that matter are in voluntaryRefunds.TPA_Extensions.penaltyRules.
Rules are grouped by passenger type, so an adult, a child, and an infant can each carry a different charge. Within a group, each rule covers one time window. Find the rule whose window contains the moment you cancel and show its total.
The same block also carries voluntaryChanges.TPA_Extensions.penaltyRules. The railway returns it for reference only: voluntary changes to a ticketed journey are not supported, so do not offer them. A segment that has been cancelled carries no rule information at all.

