{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Transfer Orders"},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"transfer-orders","__idx":0},"children":["Transfer Orders"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Transfer order endpoints create reservations from search offers and manage them afterwards: retrieving the current"," ","state, checking cancellation eligibility, and canceling."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"create-order","__idx":1},"children":["Create Order"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Creates a transfer reservation from a search offer. The order starts in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pendingPayment"]}," status; the response contains"," ","the exact amount to pay in the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/endpoints/transfer-payment"},"children":["payment step"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"endpoint","__idx":2},"children":["Endpoint"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"POST /transfer/orders\n"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"authentication","__idx":3},"children":["Authentication"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This endpoint requires authentication. Include your JWT access token in the Authorization header:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"Authorization: Bearer YOUR_ACCESS_TOKEN\n"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"end-user-ip-address","__idx":4},"children":["End User IP Address"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Integrated agency systems must forward the end user's IP address via the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["X-Forwarded-For"]}," header. This information is"," ","required for audit and security purposes."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"request-body","__idx":5},"children":["Request Body"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Field"},"children":["Field"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Type"},"children":["Type"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Required"},"children":["Required"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["searchId"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Search identifier from the transfer search"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["code"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Selected offer code from the search results"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["passengers"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["array"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Passenger list; exactly one passenger must have ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["primary: true"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["billing"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["object"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Custom billing information (see Billing below)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["flightNumber"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Flight number for the outbound pickup (",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["strongly recommended"]}," for airport pickups)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["returnFlightNumber"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Flight number for the return pickup (round trips)"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"flight-number-strongly-recommended","__idx":6},"children":["Flight Number (Strongly Recommended)"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Provide ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["flightNumber"]}," whenever the pickup is at an airport. Suppliers use it to track the actual arrival time and"," ","adjust the pickup when the flight is delayed; without it the driver only waits at the scheduled time."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"passengers","__idx":7},"children":["Passengers"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Exactly one passenger must be marked ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["primary: true"]},"; this is the contact passenger for the trip. Every passenger needs"," ","a name and exactly one identity document (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["identityNumber"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["passportNo"]},"). The remaining fields are required only for"," ","the primary passenger."]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Field"},"children":["Field"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Type"},"children":["Type"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Required"},"children":["Required"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["primary"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["boolean"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Contact passenger flag. Exactly one must be ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["true"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["firstName"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Passenger first name"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["lastName"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Passenger last name"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["gender"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Primary only"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["M"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["F"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["birthDate"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Primary only"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Birth date (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["YYYY-MM-DD"]}," format)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["nationality"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Primary only"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["ISO country code (2 characters)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["email"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Primary only"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Valid email address"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["phone"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Primary only"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Phone number in E.164 format"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["identityNumber"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["One of the two"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["11-digit identity number (for Turkish citizens)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["passportNo"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["One of the two"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Passport number (for international travelers)"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"billing","__idx":8},"children":["Billing"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["billing"]}," is optional. When it is omitted, the invoice is issued to your organization's registered billing address;"," ","if no billing address is registered for the organization, the request fails with error ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["5003"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Sending ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["billing"]}," requires custom billing to be enabled for your agency. Without that permission the request is"," ","rejected with error ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["5004"]}," even when the billing object is valid. Contact Yolcu360 to enable custom billing."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When sent, transfer billing is stricter than car rental billing: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["taxIdentifier"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["zipCode"]}," are always required"," ","(use the identity number for individuals), and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["line"]}," must be at least 5 characters."]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Field"},"children":["Field"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Type"},"children":["Type"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Required"},"children":["Required"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["type"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Address type: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["individual"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["privateCompany"]},", or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["corporateCompany"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["firstName"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Billing first name (or company name for ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["corporateCompany"]},")"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["lastName"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Conditional"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Billing last name. Required unless type is ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["corporateCompany"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["email"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Billing email address"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["phone"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Billing phone number in E.164 format"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["countryCode"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["ISO country code (2 characters)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["countryName"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Full country name"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["adm1"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Administrative division level 1 (state/province)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["adm2"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Administrative division level 2 (city/district)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["line"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Address line (minimum 5 characters)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["zipCode"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Postal/ZIP code"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["taxIdentifier"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Tax ID number (identity number for individuals)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["taxDivision"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Company types"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Tax office/division. Required for ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["privateCompany"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["corporateCompany"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"example-request","__idx":9},"children":["Example Request"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl -X POST https://api.pro.yolcu360.com/api/v1/transfer/orders \\\n  -H \"Content-Type: application/json\" \\\n  -H \"Authorization: Bearer YOUR_ACCESS_TOKEN\" \\\n  -H \"X-Forwarded-For: 203.0.113.195\" \\\n  -d '{\n    \"searchId\": \"0ba0fea9-1e98-43ce-a69b-e895e2bc68a6\",\n    \"code\": \"9972a93a-707e-403e-928e-cbb68a65584f\",\n    \"flightNumber\": \"TK2021\",\n    \"passengers\": [\n      {\n        \"primary\": true,\n        \"firstName\": \"John\",\n        \"lastName\": \"Doe\",\n        \"gender\": \"M\",\n        \"birthDate\": \"1990-01-15\",\n        \"nationality\": \"US\",\n        \"passportNo\": \"AB1234567\",\n        \"email\": \"john.doe@example.com\",\n        \"phone\": \"+905551234567\"\n      },\n      {\n        \"primary\": false,\n        \"firstName\": \"Jane\",\n        \"lastName\": \"Doe\",\n        \"identityNumber\": \"11111111110\"\n      }\n    ],\n    \"billing\": {\n      \"type\": \"individual\",\n      \"firstName\": \"John\",\n      \"lastName\": \"Doe\",\n      \"email\": \"john.doe@example.com\",\n      \"phone\": \"+905551234567\",\n      \"countryCode\": \"TR\",\n      \"countryName\": \"Turkey\",\n      \"adm1\": \"Istanbul\",\n      \"adm2\": \"Beyoglu\",\n      \"line\": \"Kocatepe Mah. Taksim Square No:1\",\n      \"zipCode\": \"34437\",\n      \"taxIdentifier\": \"11111111110\"\n    }\n  }'\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"response","__idx":10},"children":["Response"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Success Response (201 Created):"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The response is the order itself, in the same shape as the order detail and the payment response. ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["product"]}," is"," ","abbreviated here; it has the same structure as in the order detail below."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"orderId\": \"YLPB_0503\",\n  \"status\": \"pendingPayment\",\n  \"paymentRequirement\": {\n    \"amount\": 145200,\n    \"currency\": \"TRY\"\n  },\n  \"flightNumber\": \"TK2021\",\n  \"product\": {\n    \"code\": \"9972a93a-707e-403e-928e-cbb68a65584f\",\n    \"appointment\": {\n      \"pickup\": {\"lat\": 41.276146, \"lon\": 28.728735, \"name\": \"Istanbul Airport (IST)\"},\n      \"dropoff\": {\"lat\": 41.037003, \"lon\": 28.985092, \"name\": \"Taksim Square\"},\n      \"pickupTime\": \"2027-06-15T10:00:00+03:00\",\n      \"passengerCount\": 2\n    },\n    \"vehicle\": {\"name\": \"Minivan\", \"seatCount\": 6, \"baggageCount\": 6},\n    \"pricing\": {\"currency\": \"TRY\", \"total\": {\"amount\": 145200, \"currency\": \"TRY\"}},\n    \"cancellationPolicies\": [\n      {\"type\": \"freeCancel\", \"until\": \"2027-06-15T09:00:00+03:00\", \"description\": \"You can cancel your transfer free of charge up to 1 hour before departure.\"}\n    ]\n  },\n  \"passengers\": [\n    {\"primary\": true, \"firstName\": \"John\", \"lastName\": \"Doe\", \"gender\": \"M\", \"birthDate\": \"1990-01-15\", \"nationality\": \"US\", \"passportNo\": \"AB1234567\", \"email\": \"john.doe@example.com\", \"phone\": \"+905551234567\"},\n    {\"primary\": false, \"firstName\": \"Jane\", \"lastName\": \"Doe\", \"identityNumber\": \"11111111110\"}\n  ]\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"response-fields","__idx":11},"children":["Response Fields"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Field"},"children":["Field"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Type"},"children":["Type"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["orderId"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Transfer order identifier (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["YLPB_xxxx"]},"). Use it in every subsequent transfer call"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["status"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Order lifecycle status, always ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pendingPayment"]}," right after creation"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paymentRequirement"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["object"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The exact amount to pay in the payment step, in minor units. Returned only on create"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["flightNumber"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Flight number supplied in the request"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["returnFlightNumber"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Return flight number supplied in the request (round trips)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["product"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["object"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The booked offer, same structure as the search response product"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["passengers"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["array"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The passenger data supplied in the request"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The order is now in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pendingPayment"]}," status and expires roughly ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["one hour"]}," after creation if no payment arrives."," ","Continue with ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/endpoints/transfer-payment"},"children":["Transfer Payment"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"get-order-details","__idx":12},"children":["Get Order Details"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Retrieve the current state of a transfer order: lifecycle status, the booked product, and the passengers."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"endpoint-1","__idx":13},"children":["Endpoint"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"GET /transfer/orders/{orderId}\n"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"authentication-1","__idx":14},"children":["Authentication"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This endpoint requires authentication. Include your JWT access token in the Authorization header."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"path-parameters","__idx":15},"children":["Path Parameters"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Parameter"},"children":["Parameter"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Type"},"children":["Type"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Required"},"children":["Required"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["orderId"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Transfer order identifier"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"example-request-1","__idx":16},"children":["Example Request"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl -X GET https://api.pro.yolcu360.com/api/v1/transfer/orders/YLPB_0503 \\\n  -H \"Authorization: Bearer YOUR_ACCESS_TOKEN\"\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"response-1","__idx":17},"children":["Response"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Success Response (200 OK):"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"orderId\": \"YLPB_0503\",\n  \"status\": \"reserved\",\n  \"vendorReservationId\": \"227699\",\n  \"flightNumber\": \"TK2021\",\n  \"product\": {\n    \"code\": \"9972a93a-707e-403e-928e-cbb68a65584f\",\n    \"appointment\": {\n      \"pickup\": {\n        \"lat\": 41.276146,\n        \"lon\": 28.728735,\n        \"name\": \"Istanbul Airport (IST)\"\n      },\n      \"dropoff\": {\n        \"lat\": 41.037003,\n        \"lon\": 28.985092,\n        \"name\": \"Taksim Square\"\n      },\n      \"pickupTime\": \"2027-06-15T10:00:00+03:00\",\n      \"passengerCount\": 2\n    },\n    \"onewayDistance\": 41662,\n    \"onewayDuration\": 2727,\n    \"vehicle\": {\n      \"name\": \"Minivan\",\n      \"seatCount\": 6,\n      \"baggageCount\": 6,\n      \"image\": \"https://cdn.example.com/assets/images/van.png\"\n    },\n    \"pricing\": {\n      \"currency\": \"TRY\",\n      \"fees\": [\n        {\n          \"amount\": 132000,\n          \"currency\": \"TRY\",\n          \"type\": \"oneway\",\n          \"charge\": \"advance\",\n          \"description\": \"Outbound Trip Amount\"\n        },\n        {\n          \"amount\": 13200,\n          \"currency\": \"TRY\",\n          \"type\": \"commission\",\n          \"charge\": \"advance\",\n          \"description\": \"commission\"\n        }\n      ],\n      \"vendorTotal\": {\n        \"amount\": 0,\n        \"currency\": \"TRY\"\n      },\n      \"paymentTotal\": {\n        \"amount\": 145200,\n        \"currency\": \"TRY\"\n      },\n      \"discountTotal\": {\n        \"amount\": 0,\n        \"currency\": \"TRY\"\n      },\n      \"total\": {\n        \"amount\": 145200,\n        \"currency\": \"TRY\"\n      }\n    },\n    \"rules\": [\n      {\n        \"type\": \"freeCancellation\",\n        \"description\": \"Free Cancellation\"\n      },\n      {\n        \"type\": \"waitForFree\",\n        \"description\": \"First 15 minutes of waiting free\"\n      },\n      {\n        \"type\": \"safeTripWithInvoice\",\n        \"description\": \"Safe trip with invoice\"\n      }\n    ],\n    \"cancellationPolicies\": [\n      {\n        \"type\": \"freeCancel\",\n        \"until\": \"2027-06-15T09:00:00+03:00\",\n        \"description\": \"You can cancel your transfer free of charge up to 1 hour before departure.\"\n      }\n    ]\n  },\n  \"passengers\": [\n    {\n      \"primary\": true,\n      \"firstName\": \"John\",\n      \"lastName\": \"Doe\",\n      \"gender\": \"M\",\n      \"birthDate\": \"1990-01-15\",\n      \"nationality\": \"US\",\n      \"passportNo\": \"AB1234567\",\n      \"email\": \"john.doe@example.com\",\n      \"phone\": \"+905551234567\"\n    },\n    {\n      \"primary\": false,\n      \"firstName\": \"Jane\",\n      \"lastName\": \"Doe\",\n      \"identityNumber\": \"11111111110\"\n    }\n  ]\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"response-fields-1","__idx":18},"children":["Response Fields"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Field"},"children":["Field"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Type"},"children":["Type"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["orderId"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Transfer order identifier"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["status"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Order lifecycle status (see the table below)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["vendorReservationId"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Supplier booking reference. Present once the order is ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["reserved"]},"; absent in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pendingPayment"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["flightNumber"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Flight number supplied at order creation"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["returnFlightNumber"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Return flight number supplied at order creation (round trips)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["product"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["object"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The booked offer, same structure as the search response product"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["passengers"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["array"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The passenger data supplied at order creation"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"order-status-values","__idx":19},"children":["Order Status Values"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Status"},"children":["Status"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pendingPayment"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Order created, awaiting payment. Expires roughly one hour after creation if unpaid"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["reserved"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Payment completed and the transfer confirmed with the supplier"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["canceled"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Order canceled by the agency or the supplier"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["expired"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Order was not paid in time and expired automatically"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["failed"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Reservation could not be completed"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"status-tracking-recommendation","__idx":20},"children":["Status Tracking Recommendation"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The payment response already carries the order in its current state, read back after the charge, so the payment needs"," ","no follow-up detail call. Use this endpoint to re-check the order later: a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["reserved"]}," order can also drop (for example"," ","a supplier-side cancellation), so re-checking the status before the pickup time is recommended."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["vendorReservationId"]}," is available from ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["reserved"]}," onward and stays on the order after cancellation. On an order that"," ","later fails on the supplier side it may be missing."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"check-cancel-eligibility","__idx":21},"children":["Check Cancel Eligibility"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Checks whether an order can be canceled and how much would be refunded. This endpoint does not modify the order."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"endpoint-2","__idx":22},"children":["Endpoint"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"POST /transfer/orders/{orderId}/cancel_eligibility\n"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"authentication-2","__idx":23},"children":["Authentication"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This endpoint requires authentication. Include your JWT access token in the Authorization header."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"path-parameters-1","__idx":24},"children":["Path Parameters"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Parameter"},"children":["Parameter"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Type"},"children":["Type"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Required"},"children":["Required"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["orderId"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Identifier of the order to check"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"example-request-2","__idx":25},"children":["Example Request"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl -X POST https://api.pro.yolcu360.com/api/v1/transfer/orders/YLPB_0503/cancel_eligibility \\\n  -H \"Authorization: Bearer YOUR_ACCESS_TOKEN\"\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"response-2","__idx":26},"children":["Response"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Success Response (200 OK):"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"orderId\": \"YLPB_0503\",\n  \"cancellable\": true,\n  \"refundAmount\": {\n    \"amount\": 145200,\n    \"currency\": \"TRY\"\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"response-fields-2","__idx":27},"children":["Response Fields"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Field"},"children":["Field"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Type"},"children":["Type"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["orderId"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Transfer order identifier"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cancellable"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["boolean"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Whether the order can be canceled now"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["refundAmount"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["object"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Amount to be refunded if the order is canceled now, in minor units. Omitted when not applicable"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["refundAmount"]}," already has any cancellation penalty applied (see the offer's ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cancellationPolicies"]},") and is capped at"," ","the amount actually paid. Note that the transfer eligibility response is richer than the car rental one: it returns the"," ","concrete refund amount instead of a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["refundable"]}," flag."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"cancel-order","__idx":28},"children":["Cancel Order"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Cancels a transfer order. The cancellation is forwarded to the supplier; a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["200"]}," response is returned ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["only when the"," ","supplier accepts"]}," the cancellation. The refund is issued automatically back to your credit limit."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"endpoint-3","__idx":29},"children":["Endpoint"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"POST /transfer/orders/{orderId}/cancel\n"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"authentication-3","__idx":30},"children":["Authentication"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This endpoint requires authentication. Include your JWT access token in the Authorization header."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"path-parameters-2","__idx":31},"children":["Path Parameters"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Parameter"},"children":["Parameter"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Type"},"children":["Type"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Required"},"children":["Required"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["orderId"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Identifier of the order to cancel"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"example-request-3","__idx":32},"children":["Example Request"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl -X POST https://api.pro.yolcu360.com/api/v1/transfer/orders/YLPB_0503/cancel \\\n  -H \"Authorization: Bearer YOUR_ACCESS_TOKEN\"\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"response-3","__idx":33},"children":["Response"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Success Response (200 OK):"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"orderId\": \"YLPB_0503\",\n  \"status\": \"canceled\"\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If the supplier refuses the cancellation, or the order is not in a cancellable state (for example it was already"," ","canceled), the endpoint returns error ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["8012"]},":"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"code\": 8012,\n  \"description\": \"Transfer order cannot be canceled\",\n  \"details\": {\n    \"orderId\": \"YLPB_0503\",\n    \"status\": \"canceled\"\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Check ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#check-cancel-eligibility"},"children":["cancel eligibility"]}," before canceling to avoid surprises, and treat ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["8012"]}," as a"," ","non-retriable outcome: contact support if a cancellation is required but keeps failing."]}]},"headings":[{"value":"Transfer Orders","id":"transfer-orders","depth":1},{"value":"Create Order","id":"create-order","depth":2},{"value":"Endpoint","id":"endpoint","depth":3},{"value":"Authentication","id":"authentication","depth":3},{"value":"End User IP Address","id":"end-user-ip-address","depth":3},{"value":"Request Body","id":"request-body","depth":3},{"value":"Flight Number (Strongly Recommended)","id":"flight-number-strongly-recommended","depth":4},{"value":"Passengers","id":"passengers","depth":4},{"value":"Billing","id":"billing","depth":4},{"value":"Example Request","id":"example-request","depth":3},{"value":"Response","id":"response","depth":3},{"value":"Response Fields","id":"response-fields","depth":3},{"value":"Get Order Details","id":"get-order-details","depth":2},{"value":"Endpoint","id":"endpoint-1","depth":3},{"value":"Authentication","id":"authentication-1","depth":3},{"value":"Path Parameters","id":"path-parameters","depth":3},{"value":"Example Request","id":"example-request-1","depth":3},{"value":"Response","id":"response-1","depth":3},{"value":"Response Fields","id":"response-fields-1","depth":3},{"value":"Order Status Values","id":"order-status-values","depth":3},{"value":"Status Tracking Recommendation","id":"status-tracking-recommendation","depth":3},{"value":"Check Cancel Eligibility","id":"check-cancel-eligibility","depth":2},{"value":"Endpoint","id":"endpoint-2","depth":3},{"value":"Authentication","id":"authentication-2","depth":3},{"value":"Path Parameters","id":"path-parameters-1","depth":3},{"value":"Example Request","id":"example-request-2","depth":3},{"value":"Response","id":"response-2","depth":3},{"value":"Response Fields","id":"response-fields-2","depth":3},{"value":"Cancel Order","id":"cancel-order","depth":2},{"value":"Endpoint","id":"endpoint-3","depth":3},{"value":"Authentication","id":"authentication-3","depth":3},{"value":"Path Parameters","id":"path-parameters-2","depth":3},{"value":"Example Request","id":"example-request-3","depth":3},{"value":"Response","id":"response-3","depth":3}],"frontmatter":{"seo":{"title":"Transfer Orders"}},"lastModified":"2026-10-01T06:30:51.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/endpoints/transfer-orders","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}