API đưa đón sân bay cho đại lý du lịch và OTA

Tìm sân bay đến, yêu cầu báo giá và đặt một báo giá. Yêu cầu báo giá trả về một mã báo giá cho mỗi loại xe, và đơn đặt dùng mã đó.

1. Tìm sân bay

   Gõ ít nhất ba ký tự và endpoint sẽ gợi ý các sân bay, mỗi sân bay kèm mã IATA. Yêu cầu báo giá gọi tên sân bay bằng mã đó.

   curl 'https://api.fx-port.com/api/v1/transfers/locations?query=ams&types=airport&limit=5' \
     -H "Authorization: Bearer fxp_test_YOUR_KEY"

   200 OK
   Content-Type: application/json
   Cache-Control: private, no-store
   X-Environment: sandbox
   
   {
     "environment": "sandbox",
     "success": true,
     "data": {
       "locations": [
         {
           "location_id": "apt:AMS",
           "type": "airport",
           "iata_code": "AMS",
           "place_id": null,
           "name": "Amsterdam Airport Schiphol",
           "description": null,
           "city": "Amsterdam",
           "country_code": "NL",
           "latitude": 52.3105,
           "longitude": 4.7683
         }
       ]
     }
   }

   • PASS Mã trạng thái là 200
   • PASS $.data.locations[0].iata_code bằng AMS
   • PASS $.data.locations[0].location_id tồn tại

2. Yêu cầu báo giá

   Gửi điểm đón, điểm trả, giờ đón địa phương và hành khách. Phản hồi chứa một báo giá cho mỗi loại xe, mỗi báo giá có mã riêng, giá theo tiền tệ đại lý của bạn và thời hạn.

   curl https://api.fx-port.com/api/v1/transfers/quotes \
     -H "Authorization: Bearer fxp_test_YOUR_KEY" \
     -H "Content-Type: application/json" \
     -d '{
     "pickup": {
       "type": "airport",
       "iata_code": "AMS"
     },
     "dropoff": {
       "type": "point",
       "latitude": 52.3676,
       "longitude": 4.9041,
       "name": "Amsterdam City Centre"
     },
     "pickup_datetime": "2027-06-23T14:30",
     "passengers": {
       "adults": 2,
       "children": 0,
       "infants": 0
     }
   }'

   200 OK
   Content-Type: application/json
   Cache-Control: private, no-store
   X-Environment: sandbox
   
   {
     "environment": "sandbox",
     "success": true,
     "data": {
       "search_id": "tsr_01JC5T9ZK4Y2Q8M3V7N6B1A0XD",
       "distance_km": 20,
       "currency": "DZD",
       "expires_at": "2026-11-09T10:13:12Z",
       "quotes": [
         {
           "quote_id": "tq_01JC5T9ZK4Y2Q8M3V7N6B1A0XE",
           "vehicle": {
             "make": "Toyota",
             "model": "Corolla",
             "type": "Sedan",
             "image_url": null,
             "max_passengers": 4,
             "suitcases": 2,
             "small_bags": 2
           },
           "operator": {
             "name": "Sandbox Transfers"
           },
           "price": {
             "currency": "DZD",
             "total_price": 17823.33,
             "b2b_price": 17823.33,
             "agency_commission": 0
           },
           "extras": [],
           "cancellation": {
             "free_cancellation": true,
             "hours_before_pickup": 24,
             "source": "platform_default"
           },
           "expires_at": "2026-11-09T10:13:12Z"
         }
       ],
       "meta": {
         "no_availability": false
       }
     }
   }

   • PASS Mã trạng thái là 200
   • PASS $.data.quotes có 1 phần tử
   • PASS $.data.currency bằng DZD

3. Đặt một báo giá

   Gửi mã báo giá cùng hành khách chính và số hiệu chuyến bay. Đơn đặt ở trạng thái đang chờ trong lúc nhà cung cấp xác nhận. Cần khóa đọc + ghi.

   curl https://api.fx-port.com/api/v1/transfers/bookings \
     -H "Authorization: Bearer fxp_test_YOUR_KEY" \
     -H "Content-Type: application/json" \
     -d '{
     "quote_id": "tq_01JC5T9ZK4Y2Q8M3V7N6B1A0XE",
     "passenger": {
       "first_name": "Jane",
       "last_name": "Doe",
       "email": "[email protected]",
       "phone": "+31612345678"
     },
     "flight_number": "KL1234",
     "notes": "Arrival terminal 2",
     "luggage": {
       "suitcases": 1,
       "small_bags": 0
     }
   }'

   200 OK
   Content-Type: application/json
   Cache-Control: private, no-store
   X-Environment: sandbox
   
   {
     "environment": "sandbox",
     "success": true,
     "data": {
       "idempotent_replay": false,
       "booking": {
         "id": "5b5b0e1c-6f7a-4c2d-9a53-0d2d4a0f9c11",
         "booking_id": "SBX-0000000001-AAB",
         "reference": "FXT-5B5B0E1C6F7A",
         "status": "pending",
         "state_detail": "awaiting_supplier_approval",
         "supplier_status": "PENDING_APPROVAL",
         "environment": "sandbox",
         "simulated": true,
         "pickup": {
           "type": "airport",
           "name": "Amsterdam Airport Schiphol",
           "iata_code": "AMS"
         },
         "dropoff": {
           "type": "point",
           "name": "Amsterdam City Centre",
           "latitude": 52.3676,
           "longitude": 4.9041
         },
         "pickup_datetime": "2027-06-23T14:30",
         "flight_number": "KL1234",
         "notes": "Arrival terminal 2",
         "passengers": {
           "adults": 2,
           "children": 0,
           "infants": 0
         },
         "lead_passenger": {
           "first_name": "Jane",
           "last_name": "Doe",
           "email": "[email protected]",
           "phone": "+31612345678"
         },
         "luggage": {
           "suitcases": 1,
           "small_bags": 0
         },
         "vehicle": {
           "make": "Toyota",
           "model": "Corolla",
           "type": "Sedan",
           "image_url": null,
           "max_passengers": 4
         },
         "operator": {
           "name": "Sandbox Transfers"
         },
         "driver": null,
         "price": {
           "currency": "DZD",
           "total_price": 17823.33,
           "b2b_price": 17823.33,
           "agency_commission": 0
         },
         "refund": null,
         "documents": {
           "receipt_url": null,
           "voucher_url": null
         },
         "is_cancelable": true,
         "can_cancel": true,
         "trip_group_id": null,
         "quote_id": "tq_01JC5T9ZK4Y2Q8M3V7N6B1A0XE",
         "status_updated_at": "2026-11-09T10:02:05Z",
         "created_at": "2026-11-09T10:02:05Z",
         "warnings": []
       }
     }
   }

   • PASS Mã trạng thái là 200
   • PASS $.data.booking.status bằng pending
   • PASS $.data.booking.simulated bằng true
   • PASS $.data.booking.reference tồn tại

Đọc một đơn đặt mới, đọc lại sau đó và hủy đơn. Mỗi phản hồi cho biết khi nào nên hỏi lại, và Sandbox xác nhận đơn đặt sau một lúc chờ ngắn.

1. Đọc một đơn đặt mới

   Đơn đặt mới đang chờ và chưa có tài xế. Phản hồi cho biết sau bao nhiêu giây nên hỏi lại.

   curl https://api.fx-port.com/api/v1/transfers/bookings/5b5b0e1c-6f7a-4c2d-9a53-0d2d4a0f9c11 \
     -H "Authorization: Bearer fxp_test_YOUR_KEY"

   200 OK
   
   {
     "environment": "sandbox",
     "success": true,
     "data": {
       "booking": {
         "id": "5b5b0e1c-6f7a-4c2d-9a53-0d2d4a0f9c11",
         "booking_id": "SBX-0000000001-AAB",
         "reference": "FXT-5B5B0E1C6F7A",
         "status": "pending",
         "state_detail": "awaiting_supplier_approval",
         "supplier_status": "PENDING_APPROVAL",
         "environment": "sandbox",
         "simulated": true,
         // ... 2 more
         "pickup_datetime": "2027-06-23T14:30",
         "flight_number": "KL1234",
         "notes": "Arrival terminal 2",
         // ... 16 more
       }
     },
     "meta": {
       "next_poll_after_seconds": 120
     }
   }

   • PASS Mã trạng thái là 200
   • PASS $.data.booking.status bằng pending
   • PASS $.meta.next_poll_after_seconds bằng 120

2. Đọc lại sau đó

   Một lúc sau, cùng lệnh đọc cho thấy đơn đặt đã xác nhận, kèm tài xế khi đã được phân công.

   curl https://api.fx-port.com/api/v1/transfers/bookings/5b5b0e1c-6f7a-4c2d-9a53-0d2d4a0f9c11 \
     -H "Authorization: Bearer fxp_test_YOUR_KEY"

   200 OK
   
   {
     "environment": "sandbox",
     "success": true,
     "data": {
       "booking": {
         "id": "5b5b0e1c-6f7a-4c2d-9a53-0d2d4a0f9c11",
         "booking_id": "SBX-0000000001-AAB",
         "reference": "FXT-5B5B0E1C6F7A",
         "status": "confirmed",
         "state_detail": "confirmed",
         "supplier_status": "APPROVED",
         "environment": "sandbox",
         // ... 11 more
         "driver": {
           "name": "Simulated Driver",
           // ... 4 more
         },
         // ... 10 more
       }
     },
     "meta": {
       "next_poll_after_seconds": 21600
     }
   }

   • PASS Mã trạng thái là 200
   • PASS $.data.booking.status bằng confirmed
   • PASS $.data.booking.driver.name tồn tại
   • PASS $.meta.next_poll_after_seconds bằng 21600

3. Hủy kèm lý do

   Hủy với mã của một lý do. Sandbox phản hồi đơn đặt đã hoàn tiền, và không có tiền nào di chuyển vì chưa trừ khoản nào.

   curl https://api.fx-port.com/api/v1/transfers/bookings/5b5b0e1c-6f7a-4c2d-9a53-0d2d4a0f9c11/cancel \
     -H "Authorization: Bearer fxp_test_YOUR_KEY" \
     -H "Content-Type: application/json" \
     -d '{
     "reason_id": 6,
     "note": "customer request"
   }'

   200 OK
   
   {
     "environment": "sandbox",
     "success": true,
     "data": {
       "booking": {
         "id": "5b5b0e1c-6f7a-4c2d-9a53-0d2d4a0f9c11",
         "booking_id": "SBX-0000000001-AAB",
         "reference": "FXT-5B5B0E1C6F7A",
         "status": "refunded",
         "state_detail": "completed",
         "supplier_status": "REFUNDED",
         "environment": "sandbox",
         "simulated": true,
         // ... 2 more
         "pickup_datetime": "2027-06-23T14:30",
         "flight_number": "KL1234",
         // ... 17 more
       },
       "refund": {
         // ... 4 more
         "status": "not_applicable"
       }
     }
   }

   • PASS Mã trạng thái là 200
   • PASS $.data.booking.status bằng refunded
   • PASS $.data.refund.status bằng not_applicable

Số hiệu chuyến bay PRICEUP khiến Sandbox tăng giá giữa lúc báo giá và lúc đặt. API từ chối đặt với giá cao hơn cho đến khi bạn yêu cầu báo giá mới.

1. Yêu cầu báo giá

   Báo giá giữ một mức giá cho chuyến đi. Hãy lưu mã báo giá và tổng tiền.

   curl https://api.fx-port.com/api/v1/transfers/quotes \
     -H "Authorization: Bearer fxp_test_YOUR_KEY" \
     -H "Content-Type: application/json" \
     -d '{
     "pickup": {
       "type": "airport",
       "iata_code": "AMS"
     },
     "dropoff": {
       "type": "point",
       "latitude": 52.3676,
       "longitude": 4.9041,
       "name": "Amsterdam City Centre"
     },
     "pickup_datetime": "2027-06-23T14:30",
     "passengers": {
       "adults": 2,
       "children": 0,
       "infants": 0
     }
   }'

   200 OK
   
   {
     "environment": "sandbox",
     "success": true,
     "data": {
       "search_id": "tsr_01JC5T9ZK4Y2Q8M3V7N6B1A0XD",
       "distance_km": 20,
       "currency": "DZD",
       "expires_at": "2026-11-09T10:13:12Z",
       "quotes": [
         {
           "quote_id": "tq_01JC5T9ZK4Y2Q8M3V7N6B1A0XE",
           // ... 2 more
           "price": {
             "currency": "DZD",
             "total_price": 17823.33,
             // ... 2 more
           },
           "extras": [],
           // ... 2 more
         }
       ],
       // ... 1 more
     }
   }

   • PASS Mã trạng thái là 200
   • PASS $.data.quotes[0].price.total_price bằng 17823.33

2. Đặt, và giá đã thay đổi

   Sandbox tăng giá khi số hiệu chuyến bay là PRICEUP. API trả về 409 với price_changed, tổng tiền trước đó và tổng tiền hiện tại. Không có gì được đặt.

   curl https://api.fx-port.com/api/v1/transfers/bookings \
     -H "Authorization: Bearer fxp_test_YOUR_KEY" \
     -H "Content-Type: application/json" \
     -d '{
     "quote_id": "tq_01JC5T9ZK4Y2Q8M3V7N6B1A0XE",
     "passenger": {
       "first_name": "Jane",
       "last_name": "Doe",
       "email": "[email protected]",
       "phone": "+31612345678"
     },
     "flight_number": "PRICEUP",
     "notes": "Arrival terminal 2",
     "luggage": {
       "suitcases": 1,
       "small_bags": 0
     }
   }'

   409 Conflict
   
   {
     "environment": "sandbox",
     "success": false,
     "errors": [
       {
         "code": "price_changed",
         "type": "conflict",
         "title": "Price changed",
         "message": "The price changed since the quote was issued. Request a new quote and confirm the new price.",
         "field": null,
         "details": {
           "previous_total_price": 17823.33,
           "current_total_price": 18715.1,
           "currency": "DZD"
         },
         "documentation_url": "https://fx-port.com/docs/errors#price_changed"
       }
     ],
     "meta": {
       "request_id": "req_3c1f9a7be204",
       "status": 409
     },
     "request_id": "req_3c1f9a7be204"
   }

   • PASS Mã trạng thái là 409
   • PASS Mã lỗi là price_changed
   • PASS $.errors[0].details.previous_total_price bằng 17823.33
   • PASS $.errors[0].details.current_total_price bằng 18715.1

3. Yêu cầu báo giá mới

   Báo giá lại cùng chuyến đi. Báo giá mới có mã mới và mức giá cao hơn, giờ đây du khách có thể chấp nhận hoặc từ chối.

   curl https://api.fx-port.com/api/v1/transfers/quotes \
     -H "Authorization: Bearer fxp_test_YOUR_KEY" \
     -H "Content-Type: application/json" \
     -d '{
     "pickup": {
       "type": "airport",
       "iata_code": "AMS"
     },
     "dropoff": {
       "type": "point",
       "latitude": 52.3676,
       "longitude": 4.9041,
       "name": "Amsterdam City Centre"
     },
     "pickup_datetime": "2027-06-23T14:30",
     "passengers": {
       "adults": 2,
       "children": 0,
       "infants": 0
     }
   }'

   200 OK
   
   {
     "environment": "sandbox",
     "success": true,
     "data": {
       "search_id": "tsr_01JC5TA2M7R9W4X6Z8B3C5D7F1",
       "distance_km": 20,
       "currency": "DZD",
       "expires_at": "2026-11-09T10:15:31Z",
       "quotes": [
         {
           "quote_id": "tq_01JC5TA2M7R9W4X6Z8B3C5D7F2",
           // ... 2 more
           "price": {
             "currency": "DZD",
             "total_price": 18715.1,
             // ... 2 more
           },
           "extras": [],
           // ... 2 more
         }
       ],
       // ... 1 more
     }
   }

   • PASS Mã trạng thái là 200
   • PASS $.data.quotes[0].price.total_price bằng 18715.1

4. Đặt báo giá mới

   Đặt với mã báo giá mới. Giá lúc này khớp, và đơn đặt được tạo.

   curl https://api.fx-port.com/api/v1/transfers/bookings \
     -H "Authorization: Bearer fxp_test_YOUR_KEY" \
     -H "Content-Type: application/json" \
     -d '{
     "quote_id": "tq_01JC5TA2M7R9W4X6Z8B3C5D7F2",
     "passenger": {
       "first_name": "Jane",
       "last_name": "Doe",
       "email": "[email protected]",
       "phone": "+31612345678"
     },
     "flight_number": "PRICEUP",
     "notes": "Arrival terminal 2",
     "luggage": {
       "suitcases": 1,
       "small_bags": 0
     }
   }'

   200 OK
   
   {
     "environment": "sandbox",
     "success": true,
     "data": {
       "idempotent_replay": false,
       "booking": {
         "id": "5b5b0e1c-6f7a-4c2d-9a53-0d2d4a0f9c11",
         "booking_id": "SBX-0000000001-AAB",
         "reference": "FXT-5B5B0E1C6F7A",
         "status": "pending",
         "state_detail": "awaiting_supplier_approval",
         "supplier_status": "PENDING_APPROVAL",
         "environment": "sandbox",
         "simulated": true,
         // ... 2 more
         "pickup_datetime": "2027-06-23T14:30",
         "flight_number": "PRICEUP",
         "notes": "Arrival terminal 2",
         // ... 5 more
         "driver": null,
         // ... 10 more
       }
     }
   }

   • PASS Mã trạng thái là 200
   • PASS $.data.booking.status bằng pending
   • PASS $.data.booking.price.total_price bằng 18715.1

Họ Timeout khiến Sandbox làm mất phản hồi của một đơn đặt. Bạn khắc phục bằng cách đọc đơn đặt, không bao giờ đặt lại.

1. Phản hồi bị mất

   Sandbox làm mất phản hồi khi họ là Timeout. API trả về 202: đơn đặt đang chờ, trạng thái là reconciling, và thông báo nói không được đặt lại.

   curl https://api.fx-port.com/api/v1/transfers/bookings \
     -H "Authorization: Bearer fxp_test_YOUR_KEY" \
     -H "Content-Type: application/json" \
     -d '{
     "quote_id": "tq_01JC5T9ZK4Y2Q8M3V7N6B1A0XE",
     "passenger": {
       "first_name": "Jane",
       "last_name": "Timeout",
       "email": "[email protected]",
       "phone": "+31612345678"
     },
     "flight_number": "KL1234",
     "notes": "Arrival terminal 2",
     "luggage": {
       "suitcases": 1,
       "small_bags": 0
     }
   }'

   202 Accepted
   
   {
     "environment": "sandbox",
     "success": true,
     "data": {
       "booking": {
         "id": "5b5b0e1c-6f7a-4c2d-9a53-0d2d4a0f9c11",
         "booking_id": null,
         "reference": "FXT-5B5B0E1C6F7A",
         "status": "pending",
         "state_detail": "reconciling",
         "quote_id": "tq_01JC5T9ZK4Y2Q8M3V7N6B1A0XE"
       },
       "message": "We could not confirm this booking with the transport network yet. Your balance is reserved. Do not book again; poll GET /api/v1/transfers/bookings/5b5b0e1c-6f7a-4c2d-9a53-0d2d4a0f9c11"
     }
   }

   • PASS Mã trạng thái là 202
   • PASS $.data.booking.state_detail bằng reconciling
   • PASS $.data.booking.booking_id bằng null

2. Tìm đơn đặt

   Liệt kê đơn đặt với mã báo giá làm bộ lọc. Danh sách trả về đơn đặt mà phản hồi bị mất thuộc về, nên không có lý do để đặt lại.

   curl 'https://api.fx-port.com/api/v1/transfers/bookings?quote_id=tq_01JC5T9ZK4Y2Q8M3V7N6B1A0XE' \
     -H "Authorization: Bearer fxp_test_YOUR_KEY"

   200 OK
   
   {
     "environment": "sandbox",
     "success": true,
     "data": {
       "bookings": [
         {
           "id": "5b5b0e1c-6f7a-4c2d-9a53-0d2d4a0f9c11",
           "booking_id": null,
           "reference": "FXT-5B5B0E1C6F7A",
           // ... 25 more
         }
       ]
     },
     "pagination": {
       "page": 1,
       "limit": 50,
       "total": 1,
       "total_pages": 1,
       "has_more": false
     },
     "meta": {
       "as_of": "2026-11-09T10:03:40Z"
     }
   }

   • PASS Mã trạng thái là 200
   • PASS $.pagination.total bằng 1
   • PASS $.data.bookings[0].state_detail bằng reconciling

3. Đặt lại quá sớm

   Gửi lại cùng đơn đặt khi đơn đầu vẫn đang xử lý sẽ bị từ chối với 409 và booking_in_progress, kèm header Retry-After. Hãy đọc đơn đặt thay vì đặt lại.

   curl https://api.fx-port.com/api/v1/transfers/bookings \
     -H "Authorization: Bearer fxp_test_YOUR_KEY" \
     -H "Content-Type: application/json" \
     -d '{
     "quote_id": "tq_01JC5T9ZK4Y2Q8M3V7N6B1A0XE",
     "passenger": {
       "first_name": "Jane",
       "last_name": "Timeout",
       "email": "[email protected]",
       "phone": "+31612345678"
     },
     "flight_number": "KL1234",
     "notes": "Arrival terminal 2",
     "luggage": {
       "suitcases": 1,
       "small_bags": 0
     }
   }'

   409 Conflict
   Retry-After: 3
   
   {
     "environment": "sandbox",
     "success": false,
     "errors": [
       {
         "code": "booking_in_progress",
         "type": "conflict",
         "title": "Booking in progress",
         "message": "This quote is already being booked. Wait a few seconds, then read the booking.",
         "field": null,
         "details": {
           "retry_after": 3
         },
         "documentation_url": "https://fx-port.com/docs/errors#booking_in_progress"
       }
     ],
     "meta": {
       "request_id": "req_8a47d05e91bc",
       "status": 409
     },
     "request_id": "req_8a47d05e91bc"
   }

   • PASS Mã trạng thái là 409
   • PASS Mã lỗi là booking_in_progress
   • PASS Có header Retry-After

Đọc các lý do hủy, tạo một đơn đặt với số hiệu chuyến bay NOCANCEL và xem API từ chối hủy đơn đó.

1. Liệt kê các lý do

   Các lý do được trả về dưới dạng danh sách mã và tên. Bạn gửi mã của một lý do cùng lệnh hủy.

   curl https://api.fx-port.com/api/v1/transfers/cancellation-reasons \
     -H "Authorization: Bearer fxp_test_YOUR_KEY"

   200 OK
   
   {
     "environment": "sandbox",
     "success": true,
     "data": {
       "source": "supplier",
       "reasons": [
         {
           "id": 1,
           "name": "Flight cancelled",
           // ... 2 more
         },
         {
           // ... 4 more
         },
         {
           // ... 4 more
         },
         {
           // ... 4 more
         },
         // ... 2 more
       ]
     }
   }

   • PASS Mã trạng thái là 200
   • PASS $.data.reasons có 6 phần tử
   • PASS $.data.reasons[5].name bằng Other

2. Tạo đơn đặt

   Sandbox tạo một đơn đặt không thể hủy khi số hiệu chuyến bay là NOCANCEL. Đơn đặt cho biết điều này ở trường can_cancel.

   curl https://api.fx-port.com/api/v1/transfers/bookings \
     -H "Authorization: Bearer fxp_test_YOUR_KEY" \
     -H "Content-Type: application/json" \
     -d '{
     "quote_id": "tq_01JC5T9ZK4Y2Q8M3V7N6B1A0XE",
     "passenger": {
       "first_name": "Jane",
       "last_name": "Doe",
       "email": "[email protected]",
       "phone": "+31612345678"
     },
     "flight_number": "NOCANCEL",
     "notes": "Arrival terminal 2",
     "luggage": {
       "suitcases": 1,
       "small_bags": 0
     }
   }'

   200 OK
   
   {
     "environment": "sandbox",
     "success": true,
     "data": {
       "idempotent_replay": false,
       "booking": {
         "id": "5b5b0e1c-6f7a-4c2d-9a53-0d2d4a0f9c11",
         "booking_id": "SBX-0000000001-AAB",
         "reference": "FXT-5B5B0E1C6F7A",
         "status": "pending",
         "state_detail": "awaiting_supplier_approval",
         "supplier_status": "PENDING_APPROVAL",
         "environment": "sandbox",
         "simulated": true,
         // ... 2 more
         "pickup_datetime": "2027-06-23T14:30",
         "flight_number": "NOCANCEL",
         "notes": "Arrival terminal 2",
         // ... 10 more
         "can_cancel": false,
         // ... 5 more
       }
     }
   }

   • PASS Mã trạng thái là 200
   • PASS $.data.booking.can_cancel bằng false
   • PASS $.data.booking.is_cancelable bằng false

3. Thử hủy đơn

   Việc hủy bị từ chối với 409 và cancellation_not_allowed, và phần chi tiết nêu lý do. Đơn đặt có thể hủy sẽ phản hồi kèm khoản hoàn tiền.

   curl https://api.fx-port.com/api/v1/transfers/bookings/5b5b0e1c-6f7a-4c2d-9a53-0d2d4a0f9c11/cancel \
     -H "Authorization: Bearer fxp_test_YOUR_KEY" \
     -H "Content-Type: application/json" \
     -d '{
     "reason_id": 6,
     "note": "customer request"
   }'

   409 Conflict
   
   {
     "environment": "sandbox",
     "success": false,
     "errors": [
       {
         "code": "cancellation_not_allowed",
         "type": "conflict",
         "title": "Cancellation not allowed",
         "message": "This booking cannot be cancelled.",
         "field": null,
         "details": {
           "reason": "not_cancelable"
         },
         "documentation_url": "https://fx-port.com/docs/errors#cancellation_not_allowed"
       }
     ],
     "meta": {
       "request_id": "req_d2e60b3f7a18",
       "status": 409
     },
     "request_id": "req_d2e60b3f7a18"
   }

   • PASS Mã trạng thái là 409
   • PASS Mã lỗi là cancellation_not_allowed
   • PASS $.errors[0].details.reason bằng not_cancelable