订单与出票

关于保留时长、邮箱使用、多订单往返和附加服务的常见问题。

这页适合查看订单保留、联系邮箱、拆单和附加服务映射相关问题。

Does order.do hold inventory?

Yes. Atlas holds inventory and price for 30 minutes after order creation.

If payment is not completed in that window, the hold expires.

Can we manually release held inventory?

No. Atlas releases it automatically after the hold period.

Which email should we send in booking contact details?

You can use either:

• the traveler email

• your agency email

• an Atlas-generated email

Some airlines block repeated bookings from the same email address. To reduce that risk, use useAtlasMailForContact.

What does useAtlasMailForContact do?

• true: Atlas generates a unique booking email and sends that to the airline

• false: Atlas uses the email you send in order.do

When Atlas-generated email is used, airline replies may appear in ATRIP email records. Delivery is best effort, not guaranteed.

If your own email is blocked by the airline, Atlas may cancel the booking and return error 321.

Do we need to poll after pay.do?

Yes. Payment and ticket issuance are not always the same moment.

Use queryOrderDetails.do until the order reaches the final ticketed state. Webhook can help, but it should not be your only confirmation path.

Is pnrCode the airline PNR?

No. pnrCode is the Atlas booking reference.

The airline PNR is returned later in order query after the airline generates it.

When do airline PNR and ticket numbers appear?

They appear after ticketing completes. Read them from paxTicketInfos.airlinePNRs and ticketNos in order query.

What should we do if ticketing is still processing?

Do not retry payment blindly. Query the order state first.

Wait for final orderStatus and ticketStatus, or reconcile with webhook events if configured.

Can VCC be used for a round trip built from two one-way fares?

Yes, but the booking may split into two separate orders.

Use:

• allowGenerateMultipleOrders: true

If Atlas cannot issue the itinerary as one round trip, it may return two comma-separated orderNo values.

How should split-order payment work?

1. Create the order with allowGenerateMultipleOrders: true

2. Read each returned order separately

3. Call payment separately for each order

Check payment support for each returned order before paying.

How should ancillaries be sent for connecting flights?

Every flown segment must have its own segmentIndex entry.

If verification returns two segments, the order request must also include two ancillary entries when the product applies to both segments.

Example

If one baggage product applies across a two-segment journey, send:

"ancillaries": [
  {
    "productCode": "SCI_BAG_1PC_20KG",
    "segmentIndex": "1"
  },
  {
    "productCode": "SCI_BAG_1PC_20KG",
    "segmentIndex": "2"
  }
]

相关页面

• 创建订单

• 支付与出票

• 查询订单