# 合作方高频问题

{% hint style="info" %}
遇到 API 接入问题时，可登录 [Eva](https://www.atriptech.com/) 寻求帮助。
{% endhint %}

第一次集成会议前，可先用这页做简短预读。

它同时面向商务、产品和技术角色。

### 1. Which booking flow should we use?

Use `search.do` when Atlas is your main shopping source.

Use `getOffers.do` when you already know the itinerary or need an independent real-time price check.

The standard flow is:

1. `search.do`
2. `verify.do`
3. `order.do`
4. `pay.do`
5. `queryOrderDetails.do`

See [Booking Overview](https://app.gitbook.com/s/cAlPPpTunfEGdmk5fy1e/readme/booking-overview).

### 2. Why can search price and booking price differ?

Search may use cached data.

Verify or Get Offer checks live fare and availability before booking.

Use the latest verified or offered price as the source of truth.

### 3. How should we protect price integrity?

Keep the refresh point close to booking.

Avoid long delays between price check and order creation.

Treat price refresh as a required business rule, not only a technical detail.

### 4. Does Atlas support fare families, baggage, and seats?

Yes, but support depends on airline and flow.

Fare families can be returned in search.

Baggage and seat queries should stay optional unless they are required for conversion.

See [Seats & Baggage](https://app.gitbook.com/s/cAlPPpTunfEGdmk5fy1e/readme/booking-overview/seats-and-baggage).

### 5. Which payment modes are available?

The main options are:

* **Deposit**
* **VCC pass-through**

Atlas does not issue VCC cards.

You provide the card details when VCC pass-through is used.

See [Payments](https://app.gitbook.com/s/cAlPPpTunfEGdmk5fy1e/troubleshooting-and-support/faqs/atlas-api-payments).

### 6. Is ticketing synchronous?

Not always.

Payment and final ticket issuance may complete at different times.

Your system should poll order status after payment until the final state is confirmed.

### 7. Is `pnrCode` the airline PNR?

No.

`pnrCode` is the Atlas booking reference.

The airline PNR appears later after ticketing and should be read from order query.

### 8. Are webhooks enough for status tracking?

No.

Webhook delivery is best effort.

Use webhook as a helpful signal, not the only source of truth.

Your final reconciliation path should still include order query and airline communication when needed.

### 9. How are refunds and changes handled?

Refund behavior depends on payment mode.

VCC refunds usually return to the original card.

Deposit refunds are credited back after Atlas receives airline funds.

Booking changes are generally handled through ATRIP service requests, not a generic self-service API flow.

See [Post-booking](https://app.gitbook.com/s/cAlPPpTunfEGdmk5fy1e/troubleshooting-and-support/faqs/atlas-api-post-ticketing).

### 10. What should be ready before UAT and go-live?

Before UAT:

* sandbox integration is stable end to end
* main booking flow is working
* identifiers and authentication are handled correctly
* webhook handling is ready if required

Before go-live:

* UAT is approved
* production credentials are generated
* IP whitelist is ready
* endpoints are switched correctly
* first live orders can be monitored closely

See:

* [UAT Validation](https://app.gitbook.com/s/cAlPPpTunfEGdmk5fy1e/readme/quick-start/uat-submission-guide)
* [Production Go-Live](https://app.gitbook.com/s/cAlPPpTunfEGdmk5fy1e/readme/quick-start/production-go-live)

### 如果只能先对齐 5 件事

Start with these:

* chosen booking flow
* price refresh rule
* payment mode
* polling and final status rule
* post-booking ownership

### 相关页面

* [接入前](https://resources.atriptech.com/api-wen-dang/pai-zhang-yu-zhi-chi/faqs/jie-ru-qian)
* [启动会议清单](https://resources.atriptech.com/api-wen-dang/pai-zhang-yu-zhi-chi/faqs/qi-dong-hui-yi-qing-dan)
* [常见问题](https://resources.atriptech.com/api-wen-dang/pai-zhang-yu-zhi-chi/faqs)