> For the complete documentation index, see [llms.txt](https://developer.esw.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.esw.com/getting-started/get-started-with-esw.md). # Get Started with ESW - [Overview](https://developer.esw.com/getting-started/get-started-with-esw/readme.md): Start here to explore ESW APIs and jump to the main service areas, including customs, pricing, checkout, orders, returns, callbacks, and fulfillment. - [Authentication](https://developer.esw.com/getting-started/get-started-with-esw/readme/quickstart.md): Learn how ESW STS authentication works, how to request OAuth 2.0 access tokens with client credentials, and how to send Bearer tokens on API requests. - [Access Tokens](https://developer.esw.com/getting-started/get-started-with-esw/readme/publish-your-docs.md): Request OAuth 2.0 access tokens from ESW STS using client credentials. Includes required parameters, token endpoint, and code examples - [Postman Collection](https://developer.esw.com/getting-started/get-started-with-esw/readme/postman-collection.md): Download and import the ESW Postman collection + environment to run the sandbox flow (token → PreOrder → redirect). - [Test Cards](https://developer.esw.com/getting-started/get-started-with-esw/readme/test-cards.md): Test card numbers for validating ESW Checkout payments, including non-3DS and 3DS scenarios (Adyen and Computop) with OTP notes. - [Finance and Settlement](https://developer.esw.com/getting-started/get-started-with-esw/finance-and-settlement.md): Making worldwide commerce simple - [Settlement and Billing](https://developer.esw.com/getting-started/get-started-with-esw/finance-and-settlement/settlement-and-billing.md) - [Reconciliation Process](https://developer.esw.com/getting-started/get-started-with-esw/finance-and-settlement/settlement-and-billing/reconciliation-process.md): Reconciliation process for settlements and billing - [Sales](https://developer.esw.com/getting-started/get-started-with-esw/finance-and-settlement/settlement-and-billing/sales.md): Sales process for settlements and billing - [Returns](https://developer.esw.com/getting-started/get-started-with-esw/finance-and-settlement/settlement-and-billing/returns.md): Returns process for settlements and billing - [Refunds](https://developer.esw.com/getting-started/get-started-with-esw/finance-and-settlement/settlement-and-billing/refunds.md) - [Reconciliation Report](https://developer.esw.com/getting-started/get-started-with-esw/finance-and-settlement/settlement-and-billing/reconciliation-report.md): Reconciliation process for settlements and billing - [Pricing](https://developer.esw.com/getting-started/get-started-with-esw/finance-and-settlement/pricing.md) - [Pricing Advisor Example to Settlement](https://developer.esw.com/getting-started/get-started-with-esw/finance-and-settlement/pricing/pricing-advisor-example-to-settlement.md): Follow a worked example from Pricing Advisor output to final ESW settlement, including uplift, blended duty and VAT, FX conversion, rounding, and retailer payout. - [Order Flow from Confirmation to Settlement](https://developer.esw.com/getting-started/get-started-with-esw/finance-and-settlement/order-flow-from-confirmation-to-settlement.md) - [Flow to Order Confirmation & Payloads](https://developer.esw.com/getting-started/get-started-with-esw/finance-and-settlement/order-flow-from-confirmation-to-settlement/flow-to-order-confirmation-and-payloads.md) - [Order Settlement](https://developer.esw.com/getting-started/get-started-with-esw/finance-and-settlement/order-flow-from-confirmation-to-settlement/order-settlement.md) - [Invoicing, Tax and Duties Payment](https://developer.esw.com/getting-started/get-started-with-esw/finance-and-settlement/invoicing-tax-and-duties-payment.md) - [Fully Trade Compliant](https://developer.esw.com/getting-started/get-started-with-esw/finance-and-settlement/invoicing-tax-and-duties-payment/fully-trade-compliant.md) - [Trade Compliance Flow](https://developer.esw.com/getting-started/get-started-with-esw/finance-and-settlement/invoicing-tax-and-duties-payment/trade-compliance-flow.md): Follow the six-step trade compliance flow from product normalization and pricing through customs checks, documentation, and compliant invoicing. - [Invoicing requirements](https://developer.esw.com/getting-started/get-started-with-esw/finance-and-settlement/invoicing-tax-and-duties-payment/invoicing-requirements.md): ESW invoice and credit note requirements by region, including EU, US, rest-of-world, and domestic VAT treatment. - [Payment Terms](https://developer.esw.com/getting-started/get-started-with-esw/finance-and-settlement/payment-terms.md): How ESW settlement payments work, including payout cadence, net settlement components, and how duties, taxes, sales, and returns are treated. - [FAQs and Customization](https://developer.esw.com/getting-started/get-started-with-esw/finance-and-settlement/faqs-and-customization.md): Find answers to common questions about ESW’s merchant-of-record model, reporting, settlement options, and key operational definitions. - [Best Practices](https://developer.esw.com/getting-started/get-started-with-esw/best-practices.md): This section describes the best practices and ESW recommendations that you can follow to ensure the smooth flow of data between your servers and ESW servers. - [APIs](https://developer.esw.com/getting-started/get-started-with-esw/best-practices/apis.md): Best practices for endpoints ESW calls: authenticate requests, return correct status codes, handle retries and bursts, and acknowledge quickly. - [Webhooks](https://developer.esw.com/getting-started/get-started-with-esw/best-practices/webhooks.md): Best practices for ESW webhooks: HTTPS and domain requirements, validate event type/version, respond within 3 seconds, and design for async delivery. - [FAQs](https://developer.esw.com/getting-started/get-started-with-esw/faqs.md): Some frequently asked questions. - [Glossary](https://developer.esw.com/getting-started/get-started-with-esw/glossary.md): Definitions of key ESW terms across checkout, payments, logistics, and reporting. - [Copy of Overview](https://developer.esw.com/getting-started/get-started-with-esw/readme-1.md): Start here to explore ESW APIs and jump to the main service areas, including customs, pricing, checkout, orders, returns, callbacks, and fulfillment. - [Authentication](https://developer.esw.com/getting-started/get-started-with-esw/readme-1/quickstart.md): Learn how ESW STS authentication works, how to request OAuth 2.0 access tokens with client credentials, and how to send Bearer tokens on API requests. - [Access Tokens](https://developer.esw.com/getting-started/get-started-with-esw/readme-1/publish-your-docs.md): Request OAuth 2.0 access tokens from ESW STS using client credentials. Includes required parameters, token endpoint, and code examples. - [Postman Collection](https://developer.esw.com/getting-started/get-started-with-esw/readme-1/postman-collection.md): Download and import the ESW Postman collection + environment to run the sandbox flow (token → PreOrder → redirect). - [Test Cards](https://developer.esw.com/getting-started/get-started-with-esw/readme-1/test-cards.md): Test card numbers for validating ESW Checkout payments, including non-3DS and 3DS scenarios (Adyen and Computop) with OTP notes. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://developer.esw.com/getting-started/get-started-with-esw.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.