# PostEx

> PostEx is a Pakistani e-commerce logistics, courier, and fintech platform offering cash-on-delivery fulfilment with instant upfront payments, a business suite, financing, and the XPay payment gateway. This llms.txt was generated by API Evangelist from the catalog and a live probe of the PostEx merchant Order Integration API (no provider-published llms.txt was found).

## APIs

- [PostEx Merchant Order Integration API](https://api.postex.pk/services/integration/api/order): Book shipments, list operational cities, retrieve merchant pickup addresses, track parcels, and list unbooked orders. Auth: merchant API token in the `token` request header.

## Specs

- [OpenAPI (constructed)](https://raw.githubusercontent.com/api-evangelist/postex/refs/heads/main/openapi/postex-order-openapi.yml): 8 operations verified by live probe of api.postex.pk.

## Artifacts

- [Authentication](https://raw.githubusercontent.com/api-evangelist/postex/refs/heads/main/authentication/postex-authentication.yml): apiKey in `token` header.
- [Error codes](https://raw.githubusercontent.com/api-evangelist/postex/refs/heads/main/errors/postex-error-codes.yml): Spring Boot JSON error envelope.
- [Conventions](https://raw.githubusercontent.com/api-evangelist/postex/refs/heads/main/conventions/postex-conventions.yml): URI-path versioning, JSON over HTTPS.
- [Lifecycle](https://raw.githubusercontent.com/api-evangelist/postex/refs/heads/main/lifecycle/postex-lifecycle.yml): coexisting v1/v2/v3.
- [Data model](https://raw.githubusercontent.com/api-evangelist/postex/refs/heads/main/data-model/postex-data-model.yml): Merchant, Order, MerchantAddress, OperationalCity.

## Docs

- [PostEx website](https://postex.pk)
- [XPay payment gateway](https://xpay.postexglobal.com/)