Getting started

Build your UAE e-invoicing integration with Wafeq e-invoicing ASP. Submit invoices and credit notes using PINT-AE, connect taxpayers through OAuth consent, and track results through webhooks.

Start your integration

Open the Wafeq e-invoicing ASP portal and select Sandbox.
Read Authentication and create your app's credentials under Developer → Settings and Developer → API keys.
Connect a taxpayer: the business completes onboarding, then grants your app OAuth consent. Onboarding alone does not grant access.
Use the Sandbox guide and API reference to make your first request.
Configure webhooks, handle rate limits, then repeat onboarding and consent in Live when ready.

Base URL

https://api.wafeq.com/ae/v1

Every path in the API reference is relative to this URL. For example, POST /invoices means POST https://api.wafeq.com/ae/v1/invoices.

Live and Sandbox share this URL. A Sandbox API key (pk_test_…) reaches Sandbox, and a Live key (pk_live_…) reaches Live. Their taxpayers, grants, tokens, documents, and webhook endpoints are separate. Always use matching credentials and taxpayer IDs.

For taxpayer-specific requests using an organization API key, also send x-ae-taxpayer-id. A taxpayer OAuth access token already identifies the taxpayer. See Authentication.

Versioning

v1 in the base URL is the API version; a breaking change would ship as a new version. Older integrations using service-host /api/v1/… or /api/… aliases keep working, but https://api.wafeq.com/ae/v1 is the supported address for new integrations.