# Wix integration

Server-side integrations with explicit payment confirmation and safe retries.

> This is a site-specific Velo service plugin. Wix does not accept this ZIP as an App Market installation. A public payment-provider app requires Wix’s separate partner approval.

## Add Atlas Pay to your site

[Download Wix integration source · ZIP](https://dashboard.atlaspay.sh/downloads/atlas-pay-wix-0.1.0.zip)

1.  Enable Velo on your published HTTPS Wix commerce site. Add a Payment Provider service plugin called `atlas-pay` in the editor’s Service Plugins area.
2.  Copy the supplied `payment-provider` file contents into Wix’s generated provider/config files. Preserve Wix’s generated manifest and file names.
3.  Add the two Atlas Pay backend modules. Merge the supplied HTTP function into `backend/http-functions.js`; do not overwrite existing functions.
4.  Create an Admin-only CMS collection with ID `AtlasPayWebhookEvents`, a text `eventId` field, and a date `processedAt` field.
5.  Publish. Your callback is `https://YOUR-SITE/_functions/atlasPayWebhook`. Include the site path if using a wixsite.com address.
6.  Create an Atlas Pay key for the exact published origin and callback with all six permissions. In Wix Secrets Manager, save `ATLAS_PAY_API_KEY` and `ATLAS_PAY_WEBHOOK_SECRET`.
7.  Connect the custom provider under Accept Payments. Enter `ATLAS_PAY_API_KEY` as the secret-name field. Match your Wix merchant country and currency to Atlas Pay.

## How it works

Wix supplies the authoritative order amount and transaction ID. The provider creates a checkout with a stable idempotency key, then returns its hosted redirect URL. Signed callbacks fetch current Atlas Pay status and call Wix’s backend `submitEvent`. The customer’s return URL never approves payment by itself.

Refund requests use the Wix refund ID as their stable reference. Pending payments/refunds wait for subsequent updates. Secrets are read only in elevated backend code, never from a public web method or browser module.

## Scope & release requirements

The code supports one-time hosted checkout and full/partial refunds. It does not support Wix recurring plans, stored payment credentials, manual capture, or a public provider marketplace listing. A payment-capable Wix plan and available service-plugin access are required.

The source includes local contract tests, but a published Wix store must still pass the [acceptance checklist](https://dashboard.atlaspay.sh/docs/testing). Follow the README inside the download for recovery and rotation. There is no scheduled Wix event-recovery job in this preview.

Official guidance: [site-specific provider tutorial](https://dev.wix.com/docs/develop-websites/articles/code-tutorials/wix-pay/tutorial-payment-provider-service-plugin) and [public PSP approval process](https://dev.wix.com/docs/api-reference/business-management/payments/payment-service-provider-service-plugin/introduction).

---

Source: [Atlas Pay — Wix integration](https://dashboard.atlaspay.sh/docs/wix)

Prepared by Kyle Campbell