Setting the file. One moment.
Subchapter 8.68
references/get-paid/how-to-setup-wix-payments.mdMarkdown3 KBView on GitHub
This recipe covers the setup flow needed before creating payment links or collecting payments.
Before connecting Wix Payments, collect and confirm:
properties.locale.country via GET https://www.wixapis.com/site-properties/v4/propertiesWix Payments self-serve connect is currently supported for these countries: US, CA, GB, ES, AT, BE, FI, DE, IT, NL, PT, CH, LT.
If the site’s country is not on this list, stop here — do not call connect. Tell the user self-serve connect isn’t available yet for their country, and point them to the dashboard instead (Settings → Accept Payments).
Call:
POST https://www.wixapis.com/payments/v1/wix-payments-account/connect{
"account": {
"firstName": "<USER_FIRST_NAME>",
"lastName": "<USER_LAST_NAME>",
"tosAccepted": true,
"productDescription": "<PRODUCT_DESCRIPTION>",
"country": "<COUNTRY_CODE verified in Step 2>"
}
}If setup fails due to location details, update the business location and retry:
PUT https://www.wixapis.com/locations/v1/locations/{locationId}If the account is already connected, the API returns HTTP 500 with a body like:
{
"message": "payments already connected",
"details": { "applicationError": { "code": "INTERNAL_ERROR" } }
}Match on the message text, not on the code alone — INTERNAL_ERROR is a generic code reused for unrelated failures too. On this match, skip reconnect and continue with onboarding checks.
If account.country isn’t one of the countries listed in Step 2, expect an INVALID_ARGUMENT-style HTTP 400 error. Step 2’s own check should make hitting this rare — don’t retry the call with a different country value; tell the user the same thing Step 2 would have.
Connecting the account is not always the final step. To receive payments, the site owner may still need to complete Wix Payments onboarding in the site dashboard.
Connecting Wix Payments and being able to accept real checkout payments are two separate gates: the site may also need a premium eCommerce plan (Settings → Plans). Mention this even after a successful connect.