Overview

Connect Wix Payments, resolve the name it needs for onboarding, and manage dashboard access

The Apps API is in beta. Its endpoints and responses may change.

Wix Payments is the current Wix-based payment integration. Payments by Wix is a legacy predecessor kept only for apps that already connected it.

Onboarding name

Connecting Wix Payments creates a Wix Payments account, which requires a first and last name. If the caller doesn’t supply one, Base44 falls back to the platform user’s own first and last name. If neither is available, account creation fails.

Resolve Wix Payments onboarding name lets you check ahead of that call whether the platform user already has a usable name on file. It checks the caller’s saved profile first, then the billing name on their personal workspace. The two names are returned together or not at all. A first name with no last name, or the reverse, counts as not found, with needs_full_name true and both name fields null.

Wix site connection

Connecting Wix Payments or Payments by Wix links the app to a Wix site. That link is separate from the payment integration itself and outlives it. Disconnecting removes the integration’s stored credentials but leaves the site link in place, so dashboard access keeps working. Wix Payments and Payments by Wix share the same site link, so connecting either one gives both dashboard access.

Test mode

While test mode is on, Wix Payments checkout takes test payments instead of charging real cards, without needing a deploy. Switch Wix Payments test mode toggles it. Sending the mode the app is already in changes nothing.

To make a test purchase, pay with one of these card numbers. The checkout rejects any other card number, including real cards.

Card number	Result
4111 1111 1111 1111	Approved
4000 0000 0000 0002	Declined

Payments by Wix

Payments by Wix is a legacy integration. It supports existing connections only, and new installations are not supported.

Endpoints

Wix Payments

• Resolve Wix Payments onboarding name: Look up the caller’s first and last name for onboarding.
• Get Wix Payments dashboard link: Get a one-time link to the app’s Wix Payments dashboard.
• Switch Wix Payments test mode: Switch checkout between test mode and live.
• Disconnect Wix Payments: Disconnect the integration and remove its stored credentials.

Payments by Wix (legacy)

• Get Payments by Wix dashboard link: Get a one-time dashboard link for an existing connection.
• Disconnect Payments by Wix: Disconnect an existing connection.