Setting up Base44 Payments powered by Wix

Set up Base44 Payments powered by Wix to start selling in your app. Connect payments, complete verification, and manage payouts, refunds, and subscriptions.

Base44 Payments powered by Wix is Base44’s built-in payment provider that lets you go from idea to selling in minutes.

You can start selling immediately, with no separate payment provider to set up. You only need to complete your account setup and verification to receive your payouts.

---

Before you begin

Setting up Base44 Payments is quick, and you can start selling straight away. All you have to do is:

1. Connect Base44 Payments using the AI chat in your app editor.
2. Publish your app and go live.
3. Start accepting payments from customers immediately.
4. Complete setup and verification to start receiving payouts.

Important information

Check these details before you set up Base44 Payments:

• You can use Base44 Payments for one-time payments or recurring subscriptions.
• You need a Builder plan or higher.
• Your app must be published and accessible during verification.
• You must have a business and bank account based in one of the supported countries listed below.
• Base44 Payments powered by Wix is available to eligible customers in these countries and currencies:
  • United States: USD
  • United Kingdom: GBP
  • Germany: EUR
  • Netherlands: EUR
  • Spain: EUR
  • Switzerland: CHF
  • Belgium: EUR
  • Portugal: EUR
  • Finland: EUR
  • Lithuania: EUR
  • Austria: EUR
  • Italy: EUR

If your business isn’t in one of these countries, see Using another provider.

Prohibited products and services

To keep payments safe and compliant, some products and services cannot be sold via Base44 Payments powered by Wix. Examples include:

• Illegal products or services
• Certain financial services, investment schemes or high-risk lending
• Some adult content or services
• Weapons, some types of ammunition and related accessories
• Certain gambling or betting services
• Products that encourage hate or violence

The exact list can change over time and may depend on Wix’s banking and payment partners. Review the prohibited products and services policy before you start selling.

---

Connecting Base44 Payments

Once Base44 Payments is connected to your app, securely accept payments from customers using:

• Major credit and debit cards
• Apple Pay
• Google Pay
• PayPal (United States only)
• Buy now, pay later services: Affirm, Klarna, and Afterpay/Clearpay
• Local payment methods: iDEAL, Bancontact, and Twint

Buy now, pay later services and local payment methods depend on the country where your business is based. Learn more in Alternative payment methods.

Payments are processed through Base44 Payments and are subject to applicable service fees and the Wix Payments Terms of Service.

You can start accepting payments as soon as your app is live. Once your account is fully verified, payouts are deposited into the bank account you selected during setup.

To connect Base44 Payments:

1. Go to your app editor.
2. Prompt the AI chat to connect to a payment method. For example: Enable online payments.
   If you are eligible, you’re prompted to connect Base44 Payments.

3. Click Connect to accept Base44 Payments terms of use and service fees.
4. Click Dashboard.
5. Click Overview.
6. Click Manage next to Payments to open the Payments dashboard.

Opening the Payments dashboard from your app dashboard

---

Alternative payment methods

In addition to cards and digital wallets, Base44 Payments powered by Wix supports buy now, pay later services and local payment methods. The methods available to your customers depend on the country where your business is based.

Business country	Available methods
United States	Affirm, Klarna, Afterpay
United Kingdom	Klarna, Clearpay
Austria	Klarna
Belgium	Bancontact, Klarna
Finland	Klarna
Germany	Klarna
Italy	Klarna
Netherlands	iDEAL, Klarna
Portugal	Klarna
Spain	Klarna
Switzerland	Klarna, Twint

Accepting a method

Alternative payment methods are not switched on for you. On the Accept Payments page in your Payments dashboard, each one shows an Accept button, and you accept the methods you want to offer. Each also links to its own qualification and terms. See Managing payment methods.

Accepting alternative payment methods in your Payments dashboard

Qualification and terms

Affirm, Klarna, and Afterpay/Clearpay each set their own qualification criteria, prohibited products, and terms of use, in addition to the prohibited products and services policy. By accepting payments with one of these services, you agree to that provider’s terms.

Review the qualification requirements, supported currencies, and service fees for each service before you start selling:

• Affirm qualification and terms of use
• Klarna qualification and terms of use
• Afterpay/Clearpay qualification and terms of use

Before you start selling with these services:

• The currency in your Wix account must match the currency in your Base44 Payments account. If the currencies don’t match, transactions may be declined.
• Affirm reviews your app in English. If your app is in another language, create a version of your app that can be reviewed in English before selling with Affirm.

---

Completing the setup

Complete your Base44 Payments account setup and verification before receiving payouts.

Details include:

• Your business type and legal name.
• Your business address in one of the supported countries.
• The main contact person’s details.
• The bank account where you want to receive payouts.

Enter and review these details in your Payments dashboard. Some details may require supporting documents to confirm your identity and business information. Follow the guidelines for uploading documentation if you are asked to provide documents.

Until setup is complete and verified, your account may be limited and payouts may be delayed, so upload any requested documents as soon as possible.

---

Getting ready to sell

Before accepting payments with Base44 Payments powered by Wix, make sure your app includes clear business information and policies, and that customers get back to your app after paying. This builds customer trust and helps ensure your Base44 Payments account passes verification without delays.

Business contact details

Add your business name and easy-to-find contact details so customers can reach you if needed.

Best practices include:

• Display your business name clearly, using your legal name or “Doing Business As” name exactly as provided during Base44 Payments setup.
• Add your physical business address, including the country. Post office boxes and mail-forwarding addresses are not considered valid.
• Provide customer service contact details such as an email address and phone number.

Required business policies

Your app should include relevant policies to inform and protect customers, such as:

• Terms and conditions.
• Privacy policy.
• Refund, return, or cancellation policy.
• Shipping, fulfillment, or delivery policy.

Make sure these policies are clearly visible before checkout. For cancellations and returns, include a checkbox or acknowledgement for customers to agree.

Product and pricing details

Provide clear and transparent details about what you sell, including:

• Detailed product or service descriptions.
• Clear pricing and purchase currency.
• Transparent terms for subscriptions or recurring payments, including billing intervals and cancellation options.

If you display card logos on your app, make sure card scheme brands such as Visa and Mastercard appear in full color. These are already shown automatically at checkout.

Checking the return page

After customers pay, checkout sends them back to a Thank You page in your app. When you connect Base44 Payments, Base44 adds this page for you. If the page is missing from your app, or from your published app, customers land on “Page not found” after paying.

The Payments tab warns you when this would happen. In test mode, it checks your app in the app editor, and in live mode, your published app. The warning also appears when you switch to live mode, but it doesn’t stop you from going live.

Base44 doesn’t add the Thank You page automatically to mobile apps, imported apps, or apps that connected Base44 Payments before October 2026. If your app doesn’t have one, add it from the warning on the Payments tab.

To fix the return page:

1. Click Dashboard in your app editor.
2. Click Payments.
3. In the warning, do one of the following:

Add the page

Click Add page in chat. A ready prompt appears in the AI chat. Review it and send it to add the page. Publish your app afterwards so customers can reach the page when you’re live.

Publish your app

Click Publish app when the page is already in your app but not in your published app yet. Publishing adds the page to your live app.

---

Best practices

Following best practices helps you build trust with customers, reduce disputes and chargebacks, and keep your Base44 Payments account in good standing.

Contact information

Add clear and easy-to-find contact details in your app.

• Display your legal business name or Doing-Business-As name.
• Include a physical address or mailing address.
• Provide multiple contact methods such as email, phone number, contact form, or social channels.
• Reply to customers in a timely manner.
• Keep records of all customer communication, especially for disputes.

Clear pricing

Make sure your pricing is transparent and easy to understand.

• Show full prices including currency.
• Clearly display shipping, handling or additional fees before checkout.
• Ensure prices are readable across devices and screen sizes.

Refund and return policies

Keep your refund policy visible and compliant.

• Make the policy concise and easy to understand.
• Display it wherever customers confirm their purchase.
• Ensure it complies with applicable laws.
• Keep it accessible in a central Policies or Help section.

Shipping and delivery information

Clearly explain how and when customers receive their items.

For physical goods:

• Display shipping costs clearly.
• Specify delivery methods and timelines.
• Provide tracking information if available.
• Clarify return shipping responsibilities.

For digital goods:

• Explain how delivery works after payment.
• Clarify download access and traceability.
• Describe available support or refund options.

Privacy policy and terms

Provide a clear privacy policy and terms and conditions, including:

• What data you collect.
• How you use and store it.
• How long you retain data.
• How customers can request access or deletion.

Disputes and chargebacks

Handle disputes quickly to reduce chargebacks.

• Respond to customers promptly.
• Consider refunding early to prevent escalation.
• Keep delivery confirmations and communication records.
• Minimize chargebacks to protect your merchant standing.

---

Managing payments and payouts

Manage payments, payouts, refunds, and reports from your Payments dashboard, with full visibility into your cash flow.

You can also track your app’s revenue, transactions, and subscriptions from your app dashboard. See Tracking payments in your app.

Viewing payments

From the Payments dashboard:

• View each transaction, including its amount, date, payment method, and status.
• Filter by date range, status, or payment method.
• Search for a specific payment using the customer name, order ID, or transaction ID.

This helps track individual payments, answer customer questions, and match orders with payments.

To view your payments:

1. Click Dashboard in your app editor.
2. Click Overview.
3. Click Manage next to Payments.
4. Click All Payments.

Payments dashboard showing payment history and transaction details

Click a payment to view its full transaction details.

Understanding payouts

Base44 Payments powered by Wix groups your successful customer payments into payouts that are deposited into your bank account.

• Payment processing: There is a standard delay between when a customer pays and when the funds are deposited into your bank account. This gives time for processing, refunds and disputes. Processing typically takes 2 to 5 business days.
• Payout schedule: You can usually choose how often you get paid. This can be daily, weekly or monthly, as preferred.
• Payout destination: Payouts go to the bank account you add during setup. You can change this account later, if needed.
• Failed payouts: If a payout fails, your Payments dashboard shows a message explaining what went wrong, for example incorrect bank details.
• Payout details: The Payouts tab lists payouts on hold, your scheduled payout with its estimated arrival date, and sent payouts. Click a payout to see its fees and every transaction in it, and click Download detailed table to save it as a CSV file.

To view your payouts:

1. Click Dashboard in your app editor.
2. Click Overview.
3. Click Manage next to Payments.
4. Click Payouts.

Tracking payout status in the Payments dashboard

Issuing refunds

You can refund your customers directly from your Payments dashboard.

When you issue a refund:

• The refunded amount is taken from your Base44 Payments balance.
• If your balance does not cover the full refund, the remaining amount may be taken from upcoming payments or from your next payout.
• Refunds may take several business days to reach your customer, depending on their bank or payment method.
• Refunds reduce your available balance and may affect the size and timing of your next payouts.

To issue a refund:

1. Click Dashboard in your app editor.
2. Click Overview.
3. Click Manage next to Payments.
4. Click All Payments.
5. Click the payment you want to refund.
6. Click Refund.
7. Enter the amount and a note (if needed), then click Refund.

Handling a negative balance

Your Base44 Payments balance can become negative if you issue refunds or incur chargebacks that amount to more than your available funds.

If your balance is negative:

• New successful payments go toward covering the negative amount.
• Payouts are paused until your balance returns to a positive amount.
• You do not have enough funds to cover any additional refunds or chargebacks that may occur.
• You can return to a positive balance by adding funds to your account using a credit or debit card.

To add funds:

1. Click Dashboard in your app editor.
2. Click Overview.
3. Click Manage next to Payments.
4. Click Payouts.
5. Click Add Funds.
6. Enter your payment details.
7. Click Add Funds.

Important:

• It may take up to 7 business days to process your payment and update your Payments dashboard accordingly.
• Currently, it is not possible to top up a negative balance for PayPal payments. To return to a positive balance for PayPal, you need to receive additional PayPal payments.

Managing payment methods

From the Payments dashboard, you can choose which payment methods you offer your customers. Cards and wallets show their current checkout and payout status. Alternative payment methods show an Accept button instead, which you click to start offering that method. The page shows your Business Location, which is what decides the methods available to you.

To manage payment methods:

1. Click Dashboard in your app editor.
2. Click Overview.
3. Click Manage next to Payments.
4. Click Settings to see your payment methods.

Managing payment methods in the Payments dashboard

Your customers only see the wallet buttons that are supported on their device. For example, Apple Pay appears for customers using Safari on supported Apple devices.

Viewing subscriptions

If your app sells recurring subscriptions, the Subscriptions page lists them and shows your total and active subscription counts. You can filter the list and search for a customer.

To view your subscriptions:

1. Click Dashboard in your app editor.
2. Click Overview.
3. Click Manage next to Payments.
4. Click Subscriptions.

Setting a grace period

A grace period keeps a subscription active for a while after a payment fails, so you have a chance to recover the customer instead of losing them. Grace periods stay off until you turn them on. You choose how long the period lasts, anywhere from 1 to 14 days, and whether the customer’s payment method is retried automatically during that time.

To set a grace period:

1. Click Dashboard in your app editor.
2. Click Overview.
3. Click Manage next to Payments.
4. Click Subscriptions.
5. Click Subscription Settings.
6. Turn on Grace period.
7. Under General settings, enter the number of days.
8. (Optional) Turn on Retry a customer’s payment method automatically during grace period.

Accessing settlement reports

Settlement reports give you a detailed, exportable list of all transactions processed through Base44 Payments powered by Wix.

• See each transaction, its status and the related payout.
• View the Base44 Payments service fee for each transaction.
• Download a CSV file of the full report for accounting or tax purposes.
• Filter by date range or transaction type before you download.

You can usually access your settlement report even if your Base44 Payments account is disconnected, which lets you keep historical records for your business.

To access your settlement report:

1. Click Dashboard in your app editor.
2. Click Overview.
3. Click Manage next to Payments.
4. Click Settlement Report.
5. (Optional) Filter the report, or click Download Detailed Table.

---

Using another provider

You can take payments in your app with any provider that offers an API. Base44 Payments and Stripe are built in. For any other provider, such as PayPal, Paystack, Mercado Pago or Razorpay, the AI chat connects it to your app through the provider’s API.

This is useful if Base44 Payments isn’t available where your business is based, or if you’d rather use a provider you already work with. If your business is in the United States, Base44 Payments already includes PayPal, so you don’t need a separate PayPal setup.

Before you connect another provider:

• You manage your account, fees and terms with the provider.
• Only Base44 Payments and Stripe payments appear on the Payments tab in your app dashboard. For any other provider, you see payments, payouts and refunds in that provider’s own dashboard.
• You need a Builder plan or higher, because the integration runs on backend functions.

Choose the option that fits your business.

Set up Stripe

Stripe is built into Base44, so the AI chat installs it, creates your checkout and gives you a test environment before you go live. Stripe supports businesses in many countries, so check Stripe’s supported countries before you start.

Learn more in Setting up Stripe.

Connect a provider with its API

The AI chat builds the connection with backend functions. Your provider’s API keys are saved as app secrets, and a webhook lets the provider tell your app when a payment goes through.

Before you start, create an account with the provider and copy your test API keys from its dashboard. Test payments on your published app, because custom payment flows usually don’t work in preview. When you’re ready to go live, replace your test keys with live keys and publish your app again, since your live app keeps the secret values from your last publish.

To connect another provider:

1. Go to your app editor.
2. Describe the provider and the payment flow you want in the AI chat. For example:
   Add Paystack checkout to my app for one-time payments. Use a backend function to create the payment, store my secret key as a secret, and add a webhook function that marks the order as paid when Paystack confirms the payment.
   
3. Paste your API keys when the AI chat asks for them, or add them yourself as app secrets.
4. Copy the webhook URL the AI chat gives you and add it in your provider’s dashboard.

---

Troubleshooting

If Base44 Payments powered by Wix cannot verify your app, payments and payouts may be delayed. Review the topics below for common verification issues and solutions.

Common verification issues

• Your app is not published: Click Publish in the app editor and publish your app.
• Your app was deleted: Restore or recreate the app so Base44 Payments powered by Wix can scan it.
• Your domain has expired: Renew your domain through Base44 or your domain provider.
• Your domain is still propagating: DNS changes may take up to 48 hours to complete.
• SSL issues: Fix any security certificate errors on your domain.
• Geographic restrictions: Remove any third-party apps or code blocking access from certain regions.

App accessibility in certain regions

Base44 Payments powered by Wix must be able to access your app globally during verification.

If your app is restricted in certain regions by third-party tools or custom code, Base44 Payments powered by Wix may not be able to verify your account. This can disrupt payment processing and payouts.

To resolve this:

• Remove geographic restrictions from any third-party apps or custom code.
• Republish your app after applying the changes.

---

FAQs

Click a question below to learn more about using Base44 Payments powered by Wix with Base44.

When do I receive my payouts?

After a customer pays, there is usually a short delay before the money is sent to your bank account. The exact timing depends on your payout schedule and on factors such as weekends and bank holidays. You can see the expected payout date for each payout in your Payments dashboard. Your Base44 Payments account must also be fully verified before you can receive payouts.

Can I change the bank account where I receive payouts?

Yes, you can update your payout bank account details from your Payments dashboard. Be aware that when you update your Base44 Payments account details, your account may need to be reverified and your payouts may be put on hold until verification is complete.

Does Base44 Payments support recurring subscriptions?

Yes, you can offer recurring subscriptions alongside one-time payments. Ask the AI chat to set up subscription payments on your app. See Viewing subscriptions.

Read more: Creating and managing subscriptions

Can I accept donation payments with Base44 Payments powered by Wix?

Yes, you can use Base44 Payments powered by Wix to accept donations.

To accept donations through Base44 Payments powered by Wix:

• Your cause must be registered as a charity.
• You may not accept donations on behalf of someone other than yourself. For example, you may not collect donations in the name of a well-known charity.
• A donation must be tied to a specific charitable purpose that you, or your team, are committing to accomplish and donations must be used for the charitable purpose described to the donor.

Base44 Payments powered by Wix does not support non-registered charities, crowdfunding, donation aggregations, or charities that do not manage the entire flow of funds.