Skip to main content

Documentation Index

Fetch the complete documentation index at: https://www.macaly.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

Macaly’s Stripe integration enables you to accept one-time payments directly within your project. A fully functional test environment is provisioned automatically, so you can start building and testing without a Stripe account. When you’re ready to go live, connect your Stripe account and switch to live mode.
Available on the Pro and Enterprise plans

​
Adding payments to your project

Describe your payment needs to the agent in the chat. For example: 
I want to sell my skincare products online. I need a shop
with a catalog and checkout so customers can pay with a card.

I wrote an e-book and want to sell it for $19. Create a page
where people can pay and download it right away.
The agent creates your project with a complete payment flow and provisions a Stripe test environment in the background. To add payments, you can also start from the Payments tab in the top navigation bar. You can begin testing immediately using the test card displayed in the Payments tab:
FieldValue
Card number4242 4242 4242 4242
ExpiryAny future date (e.g. 01/30)
CVCAny 3 digits (e.g. 111)
ZIPAny value (e.g. 11000)
Navigate to your project, complete a test purchase, and verify the checkout experience.
You can also test error scenarios like declined cards or invalid payment data using Stripe’s dedicated test cards. See Stripe’s testing documentation for the full list of test card numbers and the errors they simulate.

​
Activating your secure testing area

When Macaly creates your test environment, it provisions a Stripe sandbox. This sandbox works right away and lets you test payments, but it is not linked to any Stripe account. Unclaimed sandboxes expire after 60 days. Claiming the sandbox connects it to your Stripe account. Once claimed, the sandbox is yours to keep and you can manage it directly in the Stripe Dashboard. You can claim the sandbox in two ways: from the Payments tab in your project, or through the email that Stripe sends you after the test environment is created. Claiming is also the first step toward accepting real payments. To go live, you will need to claim the sandbox, verify your business with Stripe, and enter your live API keys.
1

Open the Payments tab

Open the Payments tab in your project. Under “Activate your secure testing area,” you will see a Claim your Stripe sandbox button.
2

Click Claim your Stripe sandbox

Stripe opens in a new tab with the Claim your sandbox page.If you have an existing Stripe account, select it from the list. Otherwise, click + Create new account to create one at no cost.Click Continue to proceed.
3

Provide your business details

Stripe will ask for some basic information:
  1. Business name and location. Enter your business name and select your country. Click Continue.
  2. Business website and description. Provide your website URL and a brief description of your products or services. This step can be skipped by clicking Skip.
  3. Intended use of Stripe. Select the payment types relevant to your business (e.g. non-recurring payments). This step can also be skipped.
4

Complete the sandbox setup

On the final screen, Stripe presents a summary of next steps: complete your setup, switch to live mode, and begin accepting payments. Click Go to sandbox to finish.
5

Return to Macaly

Navigate back to Macaly. The Payments tab should now display Payments are in Test mode in orange, confirming that the claim was successful.
Status updates may take a few moments to sync. If the claim button is still visible, refresh the page.

​
Switching to Live mode

When you’re ready to accept real payments, you need to activate your Stripe account and connect your live API keys to Macaly.
You are responsible for all legal and tax obligations related to payments you accept through your project. Consult a tax advisor if you are unsure about your obligations.

​
Activate your Stripe account

Before you can access live API keys, Stripe requires you to verify your business. This is a standard onboarding process that happens entirely on Stripe’s side.
1

Open the Stripe Dashboard

Go to dashboard.stripe.com and sign in to the account you used to claim the sandbox.
2

Complete the setup guide

Stripe will prompt you to complete your account setup. This typically includes:
  • Business details (legal name, address, type of business)
  • Personal identity verification
  • Bank account or payout details for receiving funds
Follow Stripe’s setup guide until all steps are marked as complete.
3

Wait for verification

Stripe reviews your information and activates your account. This is usually instant but may take up to a few days depending on your country and business type.Once verified, your account is live and your live API keys become available in the Dashboard.
You can continue building and testing your project in test mode while waiting for Stripe to verify your account.

​
Enter your live API keys

Once your Stripe account is verified, copy your live keys into Macaly.
1

Copy your keys from the Stripe Dashboard

In the Stripe Dashboard, your API keys are displayed in the API keys card on the right side of the homepage. You can also find them under Developers → API keys at the bottom of the sidebar.You will see two keys:
  • Publishable key begins with pk_live_.
  • Secret key begins with sk_live_.
Copy both keys.
Your secret key provides full access to your Stripe account. Never share it or paste it into the chat.
2

Add your keys in Macaly

In the Payments tab, click Add Stripe connection. Paste each key into the corresponding field and click Save API keys. Make sure you are using your live keys (starting with pk_live_ and sk_live_), not test keys (pk_test_ and sk_test_).
3

Switch to Live mode

Click Switch to Live mode. Macaly reconfigures your project to use your live Stripe account. The status will update to Payments are Live in green.
4

Publish your project

Publish your project to deploy the changes. Live payments are only processed on the published site, not in preview.

​
Managing your integration

All payment settings are accessible from the Payments tab:
  • Open Stripe opens the Stripe Dashboard where you can review transactions, issue refunds, and track payouts.
  • Switch to Live mode / Switch to test mode allows you to toggle between environments at any time without affecting your project code.
  • Manage Stripe connection allows you to update your live API keys after the initial configuration.
  • Test payments displays the test card details for reference while in test mode.

​
Troubleshooting

A sandbox is a temporary test environment that Macaly creates for you. It comes with its own test API keys and lets you simulate payments without touching real money. It is not your Stripe account. When you claim the sandbox, you link it to your actual Stripe account. Until you claim it, the sandbox is anonymous and expires after 60 days.
Ensure you are using the test card number 4242 4242 4242 4242 with any future expiry date, any 3-digit CVC, and any ZIP code. If the issue persists, review the chat for error details or ask the agent to diagnose the payment flow.
Test mode uses the sandbox environment with test keys. All payments are simulated and no real money is involved. Live mode uses your verified Stripe account with live keys. Real money is charged and deposited to your bank account. You can switch between modes at any time in the Payments tab. Switching modes does not affect your project code, only which Stripe keys are active.
Claiming the sandbox and verifying your Stripe account are two separate steps. Claiming links the sandbox to your account, but you still need to complete Stripe’s business verification (identity, business details, bank account) before live keys are generated. Open the Stripe Dashboard and follow the setup guide to finish verification. If you only see test keys (beginning with pk_test_ and sk_test_), your account has not been fully verified yet.
Verifying your Stripe account does not automatically switch Macaly to live mode. You need to manually enter your live API keys in the Payments tab and then click Switch to Live mode. Macaly keeps you in test mode until you explicitly switch.
Check three things in order:
  1. Did you publish your project? Live payments are only processed on the published site, not in preview.
  2. Are your keys correct? Verify that you entered your Publishable key (beginning with pk_live_) and Secret key (beginning with sk_live_). If you accidentally pasted test keys, click Manage Stripe connection and update them.
  3. Is your Stripe account fully verified? Open the Stripe Dashboard and check for any pending steps in the setup guide. Stripe may require additional documents before processing live payments.
Unclaimed sandboxes expire after 60 days. Open the Payments tab and click Set up new sandbox to provision a new environment. Your existing payment code remains unchanged. If you had already claimed and verified your Stripe account, you will need to re-enter your live keys after provisioning a new sandbox.

​
Good to know

  • Stripe fees apply. Macaly does not charge additional fees for payments. Standard Stripe processing fees apply to each transaction (see stripe.com/pricing).
  • Sandbox expiry. Unclaimed test environments expire after 60 days. If this occurs, open the Payments tab and click Set up new sandbox to provision a new one.
  • Webhooks are managed automatically. Macaly configures and maintains all webhook endpoints. No manual setup is required in the Stripe Dashboard.
  • Test and live environments are isolated. Test transactions do not appear in your live Stripe account, and no real charges are incurred.