Skip to main content

Integration go-live checklist

Ensure a smooth and complete transition for your Mamo integration

Updated this week

As you move from the Sandbox testing environment to the Live Production environment, we want to make sure you cover all necessary technical and configuration steps.

Mamo’s Sandbox and Live environments are designed to work almost identically, so moving to Production is usually as simple as switching your API keys and updating your base URL.

If you built a custom API integration (or worked with a developer), take a moment to review the checklist below before going live.

This checklist outlines essential tests, alongside pro-tips and recommended best practices, derived from successful previous integrations.

These steps are essential to make sure you’re ready to start processing traffic and payments from the moment you go live.

You can also download this Go-live checklist for easier usage.

Sandbox testing and verification

Before switching to Production, ensure all payment flows have been fully simulated and passed in Sandbox.

Here's the Sandbox environment: https://sandbox.dev.business.com/

Flows to test

  • Successful payments

  • Failed payments

  • Refunds

→ Here's a complete list of test cases to be covered.

The sheet is AI-friendly; you can share it with your preferred AI tool to give you test cases.

Suggested AI prompt for test validation

You can paste this into your favorite AI assistant:

I am integrating Mamo's payment API in my Sandbox environment. Below is a list of test cases I need to validate.

For each test case:

  1. Explain what I should simulate

  2. Provide a working code example (API request or SDK call)

  3. Add an assertion that verifies the expected outcome — don't just call the API, confirm it actually worked

  4. Explain the expected response

  5. Highlight common implementation mistakes

  6. Suggest debugging steps if it fails

Then generate a test runner that executes all cases in sequence and prints a pass/fail summary with the failure reason for any test that does not pass.

Here are the test cases: [Paste test cases here]

The test cards needed for each scenario are included in the sheet above.

Assume I am using [Node.js / PHP / Python / etc.].

Keep everything practical, runnable, and implementation-focused. Where a test cannot be fully automated (e.g. Apple Pay, manual ops checks), explain the manual verification steps clearly instead.

UX and UI

Before launch, verify your checkout experience is production-ready.

  • Clean UI: Make sure your checkout page is frictionless, and Mamo is embedded on your website without redirection in way that aligns with your brand.

  • Mobile responsiveness: Test the full checkout experience on mobile devices to ensure everything looks clean and works without any redirects.

  • Error messaging: If a payment fails, customers should see clear, helpful messages (for example, “Payment declined”) instead of technical or raw JSON errors.

Security & API configuration

Secure API keys:

  • Make sure your Live API keys are stored securely, like in environment variables or a secrets manager, and never expose them in client-side code.

  • For detailed guidance, check out our best practices for storing your API key.

Get your Live credentials:

  1. Log in to your Mamo Dashboard.

  2. Navigate to the Developer section and select the Keys tab

  3. Create and copy your Live API Key.

Update Base URL:

Switch all backend API calls from the Sandbox URL to the Production URL:


Apple Pay verification (web & app integration)

For web integration (Domain verification):

  1. Make sure your production domain is verified for Apple Pay.

  2. If you haven’t done this yet, email [email protected] to get the Apple Pay verification file.

  3. Upload the file to your domain here:
    https://your-domain.com/.well-known/apple-developer-merchantid-domain-association

  4. Once the file is live, notify Mamo support so they can complete the verification.

For app integration (Direct verification):

  1. Make sure you have a production Merchant ID.

  2. Ensure your processing certificate is verified.

Webhook setup

Register your production webhooks:

  1. Register your production webhook endpoints via API.

  2. Make sure your server is ready to receive live events, such as charge.succeeded or charge.failed, at these URLs.

Verify webhook security:

Check that your endpoint validates the Authorization header (if auth_header was provided on POST /webhook) or confirms the request is coming from Mamo to prevent spoofing.

Final launch steps

Test with real money:

Perform a small live transaction (e.g., 2 AED) using a real credit card to confirm everything works in production.

Test refunds:

Immediately refund the test transaction via the API or Dashboard to make sure the refund flow is working properly.

Let's go!

Did this answer your question?