Going live

Move from the Sandbox to Production: verify your organization, create Production keys, choose your payment methods, set up webhooks and add the bank account for your payouts.

Every new organization starts with a Sandbox environment, where you can build and test with test phone numbers without moving real money. To take real payments you need a Production environment, which Moosyl opens for your organization once it has been verified.

Verify your organization

In the dashboard, open Verification (or click Get Verified on the "Account Unverified" banner) and fill in:

Company information: your Tax Identification Number (NIF) and your tax identification certificate (PDF or image).
Representative information: the full name and national ID number of an authorized representative of the company, and a copy of their national ID (PDF or image).

Then click Submit Verification. The status becomes Verification Under Review while the Moosyl team reviews it, and you'll be notified once it's processed. You can keep building in the Sandbox in the meantime.

If your verification is rejected, the dashboard shows why. Update your information and click Resubmit Verification.

When it's approved, the status becomes Verification Approved and your organization gets a Production environment. We'll also invite you to book an onboarding call to help you go live.

Switch to Production and create keys

Use the environment switcher to select Production. API keys belong to one environment, so your Sandbox keys won't work here. Open API Keys and click Create API Key to create a secret key for your server and a publishable key for your app or website.

Replace the Sandbox values of MOOSYL_SECRET_KEY and MOOSYL_PUBLISHABLE_KEY in your production configuration. See API keys.

Choose your payment methods

An organization admin can open Settings → Payment methods and choose, under Accepted payment methods, which bank apps your customers can pay with. Every method Moosyl offers is accepted by default.

A method you enabled doesn't show at checkout?

Some payment methods have to be activated for your account by Moosyl. If a method is switched on in your settings but doesn't appear on your checkout page, contact us and we'll activate it.

Set up your Production webhooks

Webhooks belong to one environment too. With Production selected, open Webhooks, click Create Webhook, enter your production endpoint and a new secret, and select the events you handle. Store that secret on your server as MOOSYL_WEBHOOK_SECRET. See Webhooks.

Add the bank account for your payouts

Open Settings → Payout settings and add your bank account (IBAN). Moosyl pays out your completed Production payments to this account, and you can follow each payout under Payouts in the dashboard. Payouts aren't available in the Sandbox.

Moosyl charges 1% per successful payment, with no monthly or setup fees. Failed payments cost nothing. See pricing.

Checklist before your first real payment

You've run the whole flow in the Sandbox with the test phone numbers, including a failed payment.
Your server marks an order paid only when a webhook arrives with data.status set to completed, not when the customer returns to your site.
Your webhook handler verifies the signature on the raw body and ignores duplicate deliveries using the x-webhook-delivery-id header.
Your secret key is only on your server, never in your app or website code.
Your code handles API errors: see Errors.
Your production configuration uses the Production keys and the Production webhook secret.

Need a hand? Book an onboarding call or contact us.