Introduction

Mozarto is a payment orchestration platform. Integrate once with Mozarto and accept Pay-Ins and process Pay-Outs through multiple payment providers (PSPs). Mozarto handles provider authentication, routing, and status normalisation on your behalf.

Choose your integration

	Redirect API	Hosted page API
Endpoint	`POST /v1/api/mozarto/cashier`	`POST /v1/api/mozarto/checkout/session`
Who picks the provider	Your platform, per request (`pspType`)	Mozarto, from the methods configured for your brand
Payment page	Hosted by the PSP	Hosted by Mozarto (redirect or iframe)
Operations	Pay-In and Pay-Out	Pay-In
Request body	Provider fields per `pspType`	`country`, `baseamount`, `currency`, `returnUrls` - the rest comes from the back office
Final status	Webhook to your `webhookUrl`	Webhook to the provider account's webhook URL (page events and return URLs for the UI)
Start here	Pay-In Flow	Pay-In Flow

Both integrations use the same authentication and the same back-office configuration.

Environments

Environment	Redirect API base URL	Hosted page API base URL	Back office
Sandbox	`https://backend.stg-app.mozarto.io`	`https://checkout-api.stg-app.mozarto.io`	`https://stg-app.mozarto.io`
Production	`https://backend.app.mozarto.io`	`https://checkout-api.app.mozarto.io`	`https://app.mozarto.io`

Paths are identical across environments. Sandbox runs the same code as Production against test provider accounts. Each environment has its own credentials.

Get started

1. Register and get credentials

Register your company at https://app.mozarto.io/registration, then log in to the back office. Open Admin Center - API Credentials, unlock the page with your 2FA code, and copy your brand Token and Secret key. See Authentication.

2. Configure a payment provider

In Payments Module, select your brand, open the provider account, unlock the API Credentials section of the Processing Scope tab with your 2FA code, and save the provider's credentials. The Processing Scope must cover the country and currency you send, or the request is rejected. See the PSP overview.

For the Hosted page API, also add the method to an active Payment Page for the shopper's country.

3. Make the first request

Send country on every request. It is matched against the Processing Scope.

For the Hosted page API, create a session instead and open the returned checkoutUrl. See Pay-In Flow - Create the session.

4. Receive the result

Redirect API: Mozarto sends the final transaction_status to your webhookUrl. Only apply balance or order changes on a final status. See Webhook Setup.

Hosted page API: Mozarto sends the same webhook to the webhook URL configured on the provider account. The page also reports the outcome to the shopper's browser for your UI. See Webhook Setup.

The API response never confirms payment. It confirms that the transaction or session was created.

1. Introduction

Introduction#

Choose your integration#

Environments#

Get started#

1. Register and get credentials#

2. Configure a payment provider#

3. Make the first request#

4. Receive the result#