Introduction

Mozarto is a payment orchestration platform that lets your platform accept Pay-Ins and process Pay-Outs through multiple payment providers - using a single, unified API.

Instead of building a separate integration for each payment provider, you integrate with Mozarto once. Mozarto handles provider authentication, routing, and status normalisation on your behalf.

Merchant registration

Mozarto is a merchant platform. To obtain API access, you must first register your company.

Navigate to https://app.mozarto.io/registration and complete the registration form with the following details:

Field	Description
First name	Your first name
Last name	Your last name
Email address	Your business email address - used for account login and notifications
Company name	The legal name of your company
Billing currency	The primary currency in which your company operates
Country	The country of company registration

After submitting the form, log in to the Mozarto back office. You will find:

Admin center - account settings and payment method configuration.

API Credentials - the company credentials required to authenticate all API calls to Mozarto.

Proceed to Quick Start once you have your API credentials.

Environments

Mozarto provides two environments. Use Sandbox for all development and testing - it runs the same code as Production but against test payment provider accounts.

Environment	Base URL	Purpose
Sandbox	`https://backend.stg-app.mozarto.io`	Client testing and integration verification
Production	`https://backend.app.mozarto.io`	Live traffic

All API paths are identical across environments. To switch environments, change the base URL only - the path (/v1/api/mozarto/cashier) stays the same.

Sandbox and Production use separate credentials. Obtain your Sandbox credentials by logging in to the Sandbox back office at https://stg-app.mozarto.io and navigating to Admin Center - API Credentials.

The integration model

Key points:

Your platform never communicates with payment providers directly.

Mozarto handles authentication for each provider server-side using credentials you configure in the back office.

Most flows are asynchronous: the API call returns immediately with a redirect URL or acknowledgement; the final confirmed/failed status is delivered to your webhook endpoint.

What you need to build

To integrate a payment provider through Mozarto, you need to implement three things:

Initiate a transaction - call the Mozarto Cashier API when a user wants to Pay-In or Pay-Out.

Handle the redirect - open the URL returned by Mozarto in the user's browser (for Pay-In flows). The response field name for this URL varies by provider - for example, data.url, data.paymentUrl, data.redirect_url, or data.webflowURL. Check the relevant PSP page for the exact field name before implementing redirect logic.

Receive the webhook - expose an HTTPS endpoint that Mozarto calls with the final transaction status.

That is the complete integration. Each payment provider follows this same pattern; only the request body fields differ.

Supported payment providers

Provider	Pay-In	Pay-Out	Type
ForumPay	✓	✓	Cryptocurrency
Gigadat	✓	✓	Bank transfer
Worldpay	✓	-	Manual card form / Apple Pay / Google Pay
Trust Payments	✓	-	Card
Cleo	✓	✓	Bank transfer
Payone	✓	✓	Bank transfer
Neosurf	✓	-	Voucher
Flexepin	✓	-	Voucher
Brite	✓	-	Bank transfer

1. Introduction

Introduction#

Merchant registration#

Environments#

The integration model#