PSP Overview#
Supported operations#
Endpoint#
All transactions use the same endpoint. Set pspType to select the provider:POST /v1/api/mozarto/cashier
| Body field | Description |
|---|
pspType | Provider code - see values in the table below |
type | "PAYIN" for Pay-In, "PAYOUT" for Pay-Out |
country | Country of the payer - required on every request (see Country) |
pspType values#
| Provider | pspType |
|---|
| ForumPay | "FORUMPAY" |
| Gigadat | "GIGADAT" |
| Worldpay | "WORLDPAY_EU" |
| Trust Payments | "TRUST" |
| Cleo | "CLEO" |
| PayOne | "PAYONE" |
| Neosurf | "NEOSURF" |
| Flexepin | "FLEXEPIN" |
| Brite | "BRITE" |
| emerchantpay | "EMERCHANTPAY" |
| Contiant | "CONTIANT" |
| PawaPay | "PAWAPAY" |
| CashLib | "CASHLIB" |
| OFApay | "OFAPAY" |
| PayModum | "PAYMODUM" |
Pay-In request fields - at a glance#
| Field | ForumPay | Gigadat | Worldpay | Trust | Cleo | PayOne | Neosurf | Flexepin | emerchantpay | Contiant | Brite | PawaPay | CashLib | OFApay | PayModum |
|---|
baseamount | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
currency | ✓ | optional | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
email | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | optional | optional | - | - | from token | ✓ |
country | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
firstName / lastName | - | optional | ✓ | ✓ | ✓ | ✓ | - | - | ✓ | optional | optional | - | - | from token | ✓ |
phone | - | ✓ | ✓ | ✓ | ✓ | ✓ | - | - | optional | - | - | optional | ✓ | ✓ | optional |
| Card details | - | - | ✓ | ✓ | - | - | - | - | ✓ | - | - | - | - | - | - |
voucherPin | - | - | - | - | - | - | - | ✓ | - | - | - | - | - | - | - |
dob | - | - | ✓ | ✓ | ✓ | - | - | - | - | - | optional | - | ✓ | - | optional |
| Full address | - | optional | ✓ | ✓ | ✓ | - | - | - | optional | - | optional | - | ✓ | optional | optional |
paymentMethod | - | - | - | - | - | - | - | - | - | - | - | - | - | ✓ | - |
ssn | - | - | - | - | - | - | - | - | - | - | - | - | - | - | optional |
For the full field list for each provider, click through to the individual PSP page.Country#
Send country on every Pay-In and Pay-Out request, for every provider. Mozarto matches it against the Processing Scope configured for the provider - first at company level, then on the account your brand uses (Payments Module - your brand - the account - Processing Scope). A request whose country falls outside either scope is rejected with HTTP 400.Accepted values#
For scope matching, Mozarto accepts any of three forms, case-insensitively, and normalizes them internally:| Form | Example |
|---|
| Full country name | "Germany" |
| ISO 3166-1 alpha-2 | "DE" |
| ISO 3166-1 alpha-3 | "DEU" |
Mozarto converts the value to the format each provider needs, so the same three forms work for every provider. Some providers serve only certain countries (for example, Cleo serves only Chile, Peru, and Mexico), and several derive the charged currency from the country - see the provider page.If you omit it#
Mozarto resolves the country by geo-locating the caller's IP address and continues with the country it detects. Treat that as a safety net, not a feature:Server-to-server calls, proxies, VPNs, and load balancers report the country of your infrastructure, not the payer's. A wrong country routes the transaction to the wrong account or rejects it.
When the IP cannot be resolved to a country, the scope check is skipped entirely, so a request that should have been rejected may go through to the provider.
Providers that need the country in their own payload still fail without a usable value.
country explicitly.Modified at 2026-11-02 13:15:49
