Can I disable Second Chance through API?

Yes, it is possible to disable Second Chance through the dedicated API. This can be done in the transaction request when you create an order, by using the value false instead of true.

Does MultiSafepay still offer the XML API?

The XML API is deprecated and succeeded by the JSON API
The XML endpoint can still be used to process transaction requests. However, new payment methods, features and tools will only be supported by using the JSON API.

There are no plans to phase out the XML integration at this point, but this might change in the foreseeable future.

Generate your API key

An API key is required to successfully establish a connection between your website and the MultiSafepay services.

An API key can only be requested when a website URL is inputted into the backend of the MultiSafepay interface. Thus, an API key will only be generated as long as the field contains the URL of your website. Only then will it be possible to process data and payments.

It is not …

Google Analytics tracking through API

It is possible to track the behavior of your customers through Google Universal Analytics tracking
However, this is restricted only to redirect orders. If a customer reaches the MultiSafepay payment page, the UA-code will be loaded and you will be able to see that in the corresponding HTML.

For direct orders (e.g. iDEAL direct, some cases of Klarna, AfterPay, etc.), there is no tracking …

How does the notification URL work?


Our notifications are webhooks where our API will notify your web server when the status of a transaction changes.

The notification webhooks are triggered by events made by both your customers (e.g. completing a payment) and you (e.g. creating a refund).

We will add 2 parameters to the notification request:

  • transactionid
  • timestamp.

For a POST notification we will also add the …

What does Locale do?

A locale is a set of parameters that defines the user’s language, region and any special variant preferences that the user wants to see in their user interface. Usually a locale identifier consists of at least a language code and a country/region code (e.g. en_US). A locale can be included to provide localized payment pages for the customer. Use the format ab_CD with ISO 639 language codes …

What is the difference between a Direct and Redirect API call?

On our API section, you will often see the terms ‘Direct’ and ‘Redirect’ being used. In this section, we will explain the difference between the two API calls.


A Direct transaction will simply connect you directly to the chosen payment method and will either provide a direct link to the payment method or perform the transaction immediately without the customer …

What is the difference between the Status and Financial Status?

On API level, this is illustrated as:

    "status": "",
    "financial_status": "",

The status is related status of the webshop order. In your MultiSafepay Control, this is referred to as the Order Status.

The financial status is related to the payout of the transaction. In your MultiSafepay Control, this is referred to as the Status.

What is the maximum length of an order_id?

The maximum length of an order_id must be no more than 50 characters. If the order_id is greater than 50 characters, a 1006 error will be displayed.

What type of personal transaction details are required to be sent via the MultiSafepay API?

As online payment provider, MultiSafepay is obliged by law to monitor transactions and it’s clients. As a result, it must be clear to MultiSafepay what type of service or products are purchased per transaction and by whom.

Please help us in our duty by sending:

  • the exact product details
  • client name
  • customer IP-address
  • country
  • email address

for all orders automatically. Failure of sending the …

Why request the IP address of the customer?


Post-payment and credit card payment methods require the customer ip_address to be validated and thus, we need the actual IP address of the end user within the ip_address field. This means that the optional parameter “ip_address (optional) within the JSON request is now a “required” field when processing post-payment and/or credit card transactions.

Please note! …


You're missing something out and would like us to fix it? Suggest an improvement to this page!


Other languages

Liever uitleg in het Nederlands? Neem contact op met uw accountmanager.

Vuoi ricevere informazioni in italiano? Contatta il tuo account manager.

Falls Sie eine deutschsprachige Erklärung bevorzugen, kontaktieren Sie bitte Ihren Kundenbetreuer.

Prefieres tener la explicación en Español? Contacta con tu gerente de cuentas.

Vous préférez une explication en français? Contactez votre gestionnaire de compte.