Skip to main content

Masterpayment

Integration only for Callisto online stores

This page only contains instructions for integrating Masterpayment in Callisto online stores. For further information on using Masterpayment in Ceres online stores, refer to the detailed information in the plugin description available in the plentyMarketplace.

Masterpayment is a leading payment provider and offers different payment solutions such as purchase on invoice, payment in installments or down-payment and purchase on consumer credit. As such, your customers are able to make their payments easily with common payment methods such as credit card, debit, invoice or with financing. End customers can pay easily and without having to register.

1. Important notes

This chapter provides you with important information about integrating the payment provider in plentymarkets.

1.1. Payment process

The customer is forwarded to Masterpayment for the payment process and an iframe prompts the customer to enter their data. The payment method is selected in the online store. Afterwards, the customer is forwarded directly to Masterpayment. The additional content is made available in an iframe. The customer enters their data here. In other words, the data is not entered in the online store, but rather in Masterpayment. Once the customer has entered and confirmed the data, they will be forwarded to the order confirmation page.

1.2. SSL certificate

You need to have an SSL certificate in order to correctly use the payment method.

Ask your bank

Ask your bank whether it can process payments with iframe before you integrate this payment method.

1.3. Availalble Masterpayment payment methods

Below you will find an overview of the Masterpayment payment methods that are available for plentymarkets. They are displayed along with the corresponding System ID in parentheses.

  • Debit card (1623)

  • Purchase on consumer credit (1622)

  • Credit card (1600)

  • Recurrent credit card (1624)

  • Online debit (1610)

  • Recurrent online debit (1625)

  • Installment purchase (1621)

  • Payment on invoice (1620)

  • Down payment (1626)

  • Sofortbanking (1627)

2. Registering with Masterpayment

You have to register before being able to use Masterpayment. You will receive the access data that you need for setting up Masterpayment in plentymarkets.

3. Setting up Masterpayment in plentymarkets

Proceed as described below to set up the interface to Masterpayment.

Setting up the interface to Masterpayment:

  1. Go to System » Orders » Payment » Methods.

  2. Place a check mark next to the setting Also show inactive.

  3. Open the folder International.

  4. Click on Masterpayment.
    → The Interface tab will open.

  5. Expand the client.

  6. Carry out the settings as desired. Pay attention to the information given in Table 1.

  7. Save the settings.

Table 1. setting up the interface to Masterpayment
Setting Explanation

Login (email), Secret key

Enter the access data that you received from Masterpayment.

Send customer data

Select whether or not the customer data should be sent.

IFrame width

Enter the width in pixels (standard: 450).

IFrame height

Enter the height in pixels (standard: 450).

Client (store) options

Activate access data for all clients (stores)

Only visible if clients (stores) were set up. Activate to apply the account settings saved for the main store by clicking on Add account for all clients (shops). This setting is dominant over the settings saved for each client. Deactivate to use separate access data for your clients (stores). Online stores that do not have account settings saved for them cannot be used with Masterpayment.
Go to System » Client » Select client » Online store » Settings and make sure that you have selected the option Enable login for every store in the line Login. This makes it possible to support several clients.

4. Activating the payment method

Set up and activate the Masterpayment payment method in the Settings tab of the payment method. In addition, check the settings for Permitted payment methods in the customer classes and for Blocked payment methods in the shipping profiles.

5. Automatically sending shipping confirmations

Set up event procedures in order to inform Masterpayment when items are shipped, orders and returns are cancelled and when invoices are created or deleted. Before activating your system, contact your Masterpayment contact person to test the event procedures. Set up an event procedure to automatically send shipping confirmations to Masterpayment.

Setting up an event procedure
  1. Go to System » Orders » Events.

  2. Click on Add event procedure.
    → The Create new event procedure window will open.

  3. Enter a name.

  4. Select the event listed in table 2.

  5. Save the settings.

  6. Pay attention to the explanations given in table 2 and carry out the settings as desired.

  7. Place a check mark next to the option Active.

  8. Save the settings.

Table 2. event procedure for sending automatic shipping confirmations to Masterpayment
Setting Option Selection

Event

Order change: Outgoing items booked

Filter 1

Order > Order type

Order

Filter 2

Order > Payment method

Masterpayment

Procedure

Shipping > Send shipping confirmation to Masterpayment

Alternatively, select the setting Status change as the event and then select the desired status, if you want a status change to trigger when outgoing items are booked.

Tip

This shipping confirmation informs Masterpayment that the order was shipped. It activates the invoice, which is saved in the order as a PDF file. If you need the invoice earlier, then select an earlier event.

6. Automatically sending cancellations

Set up an event procedure to automatically send cancellations to Masterpayment.

Setting up an event procedure
  1. Go to System » Orders » Events.

  2. Click on Add event procedure.
    → The Create new event procedure window will open.

  3. Enter a name.

  4. Select the event listed in table 3.

  5. Save the settings.

  6. Pay attention to the explanations given in table 3 and carry out the settings as desired.

  7. Place a check mark next to the option Active.

  8. Save the settings.

Table 3. event procedure for sending automatic cancellations to Masterpayment
Setting Option Selection

Event

Order change: Status change

Select status for cancelled orders.

Filter

Order > Order type

Order

Filter

Order > Payment method

Masterpayment

Procedure

Payment methods > Send refund to Masterpayment

To top