Contents

Zimpler

PAYMENT ZIMPLER
Zimpler is a mobile wallet / invoicing method that operates in Finland and Sweden. When choosing Zimpler, customers must enter their mobile phone number. They will then receive a code via SMS, which must be entered into the hosted checkout page to initiate the payment. Once the transaction has been submitted, an invoice will be sent by SMS to the customers for payment. Once the transaction has been completed, you will receive confirmation via a URL notification, and you can deliver the goods / services to the customer.

 

Features

Supported customer countries FI, SE
Supported currencies
EUR, SEK
Protect Plus Supported.
Refunds Full refunds supported.
Chargebacks Payments are not subject to chargebacks.

 

Info
  • EUR payments can only be processed with billingcountryiso2a set to “FI”.
  • SEK payments can only be processed with billingcountryiso2a set to “SE”.

 


 

Configuration

1
To enable this payment method on your account, please get in touch with your account manager.
A test sandbox account will be provided, which you will need when testing your implementation.
2
Modify your POST to Payment Pages as needed:

 

Field name Required by PPg Required in POST Description
billingcountryiso2a Yes No The country entered for the billing address, using ISO2A format.
billingemail Yes No The customer’s billing email address. Maximum length of 255 (maximum of 64 characters before the ”@” symbol).
billingfirstname Yes No The billing first name.
billinglastname Yes No The billing last name.
billingtelephone No No The customer’s telephone number. Valid characters:

  • Numbers 0-9
  • Spaces
  • Special characters: + – ( )
billingtelephonetype No No At time of writing, only a mobile phone number can be submitted to Zimpler.

To indicate the billingtelephone submitted is a mobile phone number, the billingtelephonetype must be submitted as “M”.

ruleidentifier No No
If your POST to the Payment Pages already includes all fields required by the payment method, you can streamline the checkout process for the customer by also submitting ruleidentifier=STR-14.

 

This allows the customer’s browser to immediately go to the pages hosted by the payment method to complete the transaction. (We refer to this as Workflow C)

 

 


 

Notifications

Once a payment has been authorised, funds will be settled at a later time, as determined by Zimpler.

Info
The settlement notification may not be sent immediately after processing the payment.

In the unlikely event that payment is still pending settlement after 7 days (settlestatus “10”), this will be scheduled for investigation and we will contact you with further information.

 

Before you begin testing, we recommend that you contact our Support team and request that rules are enabled on your account, which submit URL notifications to your system in the following scenarios:

 

Configuring the authorisation notification

We recommend including at least the following fields in your authorisation notification:

*Please choose your preferred format.

 

Configuring the settlement notification

We recommend including the following fields in your settlement notification:

 

Check the notification

You will need to check the contents of each notification received and respond accordingly by following the processes outlined in the “URL notifications” section of our Action types page. In particular, you will need to look at the updated settlestatus value:

Info
Cancelled transactions (settlestatus “3”) may be settled at a later time. In situations where the customer has completed the steps required to fulfil the payment, the settlestatus is updated to “100” to indicate the funds have been transferred to your account.

 

If you have contacted the Support Team to configure settlement notifications (as described above), you will be notified when this occurs.

 


 

Testing

You will need to test your solution before you can begin processing live payments. Test transactions are processed through your test Site Reference.

Info
Requirements

You will need to contact our Support team, providing your Zimpler test account details. We will then configure your test site reference to connect directly to the Zimpler testing environment.

When performing test transactions, your browser will be redirected to the Zimpler testing environment to simulate a payment. Other than this, the process will be exactly the same as processing live payments.

 


 

Refunds

After processing a payment, it is possible to refund the customer using MyST.

Info
Refunds for Zimpler are settled immediately (settlestatus “100”).

 

Requirements