Test Integration

In order to help you integrate your website with MultiSafepay, or test new features, we provide a separate test environment. In the test environment no real transactions can take place, allowing you to test different payment methods and the transaction status handling of your website.

Please start with creating a test account for MultiSafepay Control. When you've created your first website, you can use the test API Key found in website settings to authenticate. Alternatively you can use the test Account ID, Secure Code and Site ID to configure your plugin. You can find these credentials too in the website settings.

Test API

https://testapi.multisafepay.com/v1/json/

Test Steps

Every transaction processed by MultiSafepay goes through a number of standard steps. During testing it is helpful to ensure that each step is being completed successfully.

  1. Initiate an order
  2. Customer completes the payment
  3. MultiSafepay sends a status change notification
  4. Client system updates transaction status

See our Diagnosing Errors guide for help addressing any issues during testing.

1. Initiate an order

Before initiating an order MultiSafepay validates the information contained in the request to ensure it is valid. The majority of fields are optional but these can have an impact on later stages of the payment process. In particular you should try to include as much data about the customer as possible as this data is used by our risk and fraud detection systems. The more data available to the system the more accurate the results. 

When initiating an order should receive a link which you should redirect your customer too. If you do not receive a payment link then something went wrong and you will receive an error code.

2. Customer completes the payment

This part of the process requires no input from the client. However you should be aware that the result of this step is made available in the transaction status and that payments may not be successful for many reasons.

3. MultiSafepay sends a status change notification 

The status of an order can change for many reasons. Payments be received or reversed and charge-backs are a few examples. Each time this happens MultiSafepay will send a notification to your system with the transaction id. The URL that MultiSafepay send this notification to can be configured in two places. The first place checked is the request when initiating an order. If there is no Notification URL provided when initiating an order then the default Notification URL set in MultiSafepay Control will be used.

You can check within MultiSafepay Control to see if we were able to successfully connect to and send a notification to your system in the Offline Actions section. This information is also available on the details screen for each transaction.

4. Client system updates transaction status

Once your system receives a notification it must retrieve the transaction status from MultiSafepay. The transaction status will clearly show whether a payment was successful or not and give a reason why a transaction was not successful. 

After your system has updated the transaction or order status you can verify that the information displayed is correct by comparing it to the information displayed within MultiSafepay Control.

Test Payment Details

To thoroughly test your payment integration with MultiSafepay you can use the following payment details in the TEST environment to simulate different payment scenarios.

 

iDEAL

MultiSafepay provides a test platform for iDEAL transactions. During the payment process you will be able to simulate the outcome of the transaction.

BankStatusDescription
AnyCompletedTransaction is Completed
AnyDeclinedTransaction is Declined
AnyCancelledTransaction is Cancelled
AnyInitialized/CompletedTransaction is Initialized (after 1 minute it is changed to Completed)
AnyInitialized/DeclinedTransaction is Initialized (after 1 minute it is changed to Declined)

 

VISA

MultiSafepay provides a test platform for VISA transactions. By entering a test card number you will be able to simulate the outcome of the transaction.

Card numberStatusDescription
4111 1111 1111 1111CompletedTransaction is Completed (3D enrolled)
4012 0010 3844 3335CompletedTransaction is Completed (not 3D enrolled)
4917 3000 0000 0008UnclearedTransaction is Uncleared (after 3 minutes it is changed to Void)
4462 0000 0000 0003UnclearedTransaction is Uncleared (after 3 minutes it is changed to Completed)
4012 0010 3746 1114DeclinedTransaction is Declined (failed 3D authentication)
4012 0010 3848 8884DeclinedTransaction is Declined (3D authentication successful, but insufficient funds)

 

MasterCard

MultiSafepay provides a test platform for MasterCard transactions. The simulation is similar to the VISA test platform. For extensive testing please use the VISA test platform. By entering a test card number you will be able to simulate the outcome of the transaction.

Card numberStatusDescription
5500 0000 0000 0004CompletedTransaction is Completed (not 3D enrolled)

 

Maestro

MultiSafepay provides a test platform for Maestro transactions. The simulation is similar to the VISA test platform. For extensive testing please use the VISA test platform. By entering a test card number you will be able to simulate the outcome of the transaction.

Card numberStatusDescription
6759 0000 0000 5CompletedTransaction is Completed (3D enrolled)

 

American Express

MultiSafepay provides a test platform for American Express transactions. By entering a test card number you will be able to simulate the outcome of the transaction.

Card numberStatusDescription
3782 8224 6310 005CompletedTransaction is Completed (not 3D enrolled)
3742 0000 0000 004DeclinedTransaction is Declined
3787 3449 3671 000UnclearedTransaction is Uncleared (after 3 minutes it is changed to Void)

 

Bancontact

MultiSafepay provides a test platform for Bancontact transactions. By entering a test card number you will be able to simulate the outcome of the transaction.

Card numberStatusDescription
6703 4500 0546 1000 5CompletedTransaction is Completed (3D enrolled)
6703 4500 0546 1000 9DeclinedTransaction is Declined (card needs to be 3D enrolled)
6703 9902 9900 0004 5DeclinedTransaction is Declined (failed 3D authentication)
6703 9902 9900 0001 1DeclinedTransaction is Declined (3D authentication successful, but insufficient funds)

 

Giropay / EPS

MultiSafepay provides a test platform for Giropay/EPS transactions. During the payment process you will be able to simulate the outcome of the transaction.

BICStatusDescription
Any BICCompletedTransaction is Completed
Any BICDeclinedTransaction is Declined

Note: Giropay is a German payment method and can only be tested if the country code for Germany (DE) is sent in the pre-transaction request. For EPS you can also use the Giropay gateway in TEsT. In the LIVE environment EPS will display only when you use Austria (AT) as country code.

 

SOFORT Banking

MultiSafepay provides a test platform for Sofort Banking transactions. During the payment process you will be able to simulate the outcome of the transaction.

StatusDescription
CompletedTransaction is Completed.
Cancelled

Transaction is Cancelled.

 

BankTransfer

MultiSafepay provides a test platform for BankTransfer transactions. By entering a test IBAN you will be able to simulate the outcome of the transaction.

IBANStatusDescription
NL87ABNA0000000001Initialized/CompletedTransaction is Initialized (after 1 minute it is Completed)
NL87ABNA0000000002Initialized/Expired/CompletedTransaction is Initialized ( after 1 minute it is Expired, and 1 minute later it is Completed)
NL87ABNA0000000003Initialized/ExpiredTransaction is Initialized ( after 1 minute it is Expired)
NL87ABNA0000000004Initialized/DeclinedTransaction is Initialized ( after 1 minute it is Declined)

 

SEPA Direct Debit

MultiSafepay provides a test platform for SEPA Direct Debit transactions. By entering a test IBAN you will be able to simulate the outcome of the transaction. 

IBANStatusDescription
NL87ABNA0000000001Initialized/CompletedTransaction is Initialized (after 2 minutes it is Completed)
NL87ABNA0000000002Initialized/DeclinedTransaction is Initialized (after 2 minutes it is Declined)
NL87ABNA0000000003Initialized/Uncleared/CompletedTransaction is Initialized ( after 2 minutes it is Uncleared, and 1 minute later it is Completed)
NL87ABNA0000000004Initialized/Uncleared/DeclinedTransaction is Initialized ( after 2 minutes it is Uncleared, and 1 minute later it is Declined)

 

PayPal

MultiSafepay provides a test platform for PayPal transactions. During the payment process you will be able to simulate the outcome of the transaction. 

StatusDescription
CompletedTransaction is Completed
Declined

Transaction is Declined

Initialized / CompletedPayment blocked by PayPal (then accepted)
Initialized / DeclinedPayment blocked by PayPal (then declined)
CancelledTransaction is Cancelled

 

DotPay

MultiSafepay provides a test platform for DotPay transactions. During the payment process you will be able to simulate the outcome of the transaction. 

StatusDescription
CompletedTransaction is Completed
Declined

Transaction is Declined

 

Betaal na Ontvangst / Pay After Delivery

MultiSafepay provides a test platform for Betaal na Ontvangst / Pay After Delivery transactions. During the payment process you will be able to simulate the outcome of the transaction.  

AddressStatusDescription

Kraanspoor 39C

1033SC Amsterdam

CompletedTransaction is Completed
Vlierweg 12D
1032LG Amsterdam 
Declined

Transaction is Declined