You can't test the following methods in your MultiSafepay test account. You can only make test payments in your MultiSafepay live account.

• Betaal per Maand
• iDEAL QR
• Paysafecard
• Request to Pay
• TrustPay

PSP ID

⚠️

Note

We are currently updating the format of our PSP ID to consist of 16 digits.

Testing this new format is possible on both our TEST and LIVE environment:

• Create a transaction with customer_email '[email protected]''.
  You will receive a response in the new 16-digit format.
• Review if your integration supports the longer ID:
  Check for example your offline actions, and any related operational processes.
• Review if your reconciliation and accounting process supports this longer ID.

Test a Bancontact order

⚠️ Note: Bancontact doesn't support direct requests.

1. Create an order > Banking order (Example: Bancontact redirect).
2. Open the payment link.
3. In the Card number field, enter a card number (see table below).
4. In the Expiry date fields, enter any future date.
5. Click Confirm.

You can see the reason the transaction was declined in your MultiSafepay test account under Notes.

Test a Bancontact QR code

1. Create an order > Banking order (Example: Bancontact QR)
2. Open the payment link.
3. Scan the QR code with a general QR reader (not the Bancontact app or an error occurs).
4. On the Test platform page, from the Test scenario list, select Completed.
5. Click Test.

1. Create an order > Banking order (Example: Bank transfer redirect)
2. Open the payment link.
3. In the Your bank account field, enter an IBAN (see table below).
4. From the Bank's country list, select a country, and then click Confirm.

⚠️ Note: You cannot test making direct API requests with an IBAN to test different transaction statuses.

1. Create an order > Banking order.
   See also the Examples for the specific payment method.
2. Open the payment link.
3. On the Test platform page, from the Test scenario list, select Completed.
4. Click Test.
   The payment is processed in the test environment as Successful, with order status Completed, and transaction status Completed.

1. Create an order > Banking order (Example: Dotpay redirect)
2. On the Dotpay page, enter in the:
   • Email address field: Any email address
   • Phone number field: Any phone number
3. Select a bank. (You may see more banks available in the live environment.)
   You are automatically redirected.
4. On the Test platform page, from the Test scenario list, select Completed.
5. Click Test.
   The payment is processed in the test environment as Successful, with order status Completed, and transaction status Completed.

1. Create an order > Banking order (Example: EPS redirect)
   In the customer object, set the locale parameter to at_AT.
2. On the EPS page, in the BIC field, enter any BIC code, e.g. RZOOAT2L420.
3. Click Confirm.
4. On the Test platform page, from the Test scenario list, select Completed.
5. Click Test.
   The payment is processed in the test environment as Successful, with order status Completed, and transaction status Completed.

1. Create an order > Banking order (Example: Giropay redirect)
2. On the Giropay page, in the BIC field, enter any BIC code, e.g. NOLADE22XXX.
3. Click Confirm.
4. On the Test platform page, from the Test scenario list, select Completed.
5. Click Test.
   The payment is processed in the test environment as Successful, with order status Completed, and transaction status Completed.

1. Create an order > Banking order (Example: iDEAL direct/redirect)
2. For redirect, select a bank.
3. On the Test platform page, from the Test scenario list, select Completed.
4. Click Test.
   The payment is processed in the test environment as Successful, with order status Completed, and transaction status Completed.

You can also test the following scenarios:

1. Create an order > Banking order (Example: Direct debit direct/redirect)
2. For redirect orders, open the payment link.
3. Enter in the:
   • Account holder field the account holder name.
   • IBAN field an IBAN (see table below).
4. Click Confirm.

1. Create an order > Banking order (Example: MyBank direct/redirect)
   In the customer object, set the locale parameter to it_IT.
2. For redirect orders, open the payment link.
3. Select the bank/payment scenario below.
4. Click Continua sull'online banking.

1. Create an order > Card order.
   See also the Examples for the specific card scheme.
   For co-branded cards, see the Card payment redirect example. In the customer object, set the locale parameter:
   • Cartes Bancaires: fr_FR
   • Dankort: da_DK
   • Postepay: it_IT
2. On the payment page:
   • In the Card number field, enter a card number (see table below).
   • In the Card holder field, enter any name.
   • From the Expiry date lists, select any future date.
   • In the CVC/CVV field, enter 123.
   • Click Confirm.
3. On the 3D payment page:
   • From the drop-down list, select Authenticated (Y).
   • Click Confirm.
     The payment is processed in the test environment as Successful, with order status Completed, and transaction status Completed.

  💡 Tip! You can see the reason a transaction was declined in your MultiSafepay test account under Notes.

Test an order

1. Create an order > BNPL order
   Example: E-Invoicing/Pay After Delivery direct/redirect
2. For redirect orders, open the payment link.
3. Enter in the:
   • Birthdate field any date of birth. Format: DD-MM-YYYY.
   • Bank account field any 10-digit bank account number.
   • Email address field any email address.
   • Phone number field any phone number.
4. Click Confirm.
   The payment is processed in the test environment as Successful, with order and transaction statuses Uncleared.

Test declining an order

To decline an order, in your test account under Order summary, click Decline.
The order status and transaction status change to Void.

Test shipping an E-Invoicing order

To test shipping an order, make an update order API request with status "shipped". You receive the invoice_url in the API response.

Test an in3 order

1. Create an order > BNPL order
   Example: in3 direct/redirect
   Use the following customer details:

   • Date of birth: 01-01-1999
   • Postal code: 1234AB
   • House number: 1

   For redirect orders:

   • Enter in the:
     • Birthdate field: 01-01-1999
     • Phone number field: Any phone number
   • Select your title, and then click Confirm.

2. Select the checkbox to accept in3's payment terms and privacy statement, and then click Afronden.

3. On the Test platform page, from the Test scenario list, select Completed.

4. Click Test.

5. On the in3 page, click Terug naar webshop.
   The payment is processed in the test environment as Successful, with order status Completed, and transaction status Uncleared.

Test in3 declining an order

Use the following customer details:

• Date of birth: 01-01-2000
• Postal code: 1111AB
• House number: 1

The order status and transaction status change to Declined.

Test shipping an in3 order

To test shipping an order, either:

• Make an update order API request with status shipped, or
• In your MultiSafepay test dashboard, go to Order summary, and then click Order status.

Receive an in3 invoice

You can only test invoicing in your MultiSafepay live account. To do this, change the order status to Shipped.

Test refunding an in3 order

To test refunding an order:

1. Create an order.
2. Change the order status to shipped.
3. Click Refund complete order, and then click Save item changes.
   A new order is created for the refund. The order status for the refund changes to Completed.

Test an in3 API refund

To test refunding an order via the API:

1. Create an order.
2. Change the order status to shipped.
3. Make a BNPL refund API request: Refund order > BNPL refund.
   A new order is created for the refund. The order status for the refund changes to Completed.

Test credentials

• Site API key
• Klarna's test credentials

Test a Klarna order

1. Create an order > BNPL order
   Example: Klarna direct/redirect
2. On the Klarna page, click Kopen.
3. In the Telefoonnummer field, enter any mobile number, and then click Ga verder.
4. In the Verificatiecode field, enter any 6-digit number, and then click Bevestigen.
   The payment is processed in the test environment as Successful, with order status Completed, and transaction status Uncleared.

Test declining an order

To decline an order, in your test account under Order summary, click Decline.
The transaction and order statuses change to Void.

Change the order status

You can change the order status to Shipped or Cancelled.
To change the order status, either:

• Make an update order API request, or
• In your MultiSafepay test dashboard, go to Order summary, and then click Order status.

Test refunding an order

To refund an order:

1. Change the order status to Shipped.
2. Under Order summary, click Refund order, or make a BNPL refund API request: Refund order > BNPL refund.
   The transaction status changes to Completed.

Receive an invoice

You can only test invoicing in your MultiSafepay live account. To do this, change the order status to Shipped.

⚠️ Note: You can't test:

• Receiving successful payment notifications from Klarna
• Changing the transaction status from Uncleared to Completed, except for refunds

ℹ More information
To learn more about integrating Klarna with MultiSafepay, see Klarna.

Request an API key

1. Request a test API key from Riverty via either:

   • Your implementation ticket with Riverty, or
   • Email [email protected]

   Riverty shares the test key with MultiSafepay.

2. To enable Riverty in your MultiSafepay test account, email [email protected]

Test an Riverty order

1. Create an order > BNPL order
   Example: Riverty direct/redirect
2. For redirect orders, select the checkbox at the bottom of the Riverty page, and then click Confirm.
   The payment is processed in the test environment as Successful, with order status Completed, and transaction status Uncleared.

Test declining an order

To decline an order, in your test account under Order summary, click Decline.
The transaction and order statuses change to Void.

Test Riverty rejecting an order

To test Riverty rejecting an order, in your direct or redirect API request, use the following email address: [email protected]
The transaction and order statuses change to Declined.

Change the order status

You can change the order status to Shipped or Cancelled.
To change the order status, either:

• Make an update order request, or
• In your MultiSafepay test dashboard, go to Order summary, and then click Order status.

⚠️ Note: You can't test:

• Receiving successful payment notifications from Riverty
• Changing the transaction status from Uncleared to Completed
• Processing refunds

1. Create an order > Prepaid card order
   Example: Edenred redirect
2. On the payment page, click Add discount.
3. From the Test scenario list, select the relevant discount, and then click Test.
   The payment is processed in the test environment as Successful, with order status Completed, and transaction status Completed.

Supported gift cards

You can test the following gift cards:

• Beauty Cadeau
• Boeken Voordeel
• Huis & Tuin Cadeau
• Klus Cadeau
• Nationale Bioscoopbon
• VVV Cadeaukaart
• Wijn Cadeaukaart

You can't test other gift cards in your MultiSafepay test account. You can only make test payments in your MultiSafepay live account. You make a small payment and the amount is actually deducted from the gift card.

Test a gift card order

1. Create an order > Prepaid card order
   Example: Gift card redirect
2. Open the payment link.
3. Enter the following details:
   • In the Card number field, 111115
   • In the Security code field, any 4-digit number
4. Click Add discount.
   The payment is processed in the test environment as Successful, with order status Completed, and transaction status Completed.

Use the following card numbers to test different gift card balances:

Any other card number receives an "Invalid card number" error.

1. Create an order > Prepaid card order
   Example: Monizze redirect
2. Open the payment link.
3. Enter the following details:
   • In the Card number field, 111115
   • In the Security code field, any 4-digit number
4. Click Add discount.
   The payment is processed in the test environment as Successful, with order status Completed, and transaction status Completed.

Use the following card numbers to test different gift card balances:

1. Create an order > Prepaid card order
   Example: Sodexo redirect
2. Open the payment link.
3. Enter the following details:
   • In the Card number field, 111115
   • In the Security code field, any 4-digit number
4. Click Add discount.
   The payment is processed in the test environment as Successful, with order status Completed, and transaction status Completed.

Use the following card numbers to test different gift card balances:

Any other card number receives an "Invalid card number" error.

1. Create an order > Wallet order
   Example: Alipay direct/redirect
2. On the Test platform page, from the Test scenario list, select Completed.
3. Click Test.
   The payment is processed in your MultiSafepay test account as Successful, with order status Completed, and transaction status Initialized.

⚠️ Note: You can't test Alipay declining transactions.

1. Create an order > Wallet order.
   Example: Amazon Pay direct/redirect
2. On the Test platform page, wait for 5 seconds or click Amazon Pay.
3. From the Test scenario list, select Completed.
4. Click Test.
   The payment is processed in your MultiSafepay test account as Successful, with order status Completed, and transaction status Initialized.

Compatible devices

For compatible devices, see Apple – Devices compatible with Apple Pay .

If you don't own an Apple device, we recommend using the Appetize.io emulator. When you try to complete a test payment on the payment page, you get a This device is not supported error. But the emulator creates an order with the Apple Pay gateway pre-selected to check if there is an existing connection to our server. However, you can't fully complete the test transaction.

Prerequisites

• Use a compatible device
• Use Safari browser
• Activate Maestro for your MultiSafepay account

If these requirements are not met, Apple Pay doesn't appear on the checkout page.

Testing Apple Pay redirect

To test your Apple Pay redirect integration, there are two ways:

• If you have an Apple account with at least one card in your wallet, you can use your own account and card details in our test environment without incurring any costs.
• Alternatively, you can use an Apple Developer account configured for Apple Pay, with at least one Apple Pay test card in your wallet.

To test, follow these steps:

1. Create an order > Wallet order
   Example: Apple Pay redirect
2. On the payment page, click the Apple Pay button.
   You can ignore the "This device is not supported" error.
3. Sign in to your Apple Developer account and select your test card.
4. Authorize the payment.
   The transaction is completed.

Testing Apple Pay direct

See Apple Pay direct integration – Test your integration.

To test Google Pay payments, follow these steps:

1. In your checkout, click the Google Pay button.

2. Complete payment using your Google account.

   Your real card details are never processed in our testing environment, but you must add at least one chargeable card to your Google account.

   Depending on your card's authentication method, you may or may not be redirected to authenticate:

   • PAN only: Authentication method for cards stored on file in your Google Account. Returned payment data includes your personal account number (PAN), expiration month, and expiration year. You are redirected to a test 3D Secure page to authenticate the payment.
   • Cryptogram 3DS: Authentication method for cards stored as Android device tokens. Returned payment data includes a 3D Secure cryptogram generated on the device. You are not redirected to authenticate the payment.
     For more information about testing, see Google Pay – Test with sample tokens .

3. Check the status of the payment in your test dashboard .

Test a PayPal order

PayPal must be activated via your MultiSafepay dashboard .

To test, follow these steps:

1. Create an order > Wallet order
   Example: PayPal direct
2. On the Test platform page, from the Test scenario list, select Completed.
3. Click Test.
   The payment is processed in your MultiSafepay test account as Successful, with order status Completed, and transaction status Initialized.

⚠️ Note: Since MultiSafepay does not collect payments on behalf of PayPal, the transaction status remains Initialized and can't be changed to Completed.

Change the order status

You can change the order status to:

To change the order status, on the Test platform page, from the Test scenario list, select the relevant test scenario.

1. Create order > Wallet order
   Example: WeChat direct/redirect
2. Scan the QR code with a general QR reader (not the WeChat app or an error occurs).
3. On the Test platform page, from the Test scenario list, select Completed.
4. Click Test.
   The payment is processed in your MultiSafepay test account as Successful, with order status Completed, and transaction status Completed.

1. Create an order in your backend or via the API as above.
2. On the Test platform page, from the Test scenario list, select Cancelled.
3. Click Test.
   The order status changes to Void.

You can process full refunds in your MultiSafepay test dashboard .

Partial refunds are not enabled by default. To enable this, email [email protected]

If you refund a payment in your MultiSafepay test dashboard, the transaction status remains Reserved or Initialized until the refund is manually approved, since there is no involvement with a bank.

Supported payment methods

You can test cancelling orders for the following methods:

• Banking methods: Belfius, CBC/KBC, Dotpay, EPS, Giropay, iDEAL (not QR), Sofort, Trustly
• Wallets: Alipay, PayPal

Refund orders in the live environment are processed automatically for the following methods:

• Banking methods: Bancontact (not QR), bank transfers, Belfius, CBC/KBC, direct debits, Dotpay, EPS, Giropay, iDEAL (not QR), Sofort, Trustly
• Credit and debit cards
• Wallets: Alipay, PayPal, WeChat Pay

1. Create an order.
2. Wait until the transaction status changes to Completed.
3. In your MultiSafepay test dashboard, go to Order summary, and then click Refund order.
4. Under Refund, enter in the:
   • Account holder name field the account holder name of the account you want to refund to.
   • Amount field the amount to refund.
   • IBAN field the IBAN of the account you want to refund to.
   • Reason/Description field the reason for the refund.
5. Click Continue.
6. Under Refund confirmation, check that the description and amount are correct, and then click Confirm.
   A new order is created for the refund, with status Reserved or Initialized.
7. Under Related transactions, select the ID of the refund order.
8. Under Order summary, click Accept.
9. In the Add transaction comment field, add a comment, and then click Add.
   The order status changes to Completed.

Supported payment methods

You can test refunds for the following methods:

• Banking methods: Bancontact (not QR), bank transfers, Belfius, CBC/KBC, direct debits, Dotpay, EPS, Giropay, iDEAL (not QR), Sofort, Trustly
• Credit and debit cards
• BNPL: in3, Klarna
• Wallets: Alipay, PayPal, WeChat Pay

1. Create an order.
2. Make a refund API request.
   A new order is created for the refund. The order status for the refund changes to Reserved or Initialized.
3. In your MultiSafepay test dashboard, go to Related transactions, and then select the ID of the refund order.
4. Under Order summary, click Accept.
5. In the Add transaction comment field, add a comment, and then click Add.
   The order status changes to Completed.

Supported payment methods

You can test refunds for the following methods:

• Banking methods: Bancontact (not QR), direct debits, EPS, Giropay, iDEAL (not QR), Sofort, Trustly
• Credit and debit cards
• BNPL: in3
• Wallets: PayPal, WeChat Pay