Test your integration


Before you start processing real transactions with MultiSafepay, we recommend testing each payment method in your MultiSafepay test account.

If you encounter any issues during testing, see Diagnosing errors.

For support, email the Integration Team at [email protected]

1. Initiate a transaction

There are two ways to initiate a transaction:

Ecommerce integration

  1. Enter the API key from your test account in the backend of your ecommerce integration.
  2. Place a test order, and then initiate a transaction using the payment method you want to test.

API

The test API endpoint is: https://testapi.multisafepay.com/v1/json/

  1. In your API testing environment, enter your test API key.
  2. For the payment method you want to test, on the API Reference - Payment methods page, make a POST /orders request. Make sure you include all required parameters in the request.

2. Complete the payment

A unique payment link is returned for you to complete the payment.

  1. Enter relevant test payment details for the payment method you are testing, or select a payment scenario.
  2. Complete the test payment.

3. Check the transaction details

To check the transaction details in your MultiSafepay test account:

  1. Go to Transactions > Transactions overview.
  2. In the Transactions overview list, select the transaction to view the Transaction details page.

For information about transaction statuses, see Test payment details.

4. Set the notification URL

MultiSafepay uses the notification URL as a webhook to send transaction status updates to your integration.

For custom-built integrations, first create a webhook listener that listens at the notification URL. For more information, see Notification URL.

For all integrations, to set the notification URL in your MultiSafepay test account, follow these steps:

  1. Go to Settings > Website settings.
  2. Select the relevant website.
  3. In the Notification URL field, enter your notification URL.
  4. Click Save.

Note: If you provide a notification_url in your POST /orders request, it overides the notification URL in your MultiSafepay test account.

5. Check your connection with MultiSafepay

To check that you have succesfully connected to our system, follow these steps:

  1. Sign in to your MultiSafepay test account.
  2. Go to Transactions > Transactions overview.
  3. Select the transaction to view the Transaction details page.
  4. Under Offline actions, in the Status field, check that you correctly received the MultiSafepay request. For information about errors, see HTTP errors.

Note: Once your live account is approved, ensure you use the API key from your live account instead of your test account.

Read more

Next steps

Feedback

Propose a change on GitHubexternal-link-icon or
send an email to [email protected]

Other languages

For an explanation in another language, contact your account manager.