Skip to content

Commit

Permalink
Merge branch 'master' into DOCS-4461
Browse files Browse the repository at this point in the history
  • Loading branch information
danielcivit authored Dec 12, 2024
2 parents 58d7574 + 6baeb13 commit 92f5dba
Show file tree
Hide file tree
Showing 19 changed files with 97 additions and 37 deletions.
2 changes: 2 additions & 0 deletions api/general/error-reference.md
Original file line number Diff line number Diff line change
Expand Up @@ -182,6 +182,8 @@ Check that the:
- Customer details are correct
- Customer details match the credit details

**💡 Tip!** For card payments, use the <a href="https://docs.multisafepay.com/reference/getorder" target="_blank">Get order</a> <i class="fa fa-external-link" style="font-size:12px;color:#8b929e"></i> request and check the response details to learn more about the decline reason.

---
### 1024: For Cloudflare – Incorrect customer IP address

Expand Down
4 changes: 2 additions & 2 deletions api/multisafepay-api/getsite.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,8 +6,8 @@ slug: getsite

## How to test

1. Under **Authentication** > **Query**, enter a website or a terminal group [API key](/docs/sites#site-id-api-key-and-security-code) from your **TEST** account.
2. Under **Path params**, enter the website or terminal group ID.
1. Under **Authentication** > **Query**, enter an [API key](/docs/sites#site-id-api-key-and-security-code) from your **TEST** account.
2. Under **Path params**, enter the site ID.
3. Click **Try it!**

❗️ Never use a live API key!
Expand Down
6 changes: 3 additions & 3 deletions api/multisafepay-api/listtransactions.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,9 +6,9 @@ slug: listtransactions

## How to test

1. Under **Authentication** > **Query**, enter:
- To list all transactions for your **account**, your account API key from your **TEST** account.
- To list all transactions for your **site**, your relevant site [API key](/docs/sites#site-id-api-key-and-security-code) from your **TEST** account.
1. Under **Authentication** > **Query**:
- Enter your **TEST** account API key to list all transactions for your **account**. To get your TEST account API key, email <[email protected]>.
- Enter the relevant website or terminal group [API key](/docs/sites#site-id-api-key-and-security-code) from your **TEST** account to list all transactions for a specific **website** or **terminal group**.
2. Click **Try it!**

❗️ Never use a live API key!
Expand Down
4 changes: 2 additions & 2 deletions api/multisafepay-api/updatesite.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,10 +6,10 @@ slug: updatesite

## How to test


1. Under **Authentication** > **Query**, enter a website or a terminal group [API key](/docs/sites#site-id-api-key-and-security-code) from your **TEST** account.
2. Under **Path params**, enter the website or terminal group ID.
3. Click **Try it!**

3. Click **Try it!**

❗️ Never use a live API key!

Expand Down
17 changes: 17 additions & 0 deletions content/checkout/single.md
Original file line number Diff line number Diff line change
Expand Up @@ -308,6 +308,23 @@ Use the `createOrder()` function to pass the `orderData` to your server.

Create an <<glossary:order>> from your server, appending the `payment_data` collected from the payment component UI to the order data.

#### Example

```json
{
"type": "direct",
"order_id": "test_order_id",
"currency": "EUR",
"amount": 100,
"description": "Test Order Description",
"payment_data":
{
"payload":"payment_component_method_response",
"gateway": "CREDITCARD",
}
}
```

See API reference – [Create order](/reference/createorder/) > Payment component.

## Redirect the customer
Expand Down
2 changes: 2 additions & 0 deletions content/developer/troubleshooting.md
Original file line number Diff line number Diff line change
Expand Up @@ -182,6 +182,8 @@ Check that the:
- Customer details are correct
- Customer details match the credit details

**💡 Tip!** For card payments, use the <a href="https://docs.multisafepay.com/reference/getorder" target="_blank">Get order</a> <i class="fa fa-external-link" style="font-size:12px;color:#8b929e"></i> request and check the response details to learn more about the decline reason.

---
### 1024: For Cloudflare – Incorrect customer IP address

Expand Down
14 changes: 11 additions & 3 deletions content/getting-started/sites.md
Original file line number Diff line number Diff line change
Expand Up @@ -129,11 +129,19 @@ To generate a portable network graphic (PNG) of a payment method logo to display

## Site ID, API key, and security code

To view the site ID, API key, and security code for a site:
To view the ID, API key, and security code for a website:

1. Sign in to your <a href="https://merchant.multisafepay.com" target="_blank">live</a> <i class="fa fa-external-link" style="font-size:12px;color:#8b929e"></i> or <a href="https://testmerchant.multisafepay.com" target="_blank">test</a> <i class="fa fa-external-link" style="font-size:12px;color:#8b929e"></i> MultiSafepay dashboard.
2. Go to **Sites**, and then click the relevant site.
3. The site ID, API key, and security code appears in the top-right corner of your profile.
2. Go to **Websites**, and then click on the relevant website.
3. You can find the website ID, API key, and security code in the top-right corner of the page.

To view the ID and API key for a terminal group:

1. Sign in to your <a href="https://merchant.multisafepay.com" target="_blank">live</a> <i class="fa fa-external-link" style="font-size:12px;color:#8b929e"></i> or <a href="https://testmerchant.multisafepay.com" target="_blank">test</a> <i class="fa fa-external-link" style="font-size:12px;color:#8b929e"></i> MultiSafepay dashboard.
2. Go to **Devices** > **Terminals**.
3. Click on **Manage groups**.
4. A list of all available terminal groups will be displayed, showing the ID and API key for each group.


## Specify company name

Expand Down
2 changes: 1 addition & 1 deletion content/integrations/cs-cart.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@ slug: 'cs-cart'

<div style="display: flex; flex-wrap: wrap;">

<a class="suggestEdits" style="display: inline-flex; border-radius: 5px; padding: 10px 20px; margin: 10px; font-size: 1rem; background-color: #006ba1; color: #ffffff; text-decoration: none;" href="https://github.com/MultiSafepay/CS-Cart/releases/download/1.7.0/Plugin_CS-Cart_1.7.0.zip" target="_self"><span>Download</span><i class="icon icon-download" style="margin-left: 0.6em;"> </i></a>
<a class="suggestEdits" style="display: inline-flex; border-radius: 5px; padding: 10px 20px; margin: 10px; font-size: 1rem; background-color: #006ba1; color: #ffffff; text-decoration: none;" href="https://github.com/MultiSafepay/CS-Cart/releases/download/1.7.1/Plugin_CS-Cart_1.7.1.zip" target="_self"><span>Download</span><i class="icon icon-download" style="margin-left: 0.6em;"> </i></a>

<a class="suggestEdits" style="display: inline-flex; border-radius: 5px; padding: 10px 20px; margin: 10px; font-size: 1rem; background-color: #DFEBF6; color: #0a59a1; text-decoration: none;" href="https://github.com/MultiSafepay/CS-Cart" target="_blank"><i class="icon-external-link"></i> <span>Source code</span></a>

Expand Down
14 changes: 13 additions & 1 deletion content/integrations/magento-1.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ slug: 'magento-1'
---
<img src="https://raw.githubusercontent.com/MultiSafepay/docs/master/static/logo/Plugins/Magento.svg" width="50" align="right" style="margin: 20px; max-height: 75px"/>

<a class="suggestEdits" style="display: inline-flex; border-radius: 5px; padding: 10px 20px; margin: 10px; font-size: 1rem; background-color: #006ba1; color: #ffffff; text-decoration: none;" href="https://github.com/MultiSafepay/docs/raw/master/static/plugin-downloads/magento1/Plugin_Magento_3.6.0.zip" target="_self"><span>Download</span><i class="icon icon-download" style="margin-left: 0.6em;"> </i></a>
<a class="suggestEdits" style="display: inline-flex; border-radius: 5px; padding: 10px 20px; margin: 10px; font-size: 1rem; background-color: #006ba1; color: #ffffff; text-decoration: none;" href="https://github.com/MultiSafepay/docs/raw/master/static/plugin-downloads/magento1/Plugin_Magento_3.7.0.zip" target="_self"><span>Download</span><i class="icon icon-download" style="margin-left: 0.6em;"> </i></a>

> ⚠️ Action required
>
Expand All @@ -21,6 +21,18 @@ slug: 'magento-1'
<summary>Changelog</summary>
<br>

**3.7.0**
Release date: Nov. 28th, 2024

### Changed
+ DAVAMS-796: Rebrand Afterpay-Riverty Logo
+ DAVAMS-744: Rebranding in3 B2C

### Fixed
+ PLGMAGONE-771: Fix surcharges where percentage not applied when fixed amount is 0

***

**3.6.0**
Release date: Oct. 16th, 2023

Expand Down
2 changes: 1 addition & 1 deletion content/integrations/magento-2.md
Original file line number Diff line number Diff line change
Expand Up @@ -261,7 +261,7 @@ You must:
<summary>How to activate Magento Vault</summary>
<br>
To activate Magento Vault, and enable [recurring payments](/docs/recurring-payments), email a request to <[email protected]>.
To activate Magento Vault, and enable [recurring payments](/docs/recurring-payments), email a request to <[email protected]>.
</details>
Expand Down
2 changes: 1 addition & 1 deletion content/integrations/prestashop.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@ slug: 'prestashop'

<div style="display: flex; flex-wrap: wrap;">

<a class="suggestEdits" style="display: inline-flex; border-radius: 5px; padding: 10px 20px; margin: 10px; font-size: 1rem; background-color: #006ba1; color: #ffffff; text-decoration: none;" href="https://github.com/MultiSafepay/prestashop-official/releases/download/5.14.2/Plugin_PrestaShop_5.14.2.zip" target="_self"><span>Download</span><i class="icon icon-download" style="margin-left: 0.6em;"> </i></a>
<a class="suggestEdits" style="display: inline-flex; border-radius: 5px; padding: 10px 20px; margin: 10px; font-size: 1rem; background-color: #006ba1; color: #ffffff; text-decoration: none;" href="https://github.com/MultiSafepay/prestashop-official/releases/download/5.15.0/Plugin_PrestaShop_5.15.0.zip" target="_self"><span>Download</span><i class="icon icon-download" style="margin-left: 0.6em;"> </i></a>

<a class="suggestEdits" style="display: inline-flex; border-radius: 5px; padding: 10px 20px; margin: 10px; font-size: 1rem; background-color: #DFEBF6; color: #0a59a1; text-decoration: none;" href="https://github.com/MultiSafepay/prestashop-official" target="_blank"><i class="icon-external-link"></i> <span>Source code</span></a>

Expand Down
4 changes: 2 additions & 2 deletions content/integrations/shopware-6.md
Original file line number Diff line number Diff line change
Expand Up @@ -21,8 +21,8 @@ slug: 'shopware-6'
## Prerequisites

- [MultiSafepay account](/docs/getting-started-guide/)
- Shopware 6.4.11.x or higher, 6.5.x.x and 6.6.x.x <!--_(<a href="https://www.shopware.com/en/pricing" target="_blank">Starter Edition</a> <i class="fa fa-external-link" style="font-size:12px;color:#8b929e"></i> supported)_-->
- Tested on Shopware 6.4.20.2, 6.5.8.11, 6.6.3.0 and PHP 8.1–8.2
- Shopware 6.6.x.x
- Tested on Shopware 6.6.3.0 and PHP 8.1–8.2

## Installation and configuration

Expand Down
14 changes: 10 additions & 4 deletions content/payment-management/webhook.md
Original file line number Diff line number Diff line change
Expand Up @@ -51,11 +51,17 @@ You can configure the webhook endpoint at:
<summary>Site level</summary>
<br>

1. Sign in to your <a href="https://merchant.multisafepay.com" target="_blank">MultiSafepay account</a> <i class="fa fa-external-link" style="font-size:12px;color:#8b929e"></i>.
2. Go to **Sites**, and then click the relevant site.
3. On the **Site profile** page, under **Functionality**, in the **Webhook URL** field, set your webhook endpoint.
For websites:

**⚠️ Note:*** These instructions apply to your `notification_url` for order updates. For [FastCheckout shipping options updates](/docs/fastcheckout-shipping-options), see Order level below.
1. Sign in to your <a href="https://merchant.multisafepay.com" target="_blank">MultiSafepay dashboard</a> <i class="fa fa-external-link" style="font-size:12px;color:#8b929e"></i>.
2. Go to **Websites**, and then click the relevant website.
3. Under **Functionality** > **Webhook URL**, set your webhook endpoint.

**⚠️ Note:** These instructions apply to your `notification_url` for order updates. For [FastCheckout shipping options updates](/docs/fastcheckout-shipping-options), see Order level below.

For terminal groups:

You can add a **Webhook URL** for a **terminal group** from your <a href="https://merchant.multisafepay.com" target="_blank">MultiSafepay dashboard</a> <i class="fa fa-external-link" style="font-size:12px;color:#8b929e"></i>. For more information, see **Activation** - <a href="https://docs.multisafepay.com/docs/smartpos-activation#activation" target="_blank">SmartPOS activation</a> <i class="fa fa-external-link" style="font-size:12px;color:#8b929e"></i> or <a href="https://docs.multisafepay.com/docs/traditional-ctap-terminal#activation" target="_blank">Traditional (CTAP) terminal</a> <i class="fa fa-external-link" style="font-size:12px;color:#8b929e"></i>, depending on your terminal.

</details>

Expand Down
25 changes: 10 additions & 15 deletions content/payment-methods/mbway.md
Original file line number Diff line number Diff line change
Expand Up @@ -108,31 +108,26 @@ You can still update the customer's phone number on the [payment pages](/docs/pa

## Refunds

You can process refunds in your dashboard **or** via API.
You can process refunds in your dashboard.

The customer must provide you with their IBAN to process refunds via bank transfer.

<details id="how-to-refund-an-order">
<summary>How to refund an order</summary>
<br>

**In your dashboard**

1. Sign in to your <a href="https://merchant.multisafepay.com" target="_blank">MultiSafepay dashboard</a> <i class="fa fa-external-link" style="font-size:12px;color:#8b929e"></i>.
2. Go to **Transactions** > **Transaction overview**, and then click the relevant transaction.
3. On the **Transaction details** page, click **Refund order**.
4. In the **Reason / Description** field, enter the reason for the refund or a description of what happened with the order, and then click **Complete**.
5. In the **Comment** field, enter any additional information.
6. In the **Amount** fields, enter the amount to refund.
7. Click **Continue**.
8. Review the **Refund confirmation**, and then click **Confirm**.

**Via the API**

See API reference – [Refund order](/reference/refundorder).

***
4. In the **Account Holder Name** field, enter the customer's full name.
5. In the **IBAN** field, enter the customer's IBAN.
6. In the **Reason / Description** field, enter the reason for the refund or a description of what happened with the order, and then click **Complete**.
7. In the **Comment** field, enter any additional information.
8. In the **Amount** fields, enter the amount to refund.
9. Click **Continue**.
10. Review the **Refund confirmation**, and then click **Confirm**.

</details>

---

[block:html]
Expand Down
16 changes: 16 additions & 0 deletions content/payment-methods/multibanco.md
Original file line number Diff line number Diff line change
Expand Up @@ -120,6 +120,22 @@ You can process refunds in your dashboard.

The customer must provide you with their IBAN to process refunds via bank transfer.

<details id="how-to-refund-an-order">
<summary>How to refund an order</summary>
<br>

1. Sign in to your <a href="https://merchant.multisafepay.com" target="_blank">MultiSafepay dashboard</a> <i class="fa fa-external-link" style="font-size:12px;color:#8b929e"></i>.
2. Go to **Transactions** > **Transaction overview**, and then click the relevant transaction.
3. On the **Transaction details** page, click **Refund order**.
4. In the **Account Holder Name** field, enter the customer's full name.
5. In the **IBAN** field, enter the customer's IBAN.
6. In the **Reason / Description** field, enter the reason for the refund or a description of what happened with the order, and then click **Complete**.
7. In the **Comment** field, enter any additional information.
8. In the **Amount** fields, enter the amount to refund.
9. Click **Continue**.
10. Review the **Refund confirmation**, and then click **Confirm**.

</details>
---

[block:html]
Expand Down
2 changes: 1 addition & 1 deletion content/point-of-sale/smartpos-activation.md
Original file line number Diff line number Diff line change
Expand Up @@ -40,7 +40,7 @@ To activate a SmartPOS terminal, follow these steps:
4. Below the **<<glossary:group>> name**, click **Add new group**, or select a previously created group.
5. Fill out the following fields:
- **New group name**.
- **Webhook URL** (optional).
- <a href="https://docs.multisafepay.com/docs/webhook" target="_blank">**Webhook URL** </a> <i class="fa fa-external-link" style="font-size:12px;color:#8b929e"></i>(optional).
- In the **Business category** field, click the **drop-down** icon and specify the relevant service or product offered. If a category has been assigned to your account in the past, it will be displayed automatically.
- **Logo**: Select an image you want to display in different places of your payment app, to show customized branding.
To add new images, upload them first via Settings > Files.
Expand Down
2 changes: 1 addition & 1 deletion content/point-of-sale/traditional-ctap.md
Original file line number Diff line number Diff line change
Expand Up @@ -35,7 +35,7 @@ Traditional (CTAP) is a terminal that has passed <a href="https://wp.acquiris.eu
4. Below the **<<glossary:group>> name**, click **Add new group**, or select a previously created group.
5. For a new group, out the following fields:
- **New group name**.
- **Webhook URL** (optional).
- <a href="https://docs.multisafepay.com/docs/webhook" target="_blank">**Webhook URL** </a> <i class="fa fa-external-link" style="font-size:12px;color:#8b929e"></i>(optional).
- In the **Business category** field, click the **drop-down** icon and specify the relevant service or product offered. If a category has been assigned to your account in the past, it will be displayed automatically.
6. Select Terminal type **CTAP**. A unique Terminal ID will be automatically generated.
**💡 Tip!** you can modify TID until manually via Devices > Terminals > TID until transactions are processed. The name can still be modified after processing transactions.
Expand Down
Binary file not shown.
2 changes: 2 additions & 0 deletions wordlist.txt
Original file line number Diff line number Diff line change
Expand Up @@ -341,6 +341,8 @@ Qwindo
REFUNDDESTINATION
RESTful
Rabobank
Rebrand
Rebranding
Regio
Registratie
Registreer
Expand Down

0 comments on commit 92f5dba

Please sign in to comment.