Merge branch 'master' into dependabot/github_actions/dot-github/workf…

…lows/tj-actions/changed-files-41

.github/archive/integration-team/connectjs.md

@@ -34,7 +34,7 @@ MultiSafepay = {
     }
 }
 ```
-📘 **Note:** The `containerId` uses `multisafepayContainer` as an example class name. You can enter your own container name. 
+**⚠️ Note:** The `containerId` uses `multisafepayContainer` as an example class name. You can enter your own container name. 
 
 4. Add the ConnectJS library:
 ```

.gitignore

@@ -1,8 +1,12 @@
 .DS_Store
 
+# ignore JetBrains IDE files
+.idea
+
 # ignore all installed nodeJS packages
 node_modules
 
 # ignore vim swap files
 *.swp
 *.swo
+*.code-workspace

api/general/error-reference.md

@@ -166,6 +166,7 @@ The `gateway` is unavailable. This error can occur with <<glossary:direct>> requ
 - Check whether the payment method supports <<glossary:direct>> requests.
 - Ensure you specified a gateway in the create order request.
 - Check if the site is correctly configured for <<glossary:direct>> requests.
+- For payment components, check if the correct API token is used. Do not use an API key. 
 
 ---
 ### 1024: Transaction declined
@@ -182,6 +183,12 @@ Check that the:
 - Customer details are correct
 - Customer details match the credit details
 
+<<<<<<< HEAD
+**💡 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.
+=======
+**💡 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 reason for the decline.
+>>>>>>> 30f093744fe3101c455805012eec67440a287f7c
+
 ---
 ### 1024: For Cloudflare – Incorrect customer IP address
 

api/general/gateway-ids.md

@@ -17,6 +17,8 @@ hidden: false
 | Bank transfer                          | `BANKTRANS`   |
 | Belfius                                | `BELFIUS`     |
 | Betaal per Maand                       | `SANTANDER`   |
+| Bizum                                  | `BIZUM`       |
+| Billink                                | `BILLINK`     |
 | CBC/KBC                                | `CBC` / `KBC` |
 | Card payments                          | `CREDITCARD`  |
 | Dotpay                                 | `DOTPAY`      |
@@ -51,6 +53,7 @@ hidden: false
 | Amsterdam stadspas                     | `AMSGIFT`     |
 | Baby Cadeaubon                         | `BABYCAD`     |
 | Beautyandwellness                      | `BEAUTYWELL`  |
+| Beauty cadeau                          | `BEAUTYCAD`   |
 | Bloemencadeaukaart                     | `BLOEMENCAD`  |
 | Boekenbon                              | `BOEKENBON`   |
 | Degrotespeelgoedwinkel                 | `DEGROTESPL`  |

api/general/introduction.md

@@ -6,19 +6,14 @@ order: 1
 hidden: false
 ---
 
-Welcome to the MultiSafepay API reference (JSON gateway)!
+Welcome to the MultiSafepay API reference.
 
 To test using the API sandbox, you need to [create a test account](/docs/create-account/).
 
-[block:html]
-{
-  "html": "<iframe width=\"560\" height=\"315\" src=\"https://www.youtube.com/embed/hH6zdzN9BRs\" title=\"API reference video tour\" frameborder=\"0\" allow=\"accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture\" allowfullscreen></iframe>"
-}
-[/block]
 
-# Direct vs redirect
+# Request types
 
-With our API, you can create transactions through direct and redirect requests.
+With our API, you can create transactions through **direct** and **redirect** requests.
 
 Direct requests connect directly to the payment method, whereas redirect requests first send the customer to a [payment page](/docs/payment-pages/).
 
@@ -34,14 +29,34 @@ Then, if further customer action is:
 
 If you provide a `redirect_url`, after completing payment the customer is directed to your success/thank you page.
 
-For more information about the direct and redirect flows for a specific payment method, see the payment method page.
+---
 
-#### Flow
+# Flows
+For more information about the direct and redirect flows for a specific payment method, see the respective payment method page.
 
 Click to magnify.
 
 ![](https://files.readme.io/c702a54-DirectVsRedirectFlowchart.png "DirectVsRedirectFlowchart.png")
 
+---
+
+# Headers
+When submitting requests via our API to prevent errors, always include the relevant headers.
+- For **POST** and **PATCH** requests:
+#### Example
+```JavaScript
+curl -X POST '<URL here>'\
+-H 'accept: application/json' \
+-H 'content-type: application/json'
+```
+
+- For **GET** and **DELETE** requests:
+#### Example
+```JavaScript
+curl -X GET '<URL here>'\
+-H 'accept: application/json' \
+```
+
 # Wrappers and SDKs
 
 We provide the following SDKs and wrappers to facilitate integrating via our API:

api/general/transaction-expiration.md

@@ -13,7 +13,7 @@ Different payment methods set different expiration times for transactions. The t
 
 The expiration time is set by the payment method and cannot be changed.
 
-📘 **Note:** Transaction expiration times are different to session lifetimes of payment pages.
+**⚠️ Note:** Transaction expiration times are different to session lifetimes of payment pages.
 
 The table below sets out the expiration time per payment method:
 
@@ -27,12 +27,13 @@ The table below sets out the expiration time per payment method:
 | Bank transfer| 60 days  |
 | Belfius| 5 days   |
 | Betaal per Maand| 1 day |
+| Bizum| 30 minutes |
 | CBC/KBC| 5 days   |
 | Dotpay| 3 days   |
 | Google Pay| 1 hour   |
-| iDEAL| 1.5 hours|
+| iDEAL| 1 hour |
 | in3| 2 hours  |
-| Klarna| 1 hour   |
+| Klarna| 1 day   |
 | MB WAY| 4 minutes  |
 | Multibanco| 72 hours   |
 | MyBank| 1 hour   |

api/multisafepay-api/createaffiliate.md

@@ -0,0 +1,9 @@
+---
+title: Create affiliate
+category: 62430422470152003dc86e53
+slug: createaffiliate
+---
+
+## Authentication
+
+This endpoint requires an account **API key**. To obtain your account **API key**, email <sales@multisafepay.com>

api/multisafepay-api/gettransaction.md

@@ -6,7 +6,7 @@ slug: gettransaction
 
 ## How to test
 
-1. Under **Authentication** > **Query**, enter an [API key](/docs/sites#site-id-api-key-and-security-code) from your **TEST** account.
+1. Under **Authentication** > **Query**, enter a website [API key](/docs/sites#site-id-api-key-and-security-code) from your **TEST** account.
 2. Under **Path params**, enter the transaction ID.
 3. Click **Try it!**
 

api/multisafepay-api/getubo.md

@@ -0,0 +1,9 @@
+---
+title: Get UBO
+category: 62430422470152003dc86e53
+slug: getubo
+---
+
+## Authentication
+
+Authentication for this endpoint requires an account **API key**. To obtain your account **API key**, email <sales@multisafepay.com>.

api/multisafepay-api/listidealissuers.md

@@ -4,6 +4,12 @@ category: 62430422470152003dc86e53
 slug: listidealissuers
 ---
 
+### Update iDeal 2.0
+
+> ⚠️ Note:
+> 
+> Upon our migration to iDeal 2.0, the issuer is selected within the iDeal environment. The parameter  `issuer_id` is no longer required for requests with type  `direct`.
+
 ## How to test
 
 1. Under **Authentication** > **Query**, enter an [API key](/docs/sites#site-id-api-key-and-security-code) from your **TEST** account.

api/multisafepay-api/listpaymentmethods.md

@@ -1,9 +1,17 @@
 ---
 title: List payment methods
 category: 62430422470152003dc86e53
-slug: listpaymentmethods
+slug: listpaymentmethods-1 
 ---
 
+### Update iDeal 2.0
+
+> ⚠️ Note:
+> 
+> Upon our migration to iDeal 2.0, the issuer is selected within the iDeal environment. The parameter  `issuer_id` is no longer required for requests with type  `direct`. 
+> 
+> In the `additional_data` object, `issuers` will not be returned.
+
 ## How to test
 
 1. Under **Authentication** > **Bearer**, enter an [API key](/docs/sites#site-id-api-key-and-security-code) from your **TEST** account.

api/multisafepay-api/listtransactions.md

@@ -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 <sales@multisafepay.com>.
+   - 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!

api/multisafepay-api/listubos.md

@@ -0,0 +1,9 @@
+---
+title: List UBO
+category: 62430422470152003dc86e53
+slug: listaffiliateubos
+---
+
+## Authentication
+
+Authentication for this endpoint requires an account **API key**. To obtain your account **API key**, email <sales@multisafepay.com>.

api/multisafepay-api/updatesite.md

@@ -6,9 +6,10 @@ slug: updatesite
 
 ## How to test
 
-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!**
+
+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!**  
 
 ❗️ Never use a live API key!