From 851e57e35566e584392237865cab02a3de5ad152 Mon Sep 17 00:00:00 2001 From: Aspa Testaaja Date: Tue, 2 Dec 2025 13:33:36 +0000 Subject: [PATCH 1/2] Added comission vatPresentage, description to body and note that a email refund is outdated --- docs/README.md | 14 +++++++++----- 1 file changed, 9 insertions(+), 5 deletions(-) diff --git a/docs/README.md b/docs/README.md index 788556b..bbf5b5e 100644 --- a/docs/README.md +++ b/docs/README.md @@ -311,6 +311,8 @@ Note, that at the moment HTTP 400 may occur also for 3rd party reasons - e.g. be ### Email refunds +**Note!** This function is outdated. A separate email refund action is not needed. Include the customer's email in the [refund payment request](#refund-payment), and the system will handle the email automatically. + `HTTP POST /payments/{transactionId}/refund/email` email refunds a payment by transaction ID. ?> Email refunds are always asynchronous. When a refund request is accepted, the response contain status `ok` and the callback will be called. The callback is not called with the actual outcome. @@ -1017,7 +1019,8 @@ General API HTTP status codes and what to expect of them. | amount | integer |
x
| Total amount of the payment in currency's minor units, e.g. for Euros use cents. Must match the total sum of items and must be more than zero. By default amount should include VAT, unless `usePricesWithoutVat` is set to true. Maximum value of 99999998. | | currency | alpha3 |
x
| Currency, only `EUR` supported at the moment | | language | alpha2 |
x
| Payment's language, currently supported are `FI`, `SV`, and `EN` | -| orderId (Deprecated) | string |
-
| (Deprecated) Order ID. Was used for e.g. Walley payments order ID. This field is deprecated but remains here as a reference for old integrations. | +| orderId (Deprecated) | string |
-
| (Deprecated) Order ID. Was used for e.g. Walley payments order ID. This field is deprecated but remains here as a reference for old integrations. | +| description | string |
-
| An internal information for the payment. Only visible in the Merchant panel. | | items | [Item](#item)[] |
-
| Array of items. Always required for Shop-in-Shop payments. Required if VAT calculations are wanted in settlement reports. | | customer | [Customer](#customer-1) |
x
| Customer information | | deliveryAddress | [Address](#address) |
-
| Delivery address | @@ -1078,10 +1081,11 @@ These URLs must use HTTPS. ##### Commission -| Field | Type | Required | Example | Description | -| -------- | ------- | ------------------ | ------- | --------------------------------------------------------------------------------------------- | -| merchant | string |
x
| 695874 | Merchant who gets the commission | -| amount | integer |
x
| 250 | Amount of commission in currency's minor units, e.g. for Euros use cents. VAT not applicable. | +| Field | Type | Required | Example | Description | +| ------------- | ------- | ------------------ | ------- | ------------------------------------------------------------------------------------------------- | +| merchant | string |
x
| 695874 | Merchant who gets the commission | +| amount | integer |
x
| 250 | Amount of commission in currency's minor units, e.g. for Euros use cents. VAT not applicable. | +| vatPercentage | integer |
| 25.5 | Commissions VAT percentage. Values between 0 and 100 are allowed with one number in decimal part. | See [an example payload and response](/examples#create) From 5de8c760816ac412f596dc61a69b4280cb65d67a Mon Sep 17 00:00:00 2001 From: Aspa Testaaja Date: Tue, 2 Dec 2025 13:46:40 +0000 Subject: [PATCH 2/2] Added more text to comission vatPercentage. --- docs/README.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/docs/README.md b/docs/README.md index bbf5b5e..b1db9e5 100644 --- a/docs/README.md +++ b/docs/README.md @@ -1081,11 +1081,11 @@ These URLs must use HTTPS. ##### Commission -| Field | Type | Required | Example | Description | -| ------------- | ------- | ------------------ | ------- | ------------------------------------------------------------------------------------------------- | -| merchant | string |
x
| 695874 | Merchant who gets the commission | -| amount | integer |
x
| 250 | Amount of commission in currency's minor units, e.g. for Euros use cents. VAT not applicable. | -| vatPercentage | integer |
| 25.5 | Commissions VAT percentage. Values between 0 and 100 are allowed with one number in decimal part. | +| Field | Type | Required | Example | Description | +| ------------- | ------- | ------------------ | ------- | -------------------------------------------------------------------------------------------------------------------------------------------- | +| merchant | string |
x
| 695874 | Merchant who gets the commission | +| amount | integer |
x
| 250 | Amount of commission in currency's minor units, e.g. for Euros use cents. VAT not applicable. | +| vatPercentage | integer |
| 25.5 | Commissions VAT percentage. Values between 0 and 100 are allowed with one number in decimal part. If not given, 25.5 will be used as default | See [an example payload and response](/examples#create)