From 851e57e35566e584392237865cab02a3de5ad152 Mon Sep 17 00:00:00 2001 From: Aspa Testaaja Date: Tue, 2 Dec 2025 13:33:36 +0000 Subject: [PATCH 1/3] 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/3] 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) From 01820e59a8273675d7f5ad445c40fec238471254 Mon Sep 17 00:00:00 2001 From: Aspa Testaaja Date: Thu, 4 Dec 2025 13:40:33 +0000 Subject: [PATCH 3/3] Adding Paypal negative values to unitPrice --- docs/README.md | 28 ++++++++++++++-------------- 1 file changed, 14 insertions(+), 14 deletions(-) diff --git a/docs/README.md b/docs/README.md index b1db9e5..10d3b94 100644 --- a/docs/README.md +++ b/docs/README.md @@ -1034,20 +1034,20 @@ General API HTTP status codes and what to expect of them. ##### Item -| Field | Type | Required | Example | Description | -| ------------------------- | ------------------------- | ------------------ | ------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| unitPrice | integer |
x
| 1000 | Price per unit, in each country's minor unit, e.g. for Euros use cents. By default price should include VAT, unless [`usePricesWithoutVat`](#request-body) is set to true. Maximum value is 2147483647, minimum value is -2147483648. Negative value can't be used for Shop-in-Shop payments or when [`usePricesWithoutVat`](#request-body) is set to true. | -| units | integer |
x
| 5 | Quantity, how many items ordered. Negative values are not supported. Maximum value of 99999998. | -| vatPercentage | numeric |
x
| 25.5 | VAT percentage. Values between 0 and 100 are allowed with one number in decimal part. | -| productCode | string |
x
| 9a | Merchant product code. May appear on invoices of certain payment methods. Maximum of 100 characters. | -| description | string |
-
| Bear suits for adults | Item description. May appear on invoices of certain payment methods. Maximum of 1000 characters. | -| category | string |
-
| fur suits | Merchant specific item category. Maximum of 100 characters. | -| orderId (Deprecated) | string |
-
| | (Deprecated) Item level order ID (suborder ID). Mainly useful for Shop-in-Shop purchases. This field is deprecated but remains here as a reference for old integrations. | -| stamp | string |
-
| d4aca017-f1e7-4fa5-bfb5-2906e141ebac | Unique identifier for this item. Required for Shop-in-Shop payments. Required for item refunds. Maximum of 200 characters. | -| reference | string |
-
| fur-suits-5 | Reference for this item. Required for Shop-in-Shop payments. | -| merchant | string |
-
| 695874 | Merchant ID for the item. Required for Shop-in-Shop payments, do not use for normal payments. | -| commission | [Commission](#commission) |
-
| - | Shop-in-Shop commission. Do not use for normal payments. | -| deliveryDate (Deprecated) | string |
-
| 2019-12-31 | (Deprecated) When is this item going to be delivered. This field is deprecated but remains here as a reference for old integrations. | +| Field | Type | Required | Example | Description | +| ------------------------- | ------------------------- | ------------------ | ------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| unitPrice | integer |
x
| 1000 | Price per unit, in each country's minor unit, e.g. for Euros use cents. By default price should include VAT, unless [`usePricesWithoutVat`](#request-body) is set to true. Maximum value is 2147483647, minimum value is -2147483648. Negative value can't be used for Shop-in-Shop payments or when [`usePricesWithoutVat`](#request-body) is set to true. PayPal doesn’t support negative values. | +| units | integer |
x
| 5 | Quantity, how many items ordered. Negative values are not supported. Maximum value of 99999998. | +| vatPercentage | numeric |
x
| 25.5 | VAT percentage. Values between 0 and 100 are allowed with one number in decimal part. | +| productCode | string |
x
| 9a | Merchant product code. May appear on invoices of certain payment methods. Maximum of 100 characters. | +| description | string |
-
| Bear suits for adults | Item description. May appear on invoices of certain payment methods. Maximum of 1000 characters. | +| category | string |
-
| fur suits | Merchant specific item category. Maximum of 100 characters. | +| orderId (Deprecated) | string |
-
| | (Deprecated) Item level order ID (suborder ID). Mainly useful for Shop-in-Shop purchases. This field is deprecated but remains here as a reference for old integrations. | +| stamp | string |
-
| d4aca017-f1e7-4fa5-bfb5-2906e141ebac | Unique identifier for this item. Required for Shop-in-Shop payments. Required for item refunds. Maximum of 200 characters. | +| reference | string |
-
| fur-suits-5 | Reference for this item. Required for Shop-in-Shop payments. | +| merchant | string |
-
| 695874 | Merchant ID for the item. Required for Shop-in-Shop payments, do not use for normal payments. | +| commission | [Commission](#commission) |
-
| - | Shop-in-Shop commission. Do not use for normal payments. | +| deliveryDate (Deprecated) | string |
-
| 2019-12-31 | (Deprecated) When is this item going to be delivered. This field is deprecated but remains here as a reference for old integrations. | ##### Customer