Skip to content

Missing fields payment request and outdated email refunds #156

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
pt-techaspa wants to merge 3 commits into
base: main
Choose a base branch
from
Open

Missing fields payment request and outdated email refunds #156

Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
851e57e
Added comission vatPresentage, description to body and note that a em…
pt-techaspa Dec 2, 2025
5de8c76
Added more text to comission vatPercentage.
pt-techaspa Dec 2, 2025
767e5b5
Merge branch 'main' into Missing-fields-to-create-payment-and-refund-…
pt-techaspa Jan 14, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
12 changes: 8 additions & 4 deletions docs/README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -313,6 +313,8 @@ Note, that at the moment HTTP 400 may occur also for 3rd party reasons - e.g. be

Email refunds are deprecated, please use `/payments/{transactionId}/refund` endpoint with the customer’s email.

**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.
Expand Down Expand Up @@ -1020,6 +1022,7 @@ General API HTTP status codes and what to expect of them.
| currency | alpha3 | <center>x</center> | Currency, only `EUR` supported at the moment |
| language | alpha2 | <center>x</center> | Payment's language, currently supported are `FI`, `SV`, and `EN` |
| orderId (Deprecated) | string | <center>-</center> | (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 | <center>-</center> | An internal information for the payment. Only visible in the Merchant panel. |
| items | [Item](#item)[] | <center>-</center> | Array of items. Always required for Shop-in-Shop payments. Required if VAT calculations are wanted in settlement reports. |
| customer | [Customer](#customer-1) | <center>x</center> | Customer information |
| deliveryAddress | [Address](#address) | <center>-</center> | Delivery address |
Expand Down Expand Up @@ -1080,10 +1083,11 @@ These URLs must use HTTPS.

##### Commission

| Field | Type | Required | Example | Description |
| -------- | ------- | ------------------ | ------- | --------------------------------------------------------------------------------------------- |
| merchant | string | <center>x</center> | 695874 | Merchant who gets the commission |
| amount | integer | <center>x</center> | 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 | <center>x</center> | 695874 | Merchant who gets the commission |
| amount | integer | <center>x</center> | 250 | Amount of commission in currency's minor units, e.g. for Euros use cents. VAT not applicable. |
| vatPercentage | integer | <center></center> | 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)

Expand Down