Skip to content
APIs/APMs/
Euteller

Last updated: 01 October 2025 | Change log

Euteller

Euteller is a Finnish real-time bank transfer.

Note

Make yourself familiar with our API Principles to ensure a resilient integration.

Product Overview

Why use EUTELLER?

Since its foundation in 2007, Euteller prides itself having processed over one billion Euros for its customers. This enables over 3 million potential customers to make online payments in real time from a bank account held at any of the major Finnish banks.

Feature summary

Payment typeCountryAcceptance CurrencyRecurringReversalsPartial Reversals
Bank TransferFinlandEUR❌❌❌
  • Minimum Transaction Value: 1.00 EUR
  • Maximum Transaction Value: 10.000 EUR

Set your headers

Setting your headers is an important part of an API request. The headers represent the meta-data associated with your API request.

Authorization: {your_credentials}
Content-Type: application/json
WP-Api-Version: 2023-06-01
HeaderDescription
AuthorizationWe use the Authorization header to identify and authenticate you within Access Worldpay. You -must- use the Authorization header for any request you send to our APM API.
Content-TypeWe require the Content-Type header if the request you're sending includes a request body, and if the HTTP method is a POST or a PUT.
WP-Api-VersionWe use the WP-Api-Version header to identify which version of our APM API you are using. You must use the WP-Api-Version header for any request you send to our API.

If you're using both the Content-Type and WP-Api-Version headers, they must match.

Note

Replace {your_credentials} with your base64-encoded Basic Auth username and password. To get your Access Worldpay credentials contact your Implementation Manager.

Take a payment

POST https://try.access.worldpay.com/apmPayments

Example request

{
    "transactionReference": "Memory265-13/08/1876",
    "merchant":
    {
        "entity": "default"
    },
    "instruction":
    {
        "narrative":
        {
            "line1": "Mind Palace Ltd"
        },
        "value":
        {
            "amount": 20,
            "currency": "EUR"
        },
        "paymentInstrument":
        {
            "type": "euteller",
            "country": "FI",
            "shopperEmailAddress": "example@gmail.com",
            "successURL": "http://httpbin.org/anything/success",
            "pendingURL": "http://httpbin.org/anything/pending",
            "cancelURL": "http://httpbin.org/anything/cancel"
        }
    }
}

Parameters

ParameterRequired?DescriptionData typeLength
transactionReference✅A unique reference generated by you that is used to identify a payment throughout its lifecycle. See transaction reference format.StringMust be between 1 to 64 characters.
merchant✅An object that contains information about the merchant.ObjectN/A
merchant.entity✅Direct your payment to assist with billing, reporting and reconciliation. This is mandatory for Authentication and Queries.
Contact your Implementation Manager for more details.		StringMust be between 1 and 32 characters.
instruction✅An object that contains all the information related to the payment.ObjectN/A
instruction.narrative✅An object that helps your customers better identify you on their statement.ObjectSee our formatting rules
instruction.narrative.line1✅The first line of the narrative which appears on your customer's statement (If a character is not supported it is replaced with a space.).
See narrative line1 format for more details.		Object24
instruction.value✅An object that contains information about the payment transaction.ObjectN/A
instruction.value.amount✅The payment amount. This is a whole number with an exponent e.g. if exponent is two, 250 is 2,50. You can find the relevant exponent in our currency table.IntegerN/A
instruction.value.currency✅The payment currency. Refer to the individual APM page for supported currencies.Integer3
instruction.paymentInstrument✅An object that contains information about the payment method.ObjectN/A
instruction.paymentInstrument.type✅The payment type and details. It defines which alternative payment method you wish to use. Value is "euteller".ObjectN/A
paymentInstrument.country✅The country of your customer. Follows alpha 2 ISO 3166-1 standard.Object2
paymentInstrument.shopperEmailAddress✅The email address of your customer.StringN/A
instruction.paymentInstrument.cancelURL✅When your customer cancels a transaction, we redirect your customer to that cancel URL.StringN/A
instruction.paymentInstrument.pendingURL✅When we receive the payment result for a pending payment transaction, we redirect your customer to that pending URL.StringN/A
instruction.paymentInstrument.successURL✅When we receive the payment result for a successful payment, we redirect your customer to that success URL.StringN/A

Response

Successful request response

  • an HTTP code 201
  • an id which is unique to the payment - we recommend storing the "id" as this can be used to manage the payment later
  • a url to redirect your customer to the APM provider to complete the payment
  • a link to query the payment status

Example Response

{
    "paymentId": "nFxASqw-LV9HE_rr1mMONJmqBDeXmnv5dzt9IxAXgXbfpu0O_8mOnTpFSIM9gnTSygCKQgvlwQdUbu5rExIpJA_5Uq2LEGXXAanycRpxfDPNA-E70zIWdnaMb2gJhC8AIhbOkM6xDiVNu90YCXo2snTzi_k1sEOQnKIAJNTW3Qc",
    "lastEvent": "pending",
    "_links": {
        "self": {
            "href": "https://access.worldpay.com/apmPayments/nFxASqw-LV9HE_rr1mMONJmqBDeXmnv5dzt9IxAXgXbfpu0O_8mOnTpFSIM9gnTSygCKQgvlwQdUbu5rExIpJA_5Uq2LEGXXAanycRpxfDPNA-E70zIWdnaMb2gJhC8AIhbOkM6xDiVNu90YCXo2snTzi_k1sEOQnKIAJNTW3Qc"
        }
    },
    "_actions": {},
    "url": "https://payments.worldpay.com/app/hpp/integration/wpg/corporate?OrderKey="
}
Note

In case of an error, you can get further information in our error reference.

Next Steps

Manage your Euteller payment