Multicurrency

Mollie offers payments in non-EUR currencies via its v2 APIs. This allows your shoppers outside of the Eurozone to pay in their own currency. The payments will be settled to your account in EUR. Mollie will take care of the conversion. You can retrieve the settlement amount via the API or view it in your Dashboard.

When creating a payment in a non-EUR currency, we will immediately give you the amount we will settle in the API response.

Creating payments, refunds or subscriptions in a different currency than EUR is only possible via the v2 API. Review the Payments API reference for more information.

Payments in non-EUR currencies (created via the v2 API) that are retrieved via the v1 API will show the settlement amount (in EUR) in the amount field.

Supported currencies

For PayPal, all currencies supported by PayPal are also supported by Mollie.

Support for other currencies than EUR varies per payment method.

Currency ISO code Decimal places Payment methods
Australian dollar AUD 2 PayPal, credit card
Bulgarian lev BGN 2 Credit card
Brazilian real BRL 2 PayPal
Canadian dollar CAD 2 PayPal, credit card
Swiss franc CHF 2 PayPal, credit card
Czech koruna CZK 2 PayPal, credit card
Danish krone DKK 2 PayPal, credit card
Euro EUR 2 All payment methods
British pound GBP 2 PayPal, credit card
Hong Kong dollar HKD 2 PayPal, credit card
Croatian kuna HRK 2 Credit card
Hungarian forint HUF 2 PayPal, credit card

Note

Note that at PayPal, fillér are not supported, but at Mollie they are. We will round the amount sent to PayPal to whole florints.

Israeli new shekel ILS 2 PayPal, credit card
Icelandic króna ISK 2 Credit card
Japanese yen JPY 0 PayPal, credit card
Mexican peso MXN 2 PayPal
Malaysian ringgit MYR 2 PayPal
Norwegian krone NOK 2 PayPal
New Zealand dollar NZD 2 PayPal
Philippine piso PHP 2 PayPal
Polish złoty PLN 2 PayPal, credit card
Romanian leu RON 2 Credit card
Russian ruble RUB 2 PayPal
Swedish krona SEK 2 PayPal, credit card
Singapore dollar SGD 2 PayPal
Thai baht THB 2 PayPal
New Taiwan dollar TWD 2 PayPal

Note

Note that at PayPal, cents are not supported, but at Mollie they are. We will round the amount sent to PayPal to whole dollars.

United States dollar USD 2 PayPal, credit card

Filtering payment methods

When integrating multicurrency we can use the Methods API to retrieve all methods available for the given amount and currency.

Request

1
2
curl -g -X GET "https://api.mollie.com/v2/methods?amount[value]=10.00&amount[currency]=SEK" \
    -H "Authorization: Bearer test_dHar4XY7LxsDOtmnkVtjNVWXLSlXsM"

Response

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
HTTP/1.1 200 OK
Content-Type: application/hal+json; charset=utf-8

{
    "count": 2,
    "_embedded": {
        "methods": [
            {
                "resource": "method",
                "id": "creditcard",
                "description": "Credit card",
                "image": {
                    "size1x": "https://www.mollie.com/images/payscreen/methods/creditcard.png",
                    "size2x": "https://www.mollie.com/images/payscreen/methods/creditcard%402x.png"
                },
                "_links": {
                    "self": {
                        "href": "https://api.mollie.com/v2/methods/creditcard",
                        "type": "application/hal+json"
                    }
                }
            },
            {
                "resource": "method",
                "id": "paypal",
                "description": "PayPal",
                "image": {
                    "size1x": "https://www.mollie.com/images/payscreen/methods/paypal.png",
                    "size2x": "https://www.mollie.com/images/payscreen/methods/paypal%402x.png"
                },
                "_links": {
                    "self": {
                        "href": "https://api.mollie.com/v2/methods/paypal",
                        "type": "application/hal+json"
                    }
                }
            }
        ]
    },
    "_links": {
        "self": {
            "href": "https://api.mollie.com/v2/methods",
            "type": "application/hal+json"
        },
        "documentation": {
            "href": "https://docs.mollie.com/reference/v2/methods-api/list-methods",
            "type": "text/html"
        }
    }
}