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 Mollie 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, orders, 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, bitcoin
Bulgarian lev BGN 2 Credit card, bitcoin
Brazilian real BRL 2 PayPal, bitcoin
Canadian dollar CAD 2 PayPal, credit card, bitcoin
Swiss franc CHF 2 PayPal, credit card, bitcoin
Czech koruna CZK 2 PayPal, credit card, bitcoin
Danish krone DKK 2 PayPal, credit card, bitcoin
Euro EUR 2 All payment methods
British pound GBP 2 PayPal, credit card, bitcoin
Hong Kong dollar HKD 2 PayPal, credit card, bitcoin
Croatian kuna HRK 2 Credit card, bitcoin
Hungarian forint HUF 2 PayPal, credit card, bitcoin

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

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, bitcoin

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
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
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"
                    }
                }
            },
            {
                "resource": "method",
                "id": "bitcoin",
                "description": "Bitcoin",
                "image": {
                    "size1x": "https://www.mollie.com/images/payscreen/methods/bitcoin.png",
                    "size2x": "https://www.mollie.com/images/payscreen/methods/bitcoin%402x.png"
                },
                "_links": {
                    "self": {
                        "href": "https://api.mollie.com/v2/methods/bitcoin",
                        "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"
        }
    }
}