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. If you have a Mollie balance in the same currency as the payment, it will be settled on that balance directly without conversion. In all other cases, the payment will be converted to your primary balance currency. You can view the converted amount via the API or via your Mollie Dashboard.
Supported currencies
For PayPal, all currencies supported by PayPal are also supported by Mollie.
Support for other currencies than EUR
varies per payment method.
Currencies supported for card payments are generally also available for other card-based payment methods, such as Apple Pay.
Currency | ISO code | Decimal places | Payment methods |
---|---|---|---|
United Arab Emirates dirham | AED | 2 | Cards |
Australian dollar | AUD | 2 | Cards, PayPal |
Bulgarian lev | BGN | 2 | Cards |
Brazilian real | BRL | 2 | PayPal |
Canadian dollar | CAD | 2 | Cards, PayPal |
Swiss franc | CHF | 2 | Cards, PayPal |
Czech koruna | CZK | 2 | Cards, PayPal |
Danish krone | DKK | 2 | Cards, PayPal, Klarna |
Euro | EUR | 2 | All payment methods |
British pound | GBP | 2 | Cards, PayPal |
Hong Kong dollar | HKD | 2 | Cards, PayPal |
Hungarian forint† | HUF | 2 | Cards, PayPal |
Israeli new shekel | ILS | 2 | Cards, PayPal |
Icelandic króna | ISK | 0 | Cards |
Japanese yen | JPY | 0 | Cards, PayPal |
Mexican peso | MXN | 2 | PayPal |
Malaysian ringgit | MYR | 2 | PayPal |
Norwegian krone | NOK | 2 | Cards, PayPal, Klarna |
New Zealand dollar | NZD | 2 | Cards, PayPal |
Philippine piso | PHP | 2 | Cards, PayPal |
Polish złoty | PLN | 2 | Cards, PayPal, Przelewy24 |
Romanian leu | RON | 2 | Cards |
Russian ruble | RUB | 2 | Cards, PayPal |
Swedish krona | SEK | 2 | Cards, PayPal, Klarna |
Singapore dollar | SGD | 2 | Cards, PayPal |
Thai baht | THB | 2 | PayPal |
New Taiwan dollar† | TWD | 2 | PayPal |
United States dollar | USD | 2 | Cards, PayPal |
South African rand | ZAR | 2 | Cards |
† For PayPal payments made in Hungarian forint or New Taiwan dollar, we round the amount up to zero decimals since PayPal does not support smaller denominations.
Filtering payment methods
When integrating multicurrency we can use the Methods API to retrieve all methods available for the given amount and currency.
Request
curl -g -X GET "https://api.mollie.com/v2/methods?amount[value]=10.00&amount[currency]=SEK" \
-H "Authorization: Bearer test_dHar4XY7LxsDOtmnkVtjNVWXLSlXsM"
<?php
$mollie = new \Mollie\Api\MollieApiClient();
$mollie->setApiKey("test_dHar4XY7LxsDOtmnkVtjNVWXLSlXsM");
$methods = $mollie->methods->all([
"amount" => [
"currency" => "SEK",
"value" => "10.00"
]
]);
Response
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/external/icons/payment-methods/creditcard.png",
"size2x": "https://www.mollie.com/external/icons/payment-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/external/icons/payment-methods/paypal.png",
"size2x": "https://www.mollie.com/external/icons/payment-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"
}
}
}
Updated about 1 month ago