Hello, payments.
Démarrez avec Mollie
Trouvez le guide dont vous avez besoin
Les dernières nouveautés de Mollie
Journal des modifications
- Added Point of sale payment details.
- Changed the endpoint from `Coming Soon` to `Beta`.
- Added Billie specific parameters to .
- Added the endpoint.
- Deprecated the endpoint.
- Previously, we allowed all merchants to refund an additional €25 on top of the original payment amount. We removed this functionality by default for all merchants as of May 29th, 2023. If you have a good use case for over-refunding, please reach out to Mollie Support so we can work with you on enabling this for your account.
- Added the
dagiftcard
as gift card issuer.
- Added new Manage order lines endpoint
- Added support for a dedicated
cancelUrl
in the Payments API and Orders API. The consumer will be sent to this URL if they cancel a payment or order. If thecancelUrl
is not provided, the consumer will be sent to theredirectUrl
as was already the case. - Added support for
Idempotency-Key
headers in the Mollie API, making API requests repeatable and idempotent within a specific timeframe. See API idempotency .
- Added new
Balances API
docs. - Added the
horseandgifts
etshoesandsneakerscadeau
as gift card issuer.
- Added
in3
as new payment method, which is only supported by the Orders API. If you are interested in accepting in3 payments, you can enable the payment method via the Mollie Dashboard.
- Added the
en_GB
(British English) locale to localize translations and allow for ordering the payment methods in the preferred order for the country.
- Added the
doenkadotickets
as gift card issuers.
- Added the support for more than one route to the Create payment endpoint.
- Added the possibility to Refund a split payment with the
routingReversals
optional parameter to the Create refund endpoint.
- Added the
wijncadeaukaart
etjewelcard
as gift card issuers. - Added optional
landing_page
parameter to the Authorize endpoint.
- Added a new Partners section containing the Get client and the List client endpoints.
- Added a Get partner status endpoint to the Organizations API.
- Added
huistuincadeaukaart
as gift card issuer.
- Added
authentication_required
as possiblefailureReason
in the Payments API for credit card payments.
- Added gift card issuers
bloemplantgiftcard
etsodexosportculturepass
.
- Added the possibility to create Split payments , with which you can distribute and split payments between your platform and your connected merchant accounts.
- Added
routing
optional parameter to the Create payment endpoint . - Added optional
routing
response parameter to the Create payment and Get payment endpoint responses. - Added the possibility to Refund a split payment . Added
reverseRouting
optional parameter to the Create refund endpoint androutingReversals
optional object to the Get refund endpoint response.
- We released the new Payment links API . This API makes it possible to generate payment links. These can for example be used to attach to invoices that have yet to be completed.
- The Create order payment endpoint on the Orders API now has a limit on how many payments can be created for an order. After reaching the limit of 25 payments a call to this endpoint will result in an error.
- Added
sku
optional parameter to the Update order line endpoint of the Orders API.
- Added gift card issuers
delokalecadeaukaart
,boekenbon
,bloemencadeaukaart
, andkluscadeau
. - Added
authentication_abandoned
etauthentication_unavailable_acs
as possiblefailureReason
in the Payments API for credit card payments.
- We discontinued the support for ING Home’Pay as a payment method. This means that the API now rejects all
Create payment endpoint calls with the method
inghomepay
. Be sure to remove this payment method from your checkout if needed. Contact us for more info.
amountChargedBack.value
in the Payments API has been changed from a negative to a positive value to make it consistent with the other equivalent fields in the API.
- We have added Revolut as new iDEAL issuer. It will appear automatically in your checkout if you use the Mollie Hosted
Payment Page or the Methods API to get the issuers. If you use a custom integration you should add the issuer ID
ideal_REVOLT21
to your list of available iDEAL banks.
- Added a new merchant category code (MCC) for profiles:
5262 Marketplaces, crowdfunding, donation platforms
. - Added the optional
givenName
etfamilyName
fields to the PaypalshippingAddress
object in the Payments API . - Added the
amountChargedBack
field to the payment response if the payment has some chargebacks. - We have added the following range to the list of IP addresses used to call webhooks: 87.233.217.240/28. The full list of IP addresses can be found here.
- We have added 7 new Merchant Category Codes for profiles:
5712 Home furnishing
5945 Hobby, Toy, and Game Shops
6051 Crypto currency
7922 Events, conferences, concerts, tickets
7997 Gyms, membership fee based sports
8111 Lawyers and legal advice
9399 Government services
- We brought the method
vouchers
out of beta, you can enable this method in the dashboard. See the voucher guide for more info and the requirements. - Certains
feeRegion
values for credit card were missing in the documentation. We have added them now.
- Added the
failureReason
to the Bancontact details object if the payment did not succeed. - Le site
locale
field of a payment object can now be updated via the Update payment endpoint .
- We have added a
dashboard
URL to the Get payment , Get order , Get customer , Get organization , and Get profiles endpoints. This URL points directly to the correct resource in the Mollie Dashboard. - Added gift card issuers
good4fun
etdecadeaukaart
. - You can now update the
issuer
field for gift card, iDEAL, and KBC/CBC payments via the Update payment endpoint .
- We have added a
mobileAppCheckout
URL to the Payments API response if the payment method supports payments via a companion (mobile) app. At the moment, this only involvesbancontact
.
- It is now possible to import your PayPal billing agreements by creating mandates via the Create mandates endpoint .
- We limit the amount that can be spent with a gift card to 50 euro per payment due to new regulations.
- Pay later is now available for Belgian shoppers.
- It is now possible to update the
metadata
of an order line via the Update order line endpoint . - Added
voucher
as new payment method. See our guide for how you can integrate this into your checkout. This payment method is currently in a private beta state. If you are interested in participating, reach out to your account manager or our support department.
- Added gift card issuers
restaurantcadeau
etdinercadeau
.
Mollie is moving to a monthly invoicing system. As some settlements span multiple months, these settlements will have their associated costs put on multiple invoices (one for each month). To accommodate the linking of specific costs to the specific invoice of that month, an
invoiceId
field is included for each monthly period (see the Get settlement endpoint ).For such settlements that span multiple months, the top-level
invoiceId
field now refers only to the oldest invoice. This could cause your bookkeeping integration to break as the invoice referenced by this ID will no longer cover all costs. The newinvoiceId
field of each period should be used instead.- We made it easier to ship a whole order at once by making the
lines
parameter in the Create shipment endpoint optional. - It is now possible to update the
webhookUrl
etredirectUrl
of an order via the Update order endpoint . - Duplicate refunds (same amount as another Refund on the same Payment within the hour) are now blocked by the API.
- Added the possibility to get the details of the remainder payment in the
details
object of a stacked payment. See the Get payment endpoint for more info. - Added "Sustainable Fashion Gift Card" as giftcard issuer.
- Added "FestivalCadeau Giftcard" as giftcard issuer.
- The expiry time of SOFORT Banking was changed to 2 hours.
- Added
shippingAddress
to the PayPal payment details. See . - Added dashboard URL to the .
- Added the possibility to embed the shipments of an order in the Get order endpoint .
- Added
restrictPaymentMethodsToCountry
to the . - Added support for IDNs (internationalized domain names) for webhook and redirect URLs in the Payments API .
- Added the possibility to also update the
interval
of a subscription via the Update subscription endpoint - Le site
self.href
,next.href
etprevious.href
links now correctly contain all query parameters used when performing the request. For example, theyear
query parameter will now be included in thenext
etprevious
links for the response of the List invoices endpoint if it was in the initial request. - Values for
_links.nnnn.href
elements now correctly include the?testmode=true
query parameter if this is necessary to be able to follow the link. This affects OAuth and Application Token authenticated requests only.
- Added the possibility to submit
extraMerchantData
for Klarna in the Orders API for merchants who have agreed this with Klarna. - Added
restrictPaymentMethodsToCountry
in the Payments API . - Added
shopperCountryMustMatchBillingCountry
in the Orders API . - Enabled Application fees for the Orders API .
- The webhooks will now be called from different IP addresses. This should not cause any problems if you do not check our IP address. We advise you not to check our IP address. A full list of all the IP addresses that we use to send webhooks can be found in our help center.
- We made the
cardFingerprint
field for Bancontact deprecated. See Get payment for more information. - Added
authentication_failed
as possiblefailureReason
in the Payments API for Credit Card payments. - Added the
sellerProtection
field to the PayPal payment details. - The Apple Pay direct integration can now also be used with .
- Added the
digitalGoods
field as PayPal parameter. See for more information. - Added support for PayPal Reference Transactions (recurring) payments. Make sure that the correct permissions are set and your merchant account has been approved by PayPal before using this.
- Added the
paypalFee
field to the PayPal payment details which shows the amount of fee PayPal is charging for that transaction.
- Added the
feeRegion
to the pricing object for credit card in the Methods API . - Added the
paypalPayerId
field to the PayPal payment details.
- Introduced a new endpoint for getting all subscriptions created for a website profile. See List all subscriptions for more info.
- Added new currencies for credit card:
AED
,NZD
,PHP
,RUB
,SGD
etZAR
. - Changed the retry schedule of our webhook system. We will try to call your webhook for 26 hours in total now. See the webhooks guide for the new schedule.
- Added gift card issuers
ohmygood
etreiscadeau
. - Added the
payments
key to the_links
object in the Subscription object. - Added property
vatRegulation
to and Submit onboarding data .
- Removed the charge date from the description of payments created by a subscription.
- Introduced a new endpoint to update some details of created payments. See Update payment for more info.
- Lowered the minimum amount for credit card payments with `sequenceType=first` to zero. See Recurring payments for more info.
- Orders can now be created with a custom expiry date. Use the new
expiresAt
parameter to set the custom date. See Create order for more info. - Added MyBank (
mybank
) as new payment method. Currently, it’s not possible to activate MyBank via the Dashboard. Contact your account manager to enable this new method. - Polish złoty (
PLN
) is now supported as a currency for the Przelewy24 payment method. - Settlements can now be retrieved using either their ID or their bank reference. See for more info.
- Added the
settlementId
field to the refund response. See for more info. - Changed the conditions for when an order is cancelable. Canceling an order is not longer possible when there are any open payments for the order, unless for four specific methods. See for more info.
- is now available.
- Added
american-express
,carte-bancaire
etmaestro
as possible values for thefeeRegion
in the credit card payment details. See the Get payment endpoint for details. - Apple Pay is now supported in Mollie Checkout and can be integrated in your webshop’s method selection.
- Refunds can now contain
metadata
. We will save the data alongside the refund. Whenever you fetch the refund with our API, we will also include the metadata. See the and documentation for more info. - Added gift card issuers
vvvdinercheque
etvvvlekkerweg
. - Removed
bitcoin
as payment method.
- Added a new endpoint for Mollie Connect to revoke access and refresh tokens. See the Revoke Token endpoint for details.
- Added the
profile
key to the_links
object in the Subscription object. - Subscriptions can now be created with application fees . The application fees will be applied on each created Payment for the Subscription.
- Added the
minimumAmount
etmaximumAmount
properties to the Methods API endpoints. It represents the minimum and maximum amount allowed for creating a payment with the specific methods. - Added the
amount
query parameter to the endpoint. - Added the
currency
query parameter to the endpoint. - Le site
.dev
TLD is now supported for webhooks. - Added gift card issuers
nationalegolfbon
etsportenfitcadeau
. - Added the new payment method Przelewy24 (
przelewy24
).
- Added profile website URL validation to the Create profile endpoint.
- Added profile website URL validation to the Submit onboarding data endpoint .
- Updated the list of available profile merchant category codes
- Le site
changePaymentState
link in the Payments API is now available for paid payments in test mode. This allows you to create refunds and chargebacks for test mode payments from the checkout screen. - We will now also call the webhook when a refund got canceled
- Added a new API for submitting onboarding data of a merchant. This data will be prefilled in the onboarding forms of
the merchant. You will need the new OAuth scope
onboarding.write
to submit data. For details, see the Submit onboarding data endpoint . - It is now possible to also update the
orderNumber
of an order, see Update order . - It is now possible to also update the
quantity
,unitPrice
,discountAmount
,totalAmount
,vatAmount
etvatRate
of the order line, see Update order line . - We have added the
metadata
field to the order line entity. You can now store up to 1Kb of information with your order line, see Create order . - Added a new endpoint to retrieve all payment methods Mollie is offering to an organization. See List all payment methods for details.
- Added a new API for getting the onboarding status of a merchant. You will need the new OAuth scope
onboarding.read
to access the data. For details, see the Onboarding API .
- Added the
locale
field to organization details. This represents the locale that the merchant has set in their Mollie Dashboard. - Added a new endpoint to update order lines. For details, see .
- The expiry period for Belfius Pay Button has been decreased from 1 day to 1 hour.
- It is now possible to create (another) payment for an order via the Create order payment endpoint on the Orders API.
- We are now offering webhooks for order payments. Note that when the status of the payment becomes
paid
we are calling your order webhook instead. See the Orders API for more info. - Enabling and disabling payment methods via the API is now possible via the Enable payment method endpoint on the Profiles API.
- Refunds for Pay later and Slice it can now be created via the Create payment refund endpoint . This allows refunding of arbitrary amounts.
- It is now possible to get the pricing of the payment methods that are active on the payment profile. Add the
include=pricing
parameter to the Methods API to get the pricing object in your response.
It is now possible to pass an
amount
when partially shipping, canceling or refunding order lines. This is necessary for order lines that have a non-zerodiscountAmount
.Before, it was not possible to partially ship, cancel or refund such order lines.
- Subscriptions in test mode will now be canceled automatically after 10 charges.
- It is now possible to refund SEPA Direct Debit payments.
- Moved the
organizationName
field in theshippingAddress
etbillingAddress
objects. - Added referral-functionality for Mollie Partners to the Connect API. See the documentation for more info.
- The maximum amount for SOFORT Banking payments has been increased from €5,000 to €50,000.
- Added
organizationName
field for orders, so from now a customer can specify the organization name if they buy something for business purposes. - We now accept the use of an underscore
_
in Redirect- and Webhook-URLs. - A guide has been added explaining how to test your integration of the Mollie API.
- Added the
changePaymentState
link to the Payments API . It allows you to set the final payment state for test mode recurring payments. - Added the
timesRemaining
field to the Subscriptions API . The field lists how many charges are left for completing the subscription. - Consumer IBANs of Bancontact payments will now always be shared via the API.
- Added Organization access tokens as an authentication method.
- PayPal refund period has been increased from 60 to 180 days.
- Le site
method
field on the Create Payment and Create order now also accepts an array of methods. By doing so you can select which methods to show on the payment method selection screen. For example, you can use this functionality to only show payment methods from a specific country to your customer. - It is now possible to specify a URL with a custom URI scheme as
redirectUrl
parameter. Previously, only the HTTP et HTTPS schemes were allowed. You can for example immediately redirect the customer back to your mobile app after completing a payment, by setting theredirectUrl
to your own App Scheme, likemy-app://payment-return
. - Added new category codes
5533
5641
5651
5732
5735
5815
5944
5977
7999
to the Create profile and Update profile endpoints. - We have added the
mandateId
field in subscriptions. This makes it possible to sure a specific mandate for a subscription. For details, see the Subscriptions API . - We have removed the dedicated French bank account for bank transfer payments. Your customers can use our Dutch bank account to finish the payment.
Added the new payment status
authorized
for payments that still require a capture to receive the money. Currently, this status is only used for payment methods Klarna Pay now, Klarna Pay later and Klarna Slice it. Because payments with these payment methods can only be created with the Orders API , there is no change required in existing implementations of the Payments API.The new status is especially useful to give a meaningful representation when listing all payments.
- Added the
nextPaymentDate
field in subscriptions to see when the next payment should be initiated. For details, see the Subscriptions API . - Added a new endpoint get all payments for a specific customer subscription. For details, see: List subscription payments
- Added
amountCaptured
etauthorizedAt
to the payment object. - Added the
metadata
field to the Subscriptions API . This makes it possible to, for example, link a plan to a subscription. - Added a new endpoint for partners to get all connected organizations. See the Reseller API Docs for more information.
- Added the Orders API and the Shipments API . See the Orders guide for more details on how to use these APIs.
- Added the Captures API .
- Le site
amount
field in chargebacks had the wrong sign, though it was documented correctly. The API has been changed to use positive values for theamount
field and negative values for thesettlementAmount
field in the endpoint. - You can now use a cursor to scroll through all chargebacks of a payment using the endpoint.
- Added the
mode
field to the Mandates API . This makes it possible to see in which environment the mandate is created. - Added a new endpoint for retrieving the website profile of the used API key. For details, see: Get current profile
- The icons returned by the Methods API have been updated. Note that the size of the icons has changed from 40×40 to 32×24. All icons are now available in SVG as well, which we advise you to use where possible.
- Test payments are no longer cleaned up after 2 weeks. Just like live payments they will never be removed.
- The Get settlement endpoint now returns the
invoiceId
if the settlement has been invoiced. The invoice is also available in the_link
object. Added a new endpoint for updating Subscriptions. Now you can update a subscription when needed — for example when your customer switches price plans.
For details, see Update subscription .
- Added the new payment methods Giropay (
giropay
) and EPS (eps
). Note that this method may not be available on your account straight away. If it is not, contact our support department to get it activated for your account. - Passing a payment description in the form of
Order <order number>
will now pass the order number to PayPal in the Invoice reference field which you can search. - Added new locales
en_US
nl_NL
nl_BE
fr_FR
fr_BE
de_DE
de_AT
de_CH
es_ES
ca_ES
pt_PT
it_IT
nb_NO
sv_SE
fi_FI
da_DK
is_IS
hu_HU
pl_PL
lv_LV
etlt_LT
to the Create customer , Create payment , and List methods endpoints to localize translations and allow for ordering the payment methods in the preferred order for the country.
- Launched multicurrency payments, along with the new v2 API.