Occasionally, we will add new resources, new fields, or new possible values to existing fields to the v2 Mollie API. All changes are documented here.

October 2019

Monday, 7th

  • Added the paypalPayerId field to the PayPal payment details.

September 2019

Tuesday, 24th

  • 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 and ZAR.

Friday, 20th

  • Changed the retry schedule of our webhook system. We’ll try to call your webhook for 26 hours in total now. See the webhooks guide for the new schedule.

Tuesday, 17th

  • Added “OhMyGood” as giftcard issuer.

Thursday, 12th

  • Added “Reiscadeau” as giftcard issuer.

Monday, 9th

  • Added the payments key to the _links object in the Subscription object.

Wednesday, 4th

August 2019

Thursday, 29th

  • Removed the charge date from the description of payments created by a subscription.

Monday, 26th

  • Introduced a new endpoint to update some details of created payments. See Update payment for more info.

Wednesday, 21st

  • Lowered the minimum amount for credit card payments with sequenceType=first to zero. See Recurring payments for more info.

July 2019

Wednesday, 17th

  • 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.

Thursday, 4th

  • Added MyBank (mybank) as new payment method. Currently, it’s not possible to activate MyBank via the Dashboard. Please contact your account manager to enable this new method.
  • Polish złoty (PLN) is now supported as a currency for the Przelewy24 payment method.

Tuesday, 2nd

  • Settlements can now be retrieved using either their ID or their bank reference. See Get settlement for more info.

June 2019

Thursday, 20th

  • Added the settlementId field to the refund response. See Get payment refund for more info.

Thursday, 13th

  • 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 Cancel Order for more info.

Wednesday, 12th

May 2019

Tuesday, 21st

  • Added american-express, carte-bancaire and maestro as possible values for the feeRegion in the credit card payment details. See the Get Payment endpoint for details.

Monday, 20th

  • Apple Pay is now supported in Mollie Checkout and can be integrated in your webshop’s method selection.

Wednesday, 8th

  • Refunds can now contain metadata. We will save the data alongside the refund. Whenever you fetch the refund with our API, we’ll also include the metadata. See the Create Payment Refund and Create Order Refund documentation for more info.

Thursday, 2nd

  • Added “VVV Dinercheque” and “VVV Lekkerweg” as giftcard issuers.

Wednesday, 1st

  • Removed bitcoin as payment method.

April 2019

Friday, 19th

  • Added a new endpoint for Mollie Connect to revoke access and refresh tokens. See the Revoke Token endpoint for details.

March 2019

Wednesday, 27th

  • 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 and maximumAmount 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 List all payment methods endpoint.
  • Added the currency query paramter to the Get payment method endpoint.
  • The .dev TLD is now supported for webhooks.

Thursday, 21th

  • Added the “Nationale Golfbon” and “Sport & Fit Cadeau” as giftcard issuers.

Tuesday, 12th

  • Added the new payment method Przelewy24 (przelewy24).

February 2019

Thursday, 28th

Monday, 25th

Thursday, 21st

  • The 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.

Wednesday, 6th

  • We will now also call the webhook when a refund got canceled

January 2019

Tuesday, 29th

  • 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 API.

Tuesday, 22th

  • It is now possible to also update the orderNumber of an order, see Update order.

Thursday, 17th

  • It is now possible to also update the quantity, unitPrice, discountAmount, totalAmount, vatAmount and vatRate of the order line, see Update order line.

Monday, 14th

  • We’ve 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.

Thursday, 3th

  • Added a new API for getting the onboarding status of a merchant. You will need the new OAuth scope to access the data. For details, see the Onboarding API.

December 2018

Thursday, 20th

  • Added the locale field to organization details. This represents the locale that the merchant has set in their Mollie Dashboard.

Tuesday, 18th

Friday, 14th

Thursday, 13th

  • 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. Please note that when the status of the payment becomes paid we are calling your order webhook instead. See the Orders API for more info.

Monday, 10th

  • Enabling and disabling payment methods via the API is now possible via the Profiles API.

Friday, 7th

  • Refunds for Pay Later and Slice it can now be created via the Payments Refunds API. This allows refunding of arbitrary amounts.

Tuesday, 4th

  • 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.

November 2018

Wednesday, 15th

  • 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-zero discountAmount.

    Before, it was not possible to partially ship, cancel or refund such order lines.

Monday, 12th

  • Subscriptions in test mode will now be canceled automatically after 10 charges.

Thursday, 8th

  • It’s now possible to refund SEPA Direct Debit payments

Wednesday, 7th

  • Moved the organizationName field in the shippingAddress and billingAddress objects.

Monday, 5th

  • Added referral-functionality for Mollie Partners to the Connect API. See the documentation for more info.

Thursday, 1st

  • The maximum amount for SOFORT Banking payments has been increased from €5,000 to €50,000.

October 2018

Monday, 29th

  • Added organizationName field for orders, so from now a customer can specify the organization name if they buy something for business purposes.

Thursday, 25th

  • 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.

Wednesday, 24th

  • Added the timesRemaining field to the Subscriptions API to see 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.

Friday, 19th

  • PayPal refund period has been increased from 60 to 180 days.

Wednesday, 17th

  • The 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.

Monday, 15th

  • It is now possible to specify a URL with a custom URI scheme as redirectUrl parameter. Previously, only the HTTP and HTTPS schemes were allowed. You can for example immediately redirect the customer back to your mobile app after completing a payment, by setting the redirectUrl to your own App Scheme, like my-app://payment-return.

Friday, 12th

Friday, 5th

  • 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.

Tuesday, 2nd

  • 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 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.

September 2018

Tuesday, 25th

  • Added the nextPaymentDate field in subscriptions to see when the next payment should be initiated. For details, see the Subscriptions API.

Thursday, 20th

  • Added a new endpoint get all payments for a specific customer subscription. For details, see: List subscription payments
  • Added amountCaptured and authorizedAt to the payment object.

Tuesday, 18th

  • Added the metadata field to the Subscriptions API. This makes it possible to, for example, link a plan to a subscription.

Monday, 17th

  • Added a new endpoint for partners to get all connected organizations. See the Reseller API Docs for more information.

Wednesday, 12th

  • Added the Orders API and the Shipments API. See the Orders API overview for more details on how to use these APIs.
  • Added the Captures API.
  • The amount field in chargebacks had the wrong sign, though it was documented correctly. The API has been changed to use positive values for the amount field and negative values for the settlementAmount field in the Get chargeback API.
  • You can now use cursors to scroll through all chargebacks of a Payment using the List chargebacks API.

Tuesday, 11th

  • Added the mode field to the Mandates API. This makes it possible to see in which environment the mandate is created.

Monday, 10th

  • Added a new endpoint for retrieving the website profile of the used API key. For details, see: Get current profile

August 2018

Wednesday, 1st

  • The icons returned by the Methods API have been updated. Note that the size of the icons has changed from 40x40 to 32x24. All icons are now available in SVG as well, which we advise you to use where possible.

July 2018

Tuesday, 31st

  • Test payments are no longer cleaned up after 2 weeks. Just like live payments they will never be removed.

Thursday, 19th

  • The Get Settlement endpoint now returns the invoiceId if the settlement has been invoiced. The invoice is also available in the _link object.

Wednesday, 11th

  • 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

June 2018

Monday, 25th

  • 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.

Friday, 1st

  • 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 and lt_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.

May 2018

Wednesday, 9th