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 2018

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

Friday, 28th

  • Bitcoin payments can now be created in non-EUR currencies. Your account will be settled in EUR.

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

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. For details, see: List organizations

Wednesday, 12th

  • Added the Orders API and the Shipments API. See the Orders API overview for more details on how to use these API’s.
  • 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