The Payments API now supports emoji (such as 🍔) in the payment description.
The Methods API and Payments API now return a
resource parameter to indicate the type of object, consistent with the other APIs.
details.qrCode include for the Payments resource. You can add this parameter to the resource endpoint
?include=details.qrCode during creation, get or list operations and it will give you an object with a QR code embedded.
QR codes can be scanned by mobile applications to continue the payment on the mobile device.
In the Netherlands, the bank transfer QR code can be scanned by the mobile banking apps from ING and bunq. Bitcoin QR codes can be scanned by bitcoin wallet clients.
You can now retrieve an organization's open balance using the settlements/open resource.
profiles method of the Reseller API will now return a
<token /> field to help you integrate the Reseller API with our OAuth APIs.
Changed payment detail
signatureDate of Direct debit payments to return the date without the time.
countryCode (ISO 3166-1 alpha-2) property to the Payments resource.
signatureDate property to the Mandate resource.
The Reseller API erroneously only returned verified profiles for the
profiles method. Now all profiles, including profiles you just created are returned. Use the
<verified /> element to test if a profile is verified.
The final state of Recurring Credit card payments will no longer be reported in the initial API call. Instead, we will report the final payment state via the
webhookUrl, as per our documentation. This ensures any supplier outages will not delay or block our API response to your payment creation request.
Changed the minimum amount for PayPal to €
first Recurring payment now returns the
mandateId when available. When providing any of the following values for the
method parameter, you will now directly receive a
mandateId in the response:
belfius. When using
ideal as the payment method value, you will only receive a
mandateId in the response when the
issuer is also set.
When creating a payment without the
method parameter, optional parameters are applied once the consumer selects the payment method. For example, you can send the
dueDate parameter when creating a payment without a method. If the consumer then selects bank transfer, the due date is applied. If a different payment method is choosen, the due date is ignored.
The Settlement resource
?include=settlement is now available on all endpoints that return payments.
settlementId property to the Payment resource. It is also possible to include the complete settlement resource by providing the
include parameter, e.g.
Added new endpoint
/v1/settlements/*/payments to retrieve all payments included in a settlement. Also added this URL to the Settlement resource as
payments in the
We have added a new payment method, the KBC/CBC Payment Button. As a result the
method parameter now supports the value
kbc, which will create a KBC/CBC payment.
method parameter is passed with the value
kbc or when no method value is passed and KBC/CBC is chosen as the payment method, the
description parameter value will be truncated to 13 characters. This will be increased in the future.
recurringType parameter to the list methods endpoint. Using this parameter you're able to retrieve payment methods supporting
first payments and
issuer parameter for KBC/CBC payments. These work the same as for iDEAL, however they are not dynamically available through the API and the possible value are
cbc. When the issuer parameter is set in the API request, the Mollie Checkout screen will be skipped and the customer will be sent to KBC or CBC directly.
startDate parameter to the Subscriptions API. You can now specify the start date when you create a subscription.
Added an Invoices API resource.
locale parameters on our API endpoints accept non-standard values like
nl (shorthands for
nl_NL, respectively). We still support those non-standard values, but we're discouraging using those notations in our API documentation in favor of ISO-15897 locales.
You can now use locales such as
de_AT and we will try to provide translated and localized payments.
If you send any codepages or modifiers these will be stripped.