Handling payment status
Every possible payment status
Depending on what happens payments go through a number of statuses. For most status changes we will call your webhook. Below an overview of all possible statuses a payment can have.
Status | Description | Webhook |
|---|---|---|
| The payment has been created, but nothing else has happened yet. | No |
| Your customer has canceled the payment. This is a definitive status. | Yes |
| This is a temporary status that can occur when the actual payment process has been started, but it’s not complete yet. Nothing really needs to happen on your end when this status occurs. | No |
| If the payment method supports captures, the payment method will have this status for as long as new captures can be created. Currently this status is only possible for the payment methods Cards, Klarna Pay Now , Klarna Pay Later, Klarna Slice it, Billie, and Riverty. | Yes |
| The payment has expired, e.g. your customer has abandoned the payment. This is a definitive status. For some payment methods like SEPA Bank Transfer it can take a few days for this status to occur. This status is definitive and we will call your webhook when it occurs. How much time it takes for a payment to expire depends on the payment method. We explain this in more detail below. | Yes |
| The payment has failed and cannot be completed with a different payment method. This is a definitive status. When you use Mollie Checkout and you offer multiple payment methods you will be redirected to the method selection screen after a payment failure. So, the consumer can choose another method to finish the payment. | Yes |
| This status occurs whenever a payment is successfully paid. This is a definitive status. | Yes |
How does one status lead to another?
The below diagram shows when to expect which status.
When does a payment expire?
When your customer doesn’t make an actual payment, the payment will, at some point, expire. After a specific expiry time, an open payment will become expired. This could happen when a customer decides not to make a payment after all and abandons it. The expiry time is different for each payment method.
Expiry times per payment method
Payment methods | Expiry time |
|---|---|
iDEAL paysafecard | 15 minutes |
Credit card | 30 minutes |
MyBank | 45 minutes |
Bancontact | 1 hour |
SOFORT Banking | 2 hours |
Klarna | 48 hours |
PayPal | 72 hours |
Bank transfer* | 12(+2) days |
It is not a good idea to predict payment expiry. Best wait until your webhook is called and fetch the status as usual. This is the most reliable way to keep your system in sync with Mollie, also in the case of expiring payments.
(*) Payments made by bank transfer are done manually by your customer. Some days can pass before it becomes clear the payment has been paid. That’s why the payment method banktransfer will by default, not expire until 12 days have passed. One or two days can be added when the 12th day is a Saturday or Sunday.
Updated 5 days ago
