Place a hold for a paymentBETA¶
When you create a Mollie payment, your consumer authorizes the payment with the payment method and we automatically collect the funds for you.
With certain payment methods you can break this process up into two separate steps. First, you gather the consumer’s authorization to place a hold for a specified amount on their account. Then at a later point you can decide whether you want Mollie to collect (capture) the pending funds either fully or partially, or to cancel (void) the authorization.
Placing a hold is particularly useful in cases where you are not yet sure up front whether you will be able to fulfill the order completely. Rather than collecting the funds immediately and having to perform a partial or even full refund in your fulfillment process, you can simply perform a partial capture or void the authorization entirely.
Payment method support¶
For card payments, Mollie offers the ability to place a hold as an optional feature. By default, card payments are authorized and collected in one go.
For Klarna payments, placing a hold and collecting the funds manually is the only available flow. However, Klarna payments require the Orders API. Please refer to the Orders API overview for more information.
Delayed automatic capturing¶
In some cases you may want Mollie to always capture the funds after a number of days, unless you explicitly cancel the authorization in the meantime.
In these cases you can set captureMode back to automatic, and provide a captureDelay. The payment will then first move to authorized, and after the delay you specified Mollie will automatically capture the funds. As mentioned, you will still be able to either cancel the payment or to use the Captures API to manually capture the payment before the automatic capture is executed by Mollie.
Since the exact authorization window depends on the card used by the consumer, and the card is not known up front, we only support automatic capturing for up to 7 days after the authorization.
1 2 3 4 5 6 7 8
curl -X POST https://api.mollie.com/v2/payments \ -H "Authorization: Bearer test_dHar4XY7LxsDOtmnkVtjNVWXLSlXsM" \ -d "amount[currency]=EUR" \ -d "amount[value]=10.00" \ -d "description=Order #12345" \ -d "redirectUrl=https://webshop.example.org/order/12345/" \ -d "method=creditcard" \ -d "captureDelay=2 days"