Pre-authorisation
Hold a card now. Charge it when you know the amount.
The customer's bank sets the amount aside on their card and nothing is taken. When you know what they owe, capture all of it or part of it, or release it and take nothing. You pay fees only on what you capture.
- Time to capture
- 7 days, less 2 hours
- Captures per hold
- One, all or part
- Fee for a released hold
- None
Who it is for
When the final amount comes later
A hold gives you the customer's commitment now, and lets you charge what is really owed once you know it.
Hotels and stays
Hold the stay at booking. At check out, capture the room and anything added, or release it if the guest cancels in time.
Rentals and deposits
Hold a deposit for a vehicle, equipment or a venue. Capture part of it for damage or extra days, or release it when everything comes back.
Made to order and pre-orders
Hold the price when the order is placed and capture it when the order is made or ready to send. Release it if you cannot fill it.
Services billed after the job
Hold an estimate for a repair, a delivery or an event. Capture what the work really cost, up to the amount held.
How it works
Authorise first, then one of three things
The customer pays on the same hosted checkout as any payment and passes their bank's check. Their bank authorises the amount, and nothing is taken until you act.
- 1
Authorise
Create a checkout with a hold, or place one on a card the customer saved. The card is authorised for the amount and the customer sees Card authorised.
- 2a
Capture all of it
Take the whole amount held, once you have delivered what was paid for.
2bCapture part of it
Take less than was held, such as a deposit less what was returned. The rest is released at once and cannot be captured later.
2cOr release it
Take nothing. The customer's bank frees the amount on their card, and the hold costs you nothing.
The window
Just under 7 days to decide, and nothing left hanging
Payable keeps a hold for 7 days. Payments.lk closes the window 2 hours before that, so a capture reaches the bank in time, and shows you the exact time left on every hold.
- Every hold shows the date and time it ends, in the dashboard and in the API.
- A hold you neither capture nor release is released for you once its time ends. Nothing is taken.
- You receive an event for every hold that ends, however it ends.
The rules
Simple to run, simple to explain to a customer
One action per hold
One full capture, one partial capture or one release. After a partial capture the rest of the hold is let go.
Fees only on what you capture
What you capture is a card payment at your plan's rate, from 2.29%. A released or expired hold costs nothing.
Refunds after a capture
A captured payment refunds like any other, in full or in part, up to what was captured.
Availability
Where you can use it today
Test mode: every account
Place, capture and release holds with test keys and test cards once you have submitted your application, before you are approved.
Live: Visa and Mastercard through Seylan Bank
Live holds work for Visa and Mastercard payments processed through Seylan Bank, once pre-authorisation is switched on for your account with Payable. Payments.lk switches it on for you, and the dashboard says plainly if anything is still missing.
Other banks: not yet
Live holds through Commercial Bank and Nations Trust Bank are not available yet. Accounts on those banks can use holds in test mode.
Where holds work
On checkouts opened on the web, and on saved cards charged from your server or your dashboard. Payment links, checkout pages, invoices and subscriptions take the money at once, and our mobile app SDKs do not read a held checkout's return yet.
In your dashboard
Every hold, with the time left
Pre-authorisations lists every hold, live and sandbox apart. Open one to capture all of it or part of it, or to release it.
- Capture all of it, or any amount up to what was held.
- Release a hold, with a note for your records.
- Live captures ask for your password and a one time code. A release does not, since it takes nothing.
- The owner, admins and support can capture and release.
For developers
One field on a checkout, one call after it
Send captureMethod manual when you create a checkout or charge a saved card. Then call capture, with or without an amount, or release. Signed webhooks tell you when each step is done.
// At booking: hold the deposit. The card is authorised and nothing is taken.
const checkout = await lk.checkouts.create(
{
amountCents: 2500000, // Rs. 25,000.00
description: "Room 12 deposit, 21 to 23 November",
reference: "booking-5521",
successUrl: "https://yourhotel.lk/bookings/5521",
captureMethod: "manual",
},
{ idempotencyKey: "booking-5521" },
);
// At check out: take Rs. 18,000.00 of it. The rest is released.
await lk.payments.capture(paymentId, { amountCents: 1800000 }, { idempotencyKey: "booking-5521-capture" });
// Or take nothing at all.
await lk.payments.release(paymentId, { idempotencyKey: "booking-5521-release" });Priced like any card payment
You pay your plan's card rate, from 2.29%, on the amount you capture, and nothing on what you release. Holds carry no fee of their own.
Ready to place your first hold?
Start your application and try holds in test mode today, with test keys and test cards.