Payments.lk

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
A hotel deposit held at booking, part of it captured at check out and the rest released, as an illustration

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. 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.

  2. 2a

    Capture all of it

    Take the whole amount held, once you have delivered what was paid for.

    2b

    Capture 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.

    2c

    Or 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

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.

Read the pre-authorisation guide
Node.js
// 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.

See pricing

Ready to place your first hold?

Start your application and try holds in test mode today, with test keys and test cards.

Ask Payments.lk

Answers from the pages on this site.

Pre-authorisation · Payments.lk