Skip to content

Collecting partial card payment

Daniel Marek edited this page Sep 21, 2023 · 3 revisions

The payment gateway allows you to charge the customer a lower amount than the amount authorised and authenticated at the time of payment. The authorised amount is blocked on the customer's account for 3 days, i.e. payment is guaranteed for the merchant for this period.

Use cases

You will typically use a settlement of a lower amount in situations where the exact amount of the purchase is not known in advance. This may apply, for example, to online grocery shopping at a time when weighted goods are a part of the purchase. In this case, the payment is authorised for a slightly higher amount (taking into account the variance in the weight of the goods) and subsequently, after dispatch, a transaction is “closed” for a lower amount corresponding to the actual price of the goods.

How do I close a transaction for a lower amount?

When creating a transaction at the payment gateway (method payment/init), choose to close the transaction manually (set the closePayment parameter to false). Once you know the exact price, send the transaction to the settlement using the payment/close function. Enter the exact price in the amount parameter. This amount will be "charged" from the card account.

Attention! The transaction must be closed (sent to the settlement) within three calendar days of the payment being authorised. Otherwise the payment at the payment gateway expires and it is not possible to get money from the customer.

Feature availability

It is available for these payment methods

Supported API versions are

  • 1.5
  • 1.6
  • 1.7
  • 1.8
  • 1.9
Clone this wiki locally