Pre-auth

1. Introduction

Pre-auth (pre-authorization) is a temporary hold placed on a customer’s funds to confirm they have enough money for a transaction. The money is not immediately deducted, but it is reserved for potential payment. Later, the merchant can either capture the amount (finalize the charge) or release it (cancel the hold).

It’s commonly used in hotels, car rentals, gas stations, and online payments where the final amount may change before the transaction is completed.

Think of it like a security deposit—the money is set aside but not actually spent until the final charge is confirmed.

2. Integration Steps

Before you start, make sure you have the following:

PayWay Sandbox Account – Register here to test transactions.

Sandbox Merchant ID & API Key—You’ll receive these via email after registering for the sandbox.

Create pre-auth transaction

Checkout API

Purchase with AoC/CoF Token

Please follow Purchase API specification.

Set type of the requst to pre-auth

Supported payment methods: ABA PAY, KHQR, Credit/Debit Card (Vsia, Mastercard, JCB, UPI)

Complete pre-auth

Without payout

With payout

To complete pre-auth without payout please follow Complete pre-purchase transaction API specification.

Cancel pre-auth

To cancel pre-auth please follow Cancel pre-purchase transaction API specification.

If don't cancel or complete pre-auth transaction within 30 days (default value), the transaction will automatically cancel. The fund will be return back to the payer.

1. Introduction#

2. Integration Steps#

1. Introduction

2. Integration Steps