Pre-authorization

The integration of this feature allows temporarily withholding a specific amount on the customer's card before the actual capture takes place. This ensures that there are sufficient funds before proceeding with the transaction. The captured amount may be less than the preauthorized amount.

Below, it will be explained how to perform a pre-authorization in the integration modes:

• Hosted Payment Page
• Pay-by-Link
• XPay Build

---

Hosted Payment Page

The payment flow remains the same as the Hosted Payment Page solution, as it is necessary to call the same API:

• POST /orders/hpp

Valuing the "paymentSession" object with the parameter:

actionType

PREAUTH

It is possible to perform accounting operations on preauthorization through the APIs:

• Capture: POST /operations/{operationId}/captures
• Void/Refund: POST /operations/{operationId}/refunds

---

Pay-by-Link

The payment flow remains the same as the Pay-by-Link, solution, as it is necessary to call the same API:

• POST /orders/paybylink

Valuing the "paymentSession" object with the parameter:

actionType

PREAUTH

It is possible to perform accounting operations on preauthorization through the APIs:

• Capture: POST /operations/{operationId}/captures
• Void/Refund: POST /operations/{operationId}/refunds

---

XPay Build

The payment flow remains the same as the XPay Build, solution, as it is necessary to call the same API:

• POST /orders/build

Valuing the "paymentSession" object with the parameter:

actionType

PREAUTH

It is possible to perform accounting operations on preauthorization through the APIs:

• Capture: POST /operations/{operationId}/captures
• Void/Refund: POST /operations/{operationId}/refunds