Pre-Authorization
In this article, you will learn how to create pre-authorizations, capture reserved amounts, and export pre-authorizations.
A pre-authorization is the reservation of an amount as a payment guarantee. The amount is not charged to the customer’s card but is only reserved and held for a predefined period. For the merchant, this provides a payment guarantee.
For further information and practical use cases of pre-authorizations, please refer to the following article:
Pre-AuthorizationCreating a Pre-Authorization
Pre-authorizations can be created in the following e-commerce tools:
Paylink
Terminal
Tool "Pages"
To create a pre-authorization in the "Pages" tool, follow these steps:
Navigate to Pages > Overview in your Payrexx account.
Create a new page.
Go to the "Payment information" tab.
Select the payment type "Pre-authorization":

Tool "Paylink"
To create a pre-authorization in the "Paylink" tool, follow these steps:
Navigate to Paylink in your Payrexx account.
Create a new payment link.
In the "Payment information" section, select the payment type "Pre-authorization":

Tool "Terminal"
To create a pre-authorization in the "Terminal" tool, follow these steps:
Navigate to Terminal in your Payrexx account.
In the "Payment information" section, select the payment type "Pre-authorization":

Viewing Pre-Authorizations
To view the list of all reserved amounts, navigate to Payments > Pre-Authorizations in the main menu of your merchant administration:

Payment status
The status "Uncharged" indicates that a certain amount has been reserved on the card and is ready for charge in the coming days.
The status "Confirmed" indicates that the card has already been charged.
For more information on the different payment statuses in Payrexx, please refer to the following article:
Payment StatusPre-authorizations created in test mode can be identified by the label . For more information on testing payments, please refer to the following article:
Charging a Pre-Authorization
To charge a reserved amount on the customer's card, click on the corresponding row in the pre-authorizations list to open the detailed view:

Amount/Charged: the reserved amount (EUR 80.00) and the information on how much has already been charged (EUR 0.00)
Date: the date the amount was reserved on the card
Create Charge: the button to charge the amount
To deduct the amount from the customer's card, click the "Create Charge" button, which will open the following window:

Number: Specify how many times the amount (in this example, EUR 80.00) should be charged.
Charge custom amount: Define a custom amount to be charged. This amount can be smaller than the displayed amount, but not greater.
To deduct the amount from the customer's card, click the green "Charge" button.
The reserved amount has been successfully deducted from the customer's card.
Deleting a Pre-Authorization
If you do not wish to charge a reserved amount, you can delete the corresponding pre-authorization.
To do this, click on the corresponding row to open the detailed view of the pre-authorization. Then use the red button at the bottom of the page to delete the pre-authorization:

Exporting Pre-Authorizations
To export the list of created pre-authorizations to a CSV file, click the "Export" button at the top of the page:

For more information on Payrexx's export function, please refer to the following article:
ExportTrigger Webhook
If you have set up a webhook in your Payrexx account, you can send pre-authorizations to the webhook URL recorded under API and Plugins.
To do this, open the detailed view of the desired pre-authorization and click on "Trigger webhook":

Last updated
Was this helpful?