Create Tokenizations with VR pay secure API

In our API, you can process tokenizations with the VR pay secure Gateway or the payment link endpoint.
To simplify, we will explain it with the VR pay secure Gateway example. However, the links to the corresponding payment link API endpoints are also attached.

Step 1
VR pay secure Gateway Creation

Create a Gateway with the parameter Preauthorization _set to _true.

Create a VR pay secure Gateway
Create a payment link
All required fields of the gateway must always be set!

Make sure the payment provider activated in your account supports tokenizations.

Step 2
Customer authorization

After creating your VR pay secure Gateway you will get a link to the payment form as a response to your request.
Send this to your customer and let him authorize the payment.
A Notifications (Webhooks) and an email notification will be triggered, once the customer authorizes the payment.

Step 3
Get the transaction ID

This ID is provided when you retrieve the Gateway from Step 1.

Retrieve a VR pay secure Gateway
Retrieve a payment link

You can also find this ID in the webhook sent once the transaction is authorized from Step 2.

Example on where the Transaction ID can be found:

{
    "status": "success",
    "data": [
        {
            "id": 1,
            "status": "(waiting|confirmed|authorized|reserved)",
            "invoices": [
                {
                    "transactions": [
                        {
                            "id": 2012844,
                        }
                    ],
                }
            ],
        }
    ]
}

Step 4
Charge the customers card

Use Charge a Pre-Authorized/Reserved Transaction to make a charge on the authorized transaction. Use here the transaction ID which you got in Step 3 and any amount you want to charge.

Information
You can charge any amount. Higher or lower then the one set in Step 1.
But there is no guarantee that the charge can be executed successfully!

There is also the possibility to repeat Step 4 and make more charges as often as you like.

Create Tokenizations With VR pay secure tools

In our API, you can process tokenizations with the following VR pay secure Gateway tools:

Pages (QuickShop)
Payment link (QuickLink)
QR Code (QuickCode)
Checkout (QuickCheckout)

For simplicity reasons, we will explain it with the example of the Checkout.

Step 1
Prepare your Checkout

Navigate to QuickCheckout in your VR pay QuickCommerce dashboard, select Tokenization and save your changes.

Make sure the payment provider activated in your QuickCommerce account supports tokenizations.

Step 2
Customer authorization

After saving your QuickCheckout, copy the link and send it to your customer.
A Notifications (Webhooks) and an email notification will be triggered once the customer authorizes the payment.

Step 3
Find the transaction

Navigate to Zahlungen > Tokenizierungen and find your transaction.

Step 4
Charge the customers card

Click on "Create Charge", directly on the row of the corresponding transaction.
Now you can choose the amount that should be charged.

🚧
Information

You can charge any amount, higher or lower than the one set in Step 1. Yet there is no guarantee for the charge to be executed successfully!

You can repeat Step 4 as often as you like to make even more charges.

When a credit card is not valid anymore, you will need to make a new tokenization for the new credit card of your customer.

Create Tokenizations with VR pay secure API

Create Tokenizations With VR pay secure tools

🚧Information

🚧
Information