Skip to main content

Guardarian Pre-Authorization

This guide explains how to integrate pre-authorization into Guardarian’s transaction creation flow.

Pre-authorization allows you to skip the email verification step on Guardarian’s side by authorizing the customer on your side and passing their contact information through the API.

This document covers:

  • How the pre-authorization flow works
  • How to request and use a pre-auth token
  • How this affects the end-user checkout experience
Availability

This feature is available upon request.
Please contact [email protected] or your account manager to enable it.

How It Works​

If the customer has already been authorized on your side, the authorization step on Guardarian’s checkout can be skipped.

Instead of asking the user to verify their email again, you can:

  • Pass the customer’s email address when creating a transaction
  • Receive a one-time pre-auth token
  • Redirect the customer directly to the Guardarian checkout already authorized

Guardarian will then handle the rest of the transaction flow.

Authorization Flow​

  1. Create a transaction on Guardarian and include the customer’s contact information
  2. Receive a one-time pre-auth token in the response
  3. Redirect the customer to Guardarian checkout with this token
  4. Guardarian completes the process without additional authorization steps

Pre-authorization flow example

Integrating with Guardarian​

Request​

Pass the customer’s email when creating a transaction:

"customer": {
  "contact_info": {
    "email": "[email protected]"
  }
}

Example:

// POST /v1/transaction
{
  "from_amount": 1200,
  "from_currency": "EUR",
  "to_currency": "BTC",
  "from_network": "EUR",
  "to_network": "BTC",
  "customer": {
    "contact_info": {
      "email": "[email protected]"
    }
   }
  }

Response​

In response you receive additional filed:

"preauth_token": "https://payments.guardarian.com/checkout?tid=4298466473&auth_token=1d7f52012db69717638817977b0edbc0eea04c91d0b3f74070b17b352132feea"

as well as a ready-made link for redirecting a user with authorization:

"redirect_url": "https://payments.guardarian.com/checkout?tid=4298466473&auth_token=1d7f52012db69717638817977b0edbc0eea04c91d0b3f74070b17b352132feea"

Full API documentation can be found in API Reference