This document serves as a complete guide for pre-authorization into Guardarian’s transactions creation process. In this document, we will cover the technical aspects of customers pre-auth using pre-auth tokens, how getting these tokens from Guardarian, and how using a token will affect the target user’s experience.

This features is available by request, please contact [email protected] or your account manager.

How does it work?

If the customer has already passed authorization on the partner's side, authorization step on Guardarian side can be lifted. Instead, we suggest to provide the customer’s contact information (email) when creating transaction so that we can authorize customer without additional actions.

At the time of creating a new transaction, we create a one-time pre-auth token by which the customer can be authorized on Guardarian’s side.

Flow:

1. create a transaction in Guardarian with the customer’s personal information included
2. get one-time token for further use
3. redirecting the customer with the one-time token to Guardarian checkout
4. we handle the rest

Integrating with Guardarian

Request

Customer contact info can be passed to to Guardarian’s API while creating a transaction in the following format:

"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]"
    }
   }
  }