<aside> ⚠️ Please note that the new flow is available only to partners who already have their users’s billing info saved in their database.

</aside>

Current flow

Currently, partners of the Guardarian cryptocurrency exchange platform are able to create transactions via an API call and redirect users to the transaction URL:

{
  "from_amount": 1200.24,
  "from_currency": "EUR",
  "to_currency": "BTC",
  "from_network": "EUR",
  "to_network": "BTC"
}

Once the API call is made, the user is redirected to the transaction URL (response field redirect_url) to complete the exchange. Then, during the checkout step, users are required to manually input their billing information. This flow can be cumbersome for users, as they may have already provided their billing information while registering on the partner’s platform.

To address this, Guardarian has introduced a new flow that allows partners to pass billing information in the API call and bypass the manual input of billing information on the Guardarian platform. This new flow aims to streamline the transaction process and provide a more efficient user experience for partners and their users.

Skipping billing info flow

Guardarian’s new flow for partners allows for the passing of billing information data through an API call, thereby eliminating the need for users to manually input their billing information on the platform. Partners can now pass a data block to the customer.billing_info field, which will save the billing information provided and persist it between different transactions for the same user.

Example request with the new billing_info block:

// POST /v1/transaction

{
  "from_amount": 1200,
  "from_currency": "EUR",
  "to_currency": "BTC",
  "from_network": "EUR",
  "to_network": "BTC",
  "customer": {
    "contact_info": {
      "email": "[email protected]"
    },
    "billing_info": {
      "country_alpha_2": "US",
      "us_region_alpha_2": "CA",
      "region": "user's region",
      "city": "user's city",
      "street_address": "user's address",
      "apt_number": "123",
      "post_index": "123123",
      "first_name": "John",
      "last_name": "Doe",
      "date_of_birthday": "01.01.1991",
      "gender": "M"
    }
   }
  }

<aside> ⚠️ Note: if only a part of the billing info fields is passed, users will still be required to fill the remaining fields. The passed fields will be filled and saved accordingly.

</aside>

<aside> ℹ️ Note: Guardarian recognizes that some users may still need to update their billing information, and therefore allows users to manually change their billing information during the payment step.

</aside>

Requirements

<aside> ⚠️ Guardarian’s new flow for passing billing information data through an API call is not enabled by default for all partners. Partners who wish to leverage this new feature will need to contact Guardarian to enable it for their accounts.

</aside>