Pre-fill billing information

warning

The flow is available only to partners that already have customer billing information saved in their database.

Current flow

Partners can create transactions through an API call and redirect customers 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 customer is redirected to the transaction URL (redirect_url) to complete the exchange. During checkout, customers are required to enter their billing information. They may have already provided the same information on partner side.

Guardarian allows partners to pass billing information in the API call and bypass manual input on Guardarian checkout.

Pre-fill billing information

Partners can pass billing information through the API so customers do not have to enter it manually. Pass the data in customer.billing_info. Guardarian saves the supplied billing information for transactions belonging to the same customer.

Example request with the new billing_info block:

{
  "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": "customer's region",
      "city": "customer's city",
      "street_address": "customer's address",
      "apt_number": "123",
      "post_index": "123123",
      "first_name": "John",
      "last_name": "Doe",
      "date_of_birthday": "01.01.1991",
      "gender": "M"
    }
  }
}

field	type	required	available values
country_alpha_2	string	y	country ISO alpha-2 code
us_region_alpha_2	string	n	US region alpha-2 code without US- prefix
region	string	y	any
city	string	y	any
street_address	string	y	any
apt_number	string	y	any
post_index	string	y	any
first_name	string	y	any
last_name	string	y	any

warning

If only some billing information fields are passed, customers are required to fill the remaining fields. Guardarian pre-fills and saves the supplied fields.

note

Customers can change their billing information during the payment step.

Requirements

warning

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.