You can capture the billing address as part of your Universal Checkout integration and help drive strong conversion rates.

This can all be done directly in the Primer Dashboard! As well as setting up conditional logic for when to capture the billing address, you can also create custom billing address forms for different scenarios to cover all use cases.

This feature is only available for our drop-in UI, and not available for Headless yet.

Use cases

Collecting the billing address is an important part of any checkout flow but requirements on when to collect it can vary, including AVS, 3DS, and agreements with processors.

Primer’s unified solution means that you can add whatever business logic you need to ensure the billing address is captured appropriately and show a billing address form that matches the scenario - without needing to write a line of code.

Impacted payment methods

The billing address form is currently only available for Cards.

We will be rolling this feature out across other payment methods soon!

Configure capturing billing address

First, activate capturing billing address by going to the Checkout section of the Primer Dashboard and navigating to the Settings of the Card payment method panel. You need to toggle Billing Address on.

Card Settings

Next, you will need to set up your address form blocks.

Create a billing address form by selecting the fields you want to capture. Then, set up the conditions for when you want to show this billing address form.

Address Form

Postal Code is a required field as every processor will require it to process the payment where the billing address is required.

Conditions are evaluated from top to bottom. You can order the address form blocks in your preferred order they should be evaluated by simply dragging and dropping the blocks.

To see a specific billing address form in the Universal Checkout preview within the Checkout section, simply select the form and it will appear.

Universal Checkout will not capture the billing address if there are no conditions set up. The billing address form will not be displayed.

To go further

  • You can set the title of each address form block to make it easier to know what each block represents
  • To simplify the number of address form blocks required, you can choose what to show for ‘All other conditions

The billing address form is part of the card form. As a result, the logic to show the Card payment method supersedes the billing address logic.

If the Card payment method isn’t shown, nor will the billing address form.