Authorizing payments is the final required step in setting up Accounts. It calls for use of our Authorize Payment API to build out payloads and send account information and payment information to required systems.
This is a backend process. Shoppers will not interact with any UI to trigger authorization other than inputting their payment information in the already implemented payment fields.
Submit a Payment Authorization POST Request
When the shopper is ready to pay, you should make a POST request to the Authorize Payment API. You should implement logic for each of the following use cases:
- Shoppers with an Existing Bolt Account.
- Shoppers with an Existing Bolt Account, but using a new card.
- Shoppers who do not have an existing Bolt Account.
Each use case is critical for authorizing each type of shopper in your checkout.
Shopper with an Existing Bolt Account
If the shopper has an existing Bolt Account and your store has successfully accessed this Bolt Account details, use the
MerchantCreditCardAuthorizationRecharge payload when interacting with the Authorize Payment API. This enables the store to leverage saved Bolt Account information via the
This request must include the Bolt access token in order to attribute the payment to the existing Bolt shopper account.
Shopper with an Existing Bolt Account Using a New Card
If the shopper has an existing Bolt Account and needs to use a new credit card for payment, use the
MerchantCreditCardAuthorization payload when interacting with the Authorize Payment API.
This request must include the Bolt access token in order to add the new credit card to the existing Bolt shopper account.
Shopper without an Existing Bolt Account
If the shopper wants to create a new Bolt Account, use the
MerchantCreditCardAuthorization payload when interacting with the Authorize Payment API. This enables your store to input a new billing/shipping address, a credit card token to charge, and a
create_bolt_account boolean that signals to Bolt that the shopper has elected to create a Bolt Account.
In order to populate the
create_bolt_account, make sure to have collected shopper consent via the Account Checkbox.
After you enable the Authorize Payment API, you can choose to further customize your Accounts configuration with (optional) Webhook Events, (optional) Back Office Operations, or (optional) Checkout Event Tracking.
After you’re done setting things up, you can use Bolt’s Test Card References to confirm all transaction scenarios are working as expected.