Authorizing payments is the final required step in setting up Accounts. It calls for use of our Authorize Payment API for Guest or or Bolt shopper to build out payloads and send account information and payment information to required systems.
Shopper Experience
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.
NOTE
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 address_id and credit_card_id.
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.
NOTE
In order to populate the create_bolt_account, make sure to have collected shopper consent via the Account Checkbox.
Next Step
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.