Tickets - Login

Set Up Bolt for Salesforce SFRA

Prerequisites

This integration requires that you have the following installed on your local machine:

Refer to Salesforce’s Install and Configure UX Studio article for more information.

How to Install

Use the Bolt Integration SFRA PDF to install the latest version.

  • Bolt Integration SFRA 20.6.pdf (1307 ko)

  • Assign Roles

    Bolt introduces no new roles with this integration. You must update existing roles to use the Business Manager extension with Bolt Transactions.

    Data Storage

    This integration requires the following to store information:

    • System Object Extension: Used to store payment-related information
    • Custom Object Extension: Used to store basket-related information

    Custom Attributes

    Order

    • BoltAuthAmount(Number): Stores authorized amount
    • BoltCaptureAmount(Number): Stores captured amount
    • BoltDWLinkOrderID(String): Stores order ID linked with Bolt order
    • BoltPaidAmount(Number): Stores paid amount
    • BoltTransactionHistory(Text): Stores history of the Bolt transaction in relation to the actual payment transaction
    • BoltTransactionID(String): Stores Bolt transaction ID
    • BoltTransactionReference(String): Stores Bolt transaction reference ID
    • BoltTransactionStatus(String): Stores current payment status of the transaction
    • BoltTransactionType(String): Stores current type of the transaction
    • isBoltOrder(Boolean): Identifies if order is placed by Bolt

    OrderPaymentInstrument

    • BoltCardExpirationMonth(Integer): Stores the expiration month of the credit card
    • BoltCardExpirationYear(String): Stores the expiration year of the credit card
    • BoltCreditCardLastDigits(String): Stores last 4 digit of credit card
    • BoltCreditCardType(String): Stores credit card type

    OrganizationPreferences

    In Business Manager, navigate to Administration > Global Preferences > Global Custom Preferences.

    • appleDeveloperMerchantidDomainAssociation(Text): store ApplePay validation string

    Custom Objects

    In Business Manager, navigate to the Merchant Tools > Custom Objects > Custom Objects.

    • BoltDummyOrder: Stores cart details like item id, item quantity, coupon code, gift certificate code etc. These details are used to update orders (in Bolt) and place orders (in SFCC). This custom object is deleted from Business Manager after successful order placement.

    Track Service Availability

    Users are not able to checkout using Bolt if the Bolt service is unavailable. Service availability can be tracked in SFCC using the Service Status in the Commerce Cloud Business Manager. Navigate to Administration > Operations > Service Status > Bolt.http/bugsnag.http to track the Bolt service.

    View Logs

    Log files are located in the Logs folder, under Administration > Site Development > Development Setup > Logs). This integration introduces the following custom logs:

    Bolt Custom Logs

    These log files contain all errors related to information in the int_Bolt_sfra and bm_Bolt cartridges. Log example:

    custom-Bolt-blade5-0.mon.demandware.net-0-appserver-20191120.log
    

    Service communication Logs

    These log files contain every request and response to the Bolt API endpoint. Log examples:

    service-Bolt-blade5-0.mon.demandware.net-0-appserver-20191122.log
    service-Boltbugsnag-blade5-0.mon.demandware.net-0-appserver-20191121.log
    

    How to Enable Service Communication Logs

    1. Navigate to Administration > Operations > Services > Bolt.http/ bugsnag.http
    2. Select Communication Log Enabled.