Skip to main content

Verify the Platform Connector

Once you have created a server and implemented Platform Event Notifications, there are several ways you can make sure that Bold and your platform have the same data and are functioning as expected.

Prerequisites

Trigger Platform Connector syncs

You can manually sync your platform's customers, orders, and products with Bold. Call each of the following endpoints:

Test Bold Checkout and Subscriptions functionality

If your Platform Connector is working correctly, it updates Bold whenever there is a change on the platform, and Bold updates the platform whenever there is a change on Bold's side.

You can verify that this is working correctly by testing the expected user behavior on your storefront. For example, if a shopper completes a new order, this triggers a call to Bold Checkout's Process Order endpoint, which in turn calls your Platform Connector's Create Order endpoint.

The following table shows how to trigger calls from Bold to your Platform Connector:

Platform Connector EndpointBold Checkout TriggersBold Subscriptions Triggers
Create CustomerCreate an order with the Initialize Order endpoint, and call the Process Order endpoint. The order must be for a new customer (no customer with that email already exists).Create a Bold Subscriptions order via the Create Subscription endpoint.
List CustomersInstall Bold Checkout.Install Bold Subscriptions.
Delete CustomerNot used by Bold Checkout.Not used by Bold Subscriptions.
Update CustomerNot used by Bold Checkout.Call to the Update Customer endpoint.
Validate Customer JWTNot used by Bold Checkout.The frontend loads the customer portal for a logged-in user.
Create AddressNot used by Bold Checkout.Call to the Create Customer Address endpoint.
Delete Customer AddressNot used by Bold Checkout.Call to the Delete Customer Address endpoint.
Update AddressNot used by Bold Checkout.Call to the Update Customer Address endpoint.
List OrdersNot used by Bold Checkout.Not used by Bold Subscriptions.
Create OrderCreate an order with the Initialize Order endpoint, and call the Process Order endpoint.Create an order with the Initialize Order endpoint, and call the Process Order endpoint. Additionally, when Bold Subscriptions creates an order recurrence.
Get OrderPerform an order update after the order is processed, such as fulfilling the order via the Update Line Item endpoint.Not used by Bold Subscriptions.
Update OrderPerform an order update after the order is processed, such as fulfilling the order via the Update Line Item endpoint.Not used by Bold Subscriptions.
Create PaymentNot used by Bold Checkout.Not used by Bold Subscriptions.
Update PaymentCreate and complete a checkout order. Capture a payment via the Bold Checkout admin user interface.Not used by Bold Subscriptions.
List ProductsInstall Bold Checkout.Install Bold Subscriptions.
List CategoriesInstall Bold Checkout.Install Bold Subscriptions.

Verify Platform Event Notifications

You can also trigger your Platform Event Notifications to update Bold with new data and check whether that data was added to Bold's database.

Create a new entity

First, create a new entity within your platform that Bold does not know about. For example, you can create a new product through your platform's user interface, if applicable.

If configured properly, this action causes your Platform Connector to trigger the Product Saved event notification, which Bold subscribes to. Bold responds with the success message to indicate the notification was received and processed.

Verify product creation

To verify that your new entity was created within the Bold database, make a call to one of the standard Bold API endpoints. For example, to confirm that Bold created your new product, call the List Products endpoint.