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
- Complete the instructions in the following guides:
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 Endpoint | Bold Checkout Triggers | Bold Subscriptions Triggers |
---|---|---|
Create Customer | Create 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 Customers | Install Bold Checkout. | Install Bold Subscriptions. |
Delete Customer | Not used by Bold Checkout. | Not used by Bold Subscriptions. |
Update Customer | Not used by Bold Checkout. | Call to the Update Customer endpoint. |
Validate Customer JWT | Not used by Bold Checkout. | The frontend loads the customer portal for a logged-in user. |
Create Address | Not used by Bold Checkout. | Call to the Create Customer Address endpoint. |
Delete Customer Address | Not used by Bold Checkout. | Call to the Delete Customer Address endpoint. |
Update Address | Not used by Bold Checkout. | Call to the Update Customer Address endpoint. |
List Orders | Not used by Bold Checkout. | Not used by Bold Subscriptions. |
Create Order | Create 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 Order | Perform 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 Order | Perform 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 Payment | Not used by Bold Checkout. | Not used by Bold Subscriptions. |
Update Payment | Create and complete a checkout order. Capture a payment via the Bold Checkout admin user interface. | Not used by Bold Subscriptions. |
List Products | Install Bold Checkout. | Install Bold Subscriptions. |
List Categories | Install 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.