How to Create a Bolt Order Token

Create an order token to initiate the checkout process. This token is used to reference the cart generated in your storefront.

1. Configure Authorization & Headers

1. Log in to the Merchant Dashboard.
2. Navigate to Developers > API.
3. Scroll to Keys and reveal your API Key.
4. Embed this Publishable Key on your website.

Headers

API URLs

2. Make a Create Order Request

1. Call Order Endpoint

See the Official API Reference for a request example.

PHP Example

<?php
require(dirname(__FILE__) . '/init_example.php');

$client = new \BoltPay\ApiClient([
    'api_key' => \BoltPay\Bolt::$apiKey,
    'is_sandbox' => \BoltPay\Bolt::$isSandboxMode
]);


$exampleData = new \BoltPay\Example\Data();
$cartData = $exampleData->generateCart();

/** @var \BoltPay\Http\Response $response */
$response = $client->createOrder($cartData);
$orderToken = $response->isResponseSuccessful()  ? @$response->getBody()->token : '';

2. Validate the Response

Request

Check for a HTTP 200 success code and that the response contains an order token.

Cart

Ensure that the order_reference value corresponds to the unique cart ID value provided in the request and that the cart_url matches as well.

Items & Totals

Ensure the following for each item and its values:

• Items listed in the response must match the items listed in the request
• The unit_price, total_amount and tax_amount must be in cents
• Every item must have an image_url, name, and description
• The total_amount must equal (quantity X unit_price) + tax_amount
• Every cent must be precisely accounted for