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
]);

$requestJson = file_get_contents('php://input');
$requestData = json_decode($requestJson);

$result = $client->getTransactionDetails(@$requestData->reference);

$response = [
    'confirmation_url' => 'order_confirmation.php',
    'transaction_detail' => $result->getBody()
];

header('Content-Type: application/json');
http_response_code(200);
echo json_encode($response);

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