Authorize Saved Card

POST {{api_base_url}}/v1/merchant/transactions/authorize

Authorize a payment using a saved payment method.

Required Variables

savedcreditcard_id:

The ID of a payment method attached to this shopper's account.
Testing: This value can be obtained from the Get Account Details request. For instructions on creating a test Bolt Account view documentation for that request.

savedshippingaddress_id:

The ID of a shipping address attached to this shopper's account.
Testing: This value can be obtained from the Get Account Details request. For instructions on creating a test Bolt Account view documentation for that request.

shopperemail & shopperphone:

The email and phone of the shopper placing the transaction.

The required variables are the minimum initial values necessary to get a request working. It is expected that you will add/modify more parameters throughout the integration process.

Request Body

{"auto_capture"=>true, "cart"=>{"items"=>[{"description"=>"Large tote with Bolt logo.", "quantity"=>1, "reference"=>"item_100", "sku"=>"BOLT-SKU_100", "unit_price"=>1000, "name"=>"Bolt Tote Bag"}], "tax_amount"=>0, "total_amount"=>1000, "currency"=>"USD", "display_id"=>"displayid_100", "order_reference"=>"100100"}, "credit_card_id"=>"{{saved_credit_card_id}}", "shipments"=>[{"cost"=>0, "id"=>"{{saved_shipping_address_id}}", "tax_amount"=>0}], "source"=>"direct_payments", "user_identifier"=>{"email"=>"{{shopper_email}}", "phone"=>"{{shopper_phone}}"}, "user_identity"=>{"first_name"=>"Alan", "last_name"=>"Watts"}}

HEADERS

KeyDatatypeRequiredDescription
X-API-KeystringBolt Account API Key
X-Publishable-KeystringBolt Account Publishable Key
AuthorizationstringAccess token is always required when authorizing a saved card for a logged-in shopper.