Check Transaction Status

Retrieve status and main transaction details. Method: GETPath: /v1/merchant/transactions/ Environments

Header Parameters

ParameterTypeRequiredDescriptionX-API-KEYstring✅Your secret API key. Used to authenticate server-to-server requests.X-PUBLISHABLE-KEYstring✅Your publishable API key. Identifies your merchant account in client-facing and server requests.

Path Parameters

ParameterTypeRequiredDescriptionTRANSACTION_REFERENCEstring✅The value can be parsed from the Bolt Webhook payload or from the response when getting a Payment Link Status.

Example Request

CURL
curl --request GET \
--url https://api-sandbox.bolt.com/v1/merchant/transactions/{TRANSACTION_REFERENCE} \
--header 'X-API-KEY: YOUR_API_KEY' \
--header 'X-PUBLISHABLE-KEY: YOUR_PUBLISHABLE_KEY'

Example Response

JSON
{
  "id": "TAnpy5j1P4ZFh",
	"type": "cc_payment",
	"processor": "vantiv",
	"date": 1754337075868,
	"reference": "FQFQ-4VVR-BBBX",
	"status": "authorized",
	"from_consumer": {
		"id": "CA2N5iwQNedJs",
		"first_name": "Geezer",
		"last_name": "Paranoia",
		"phones": [
			{
				"id": "",
				"number": "+1 9495551212",
				"country_code": "1",
				"status": "",
				"priority": ""
			}
		],
		"emails": [
			{
				"id": "",
				"address": "geezer@abcdefake.com",
				"status": "",
				"priority": ""
			}
		],
		"email_verified": false,
		"platform_account_status": "none"
	},
	"to_consumer": {
		"id": "CAg1XZ8ZXd96S",
		"first_name": "Dandy",
		"last_name": "Lion",
		"emails": [
			{
				"id": "EA9MNcgiFLU8s",
				"address": "awesome-email@example.com",
				"status": "active",
				"priority": "primary"
			}
		],
		"email_verified": false,
		"platform_account_status": "none"
	},
	"from_credit_card": {
		"id": "CAgx4AqNrxJEt",
		"last4": "1111",
		"bin": "411111",
		"expiration": 1867017600000,
		"network": "visa",
		"token_type": "bolt",
		"priority": "listed",
		"display_network": "Visa",
		"icon_asset_path": "img/issuer-logos/visa.png",
		"status": "active",
		"card_type": "shopper_saved_card",
		"funded_with_crypto": false
	},
	"amount": {
		"amount": 699,
		"currency": "USD",
		"currency_symbol": "$"
	},
	"authorization": {
		"auth": "83997343162598572",
		"avs_response": "00",
		"cvv_response": "M",
		"external_transaction_id": "185715589506716",
		"reason": "none",
		"status": "succeeded"
	},
	"captures": null,
	"merchant_division": {
		"id": "{MERCHANT_DIVISION_ID}",
		"merchant_id": "{MERCHANT_ID}",
		"public_id": "P4WwM-oR233w",
		"description": "ABCDE Fake, LLC",
		"display_name": "ABCDE Fake, LLC",
		"status": "active",
		"platform": "tipser",
		"hook_url": "https://api.dev.tipser.com/v5/payments/bolt/webhooks?country=US&payment_processor=SoR",
		"hook_type": "bolt",
		"is_universal_merchant_api": true,
		"is_webhooks_v2": true,
		"shipping_url": "",
		"tax_url": "",
		"universal_merchant_api_url": "http://merchantproxy.sandbox:8000/v1/merchantproxy/cart/P4WwM-oR233w",
		"debug_url": "http://merchantproxy.sandbox:8000/v1/merchantproxy/cart/P4WwM-oR233w",
		"plugin_config_url": "http://merchantproxy.sandbox:8000/v1/merchantproxy/cart/P4WwM-oR233w",
		"product_info_url": "http://merchantproxy.sandbox:8000/v1/merchantproxy/cart/P4WwM-oR233w",
		"confirmation_redirect_url": ""
	},
	"merchant": {
		"created_at": "2025-08-04T19:25:14.097966Z",
		"description": "ABCDE Fake, LLC",
		"processor": "vantiv",
		"operational_processors": [
			{
				"processor": "vantiv",
				"status": "primary"
			}
		],
		"public_id": "THF7DjHcgSO8",
		"time_zone": "US/Pacific",
		"onboarding_status": "NEW_MERCHANT"
	},
	"transaction_properties": {
		"avs_result": "00 - zip5_match_address_match",
		"cvv_result": "M - match"
	},
	"indemnification_decision": "not_indemnified",
	"indemnification_reason": "risk_assessment_only",
	"risk_score": 0,
	"risk_review_status": "",
	"splits": [
		{
			"amount": {
				"amount": 653,
				"currency": "USD",
				"currency_symbol": "$"
			},
			"type": "net"
		},
		{
			"amount": {
				"amount": 45,
				"currency": "USD",
				"currency_symbol": "$"
			},
			"type": "processing_fee"
		},
		{
			"amount": {
				"amount": 0,
				"currency": "USD",
				"currency_symbol": "$"
			},
			"type": "bolt_fee"
		},
		{
			"amount": {
				"amount": 0,
				"currency": "USD",
				"currency_symbol": "$"
			},
			"type": "network_fee"
		},
		{
			"amount": {
				"amount": 1,
				"currency": "USD",
				"currency_symbol": "$"
			},
			"type": "platform_fee"
		},
		{
			"amount": {
				"amount": 0,
				"currency": "USD",
				"currency_symbol": "$"
			},
			"type": "virtual_terminal_fee"
		},
		{
			"amount": {
				"amount": 0,
				"currency": "USD",
				"currency_symbol": "$"
			},
			"type": "international_card_fee"
		},
		{
			"amount": {
				"amount": 0,
				"currency": "USD",
				"currency_symbol": "$"
			},
			"type": "currency_conversion_fee"
		}
	],
	"review_ticket": {
		"request_deadline": 1754625075868
	},
	"adjust_transactions": [],
	"auth_verification_status": "",
	"void_cause": "",
	"chargeback_details": {
		"reason": "",
		"reason_code": "",
		"chargeback_amt": {
			"amount": 0,
			"currency": "",
			"currency_symbol": ""
		},
		"chargeback_fee": {
			"amount": 0,
			"currency": "",
			"currency_symbol": ""
		},
		"net_amt": {
			"amount": 0,
			"currency": "",
			"currency_symbol": ""
		},
		"representment_result": ""
	},
	"order": {
		"token": "819c220124dfe16f63066f77378e3a544b42d230597eff401214627ec67e2734",
		"cart": {
			"order_reference": "9qpT4pVhkniHLzGapsAxz6",
			"display_id": "9qpT4pVhkniHLzGapsAxz6",
			"currency": {
				"currency": "USD",
				"currency_symbol": "$"
			},
			"subtotal_amount": null,
			"total_amount": {
				"amount": 699,
				"currency": "USD",
				"currency_symbol": "$"
			},
			"tax_amount": {
				"amount": 0,
				"currency": "USD",
				"currency_symbol": "$"
			},
			"discount_amount": {
				"amount": 0,
				"currency": "USD",
				"currency_symbol": "$"
			},
			"items": [
				{
					"reference": "",
					"name": "Gems Pack",
					"total_amount": {
						"amount": 699,
						"currency": "USD",
						"currency_symbol": "$"
					},
					"unit_price": {
						"amount": 699,
						"currency": "USD",
						"currency_symbol": "$"
					},
					"quantity": 1,
					"type": "physical",
					"taxable": true,
					"properties": [],
					"shipment_type": "door_delivery"
				}
			]
		},
		"external_data": {}
	},
	"refunded_amount": {
		"amount": 0,
		"currency": "USD",
		"currency_symbol": "$"
	},
	"refund_transactions": [],
	"refund_transaction_ids": [],
	"source_transaction": null,
	"timeline": [
		{
			"date": 1754337077058,
			"type": "note",
			"note": "Authorized Order",
			"consumer": {
				"id": "CAmC9JYEhZUmr",
				"first_name": "Geezer",
				"last_name": "Paranoia"
			},
			"visibility": "merchant"
		},
		{
			"date": 1754337075916,
			"type": "note",
			"note": "Created Order",
			"consumer": {
				"id": "CAmC9JYEhZUmr",
				"first_name": "Geezer",
				"last_name": "Paranoia"
			},
			"visibility": "merchant"
		}
	],
	"customer_list_status": {
		"auto_approved": false,
		"block_listed": false
	},
	"address_change_request_metadata": {
		"can_change_shipping_address": false
	}
}