POST
Review Transaction

Authorizations

X-API-Key
string
header
required

Admins and Developers can obtain their Bolt API key from the Bolt Merchant Dashboard.

Headers

Idempotency-Key
string

A key created by merchants that ensures POST and PATCH requests are only performed once. Read more about Idempotent Requests here.

Body

application/json

Review a Transaction

decision
enum<string>
required
Available options:
approve,
reject
transaction_reference
string
required

The transaction's 12-digit Bolt reference ID. Nullable for Transactions Details.

Required string length: 12
Example:

"LBLJ-TWW7-R9VC"

Response

Transaction Details Received

amount
object
authorization
object
capture
object

Deprecated. Use captures.

captures
object[]
credit
object
date
integer

Transaction date. Nullable for Transactions Details.

Example:

1615407159447

from_consumer
object
from_credit_card
object

Contains details about the credit card transaction.

id
string

The unique ID associated with the transaction. Nullable for Transactions Details.

Example:

"T1c3p4yBuVYJ9"

indemnification_decision
enum<string>

Describes whether the transaction is indemnified by Bolt for fraud.

Available options:
unknown,
indemnified,
not_indemnified
Example:

"indemnified"

indemnification_reason
enum<string>

Describes the reason that the transaction is or is not indemnified by Bolt for fraud.

Available options:
unknown,
checkout,
virtual_terminal,
merchant_back_office,
merchant_force_approved,
reversibly_rejected,
irreversibly_rejected,
risk_engine_approved,
analyst_approved,
auth_verification,
paypal,
afterpay,
direct_payments,
whitelist,
external_review,
affirm,
merchant_ip_address,
amazon_pay,
apple_pay,
phone_order,
klarna,
cardholder_authentication,
address_change_rejected,
indemnify_direct_payments,
indemnify_virtual_terminal,
membership_subscription,
embedded_guest_checkout,
risk_assessment_only,
sezzle,
credova,
subscription,
indemnify_apm_transaction
Example:

"merchant_force_approved"

last4
string

The card's last 4 digits. Nullable for Transactions Details.

Required string length: 4
Example:

"4021"

last_viewed_utc
number<int64>
merchant_division
object
merchant_order_number
string
order_decision
object
processor
enum<string>

The processor used. Nullable for Transactions Details.

Available options:
adyen_gateway,
adyen_payfac,
affirm,
afterpay,
alliance_data,
amazon_pay,
authorize_net,
braintree,
checkout_com,
cybersource,
first_data,
klarna,
nmi,
orbital,
paypal,
radial,
radial_klarna,
radial_paypal,
rocketgate,
sezzle,
shopify_payments,
stripe,
vantiv
Example:

"adyen_gateway"

reference
string

The transaction's 12-digit Bolt reference ID. Nullable for Transactions Details.

Required string length: 12
Example:

"LBLJ-TWW7-R9VC"

review_ticket
object
risk_insights
object
risk_review_status
enum<string>

Describes the current Risk Review status. A transaction could be unreviewed, reviewed, or pending manual review by the Bolt team.

Available options:
unknown,
needs_review,
reviewed
Example:

"reviewed"

risk_score
integer<int64>
splits
object[]
status
enum<string>

The transaction's status.

Available options:
in_progress,
completed,
cancelled,
failed,
pending,
created,
authorized,
rejected_reversible,
rejected_irreversible
Example:

"cancelled"

to_consumer
object
to_credit_card
object

Contains details about the credit card transaction.

transaction_properties
object
type
enum<string>

The type of transaction.

Available options:
cc_payment,
cc_credit,
funding_transfer,
processing_fee_transfer,
reserve_transfer,
float_transfer,
merchant_credit,
merchant_debit,
funding_withdrawal,
processing_fee_withdrawal,
zero_amount,
bolt_fee_transfer,
bolt_fee_withdrawal,
bank_account_verification,
authorization_verification,
paypal_payment,
paypal_refund,
apm_payment,
apm_refund,
zero_amount_verification
Example:

"cc_payment"

void
object
view_status
enum<string>
Available options:
not_viewed,
viewed,
viewing
address_change_request_metadata
object
adjust_transactions
object[]
auth_verification_status
enum<string>
Available options:
,
new
Example:

"new"

authorization_id
string
chargeback_details
object
custom_fields
object[]
customer_list_status
object
manual_disputes
object[]
order
object
refund_transaction_ids
string[]
refund_transactions
object[]

Nullable for Transactions Details.

refunded_amount
object
source_transaction
object
timeline
object[]
transaction_rejection_details
object
void_cause
enum<string>

Determines why the transaction was voided.

Available options:
merchant_action,
shopify_sync,
paypal_sync,
amazon_pay_sync,
irreversible_reject,
auth_expire,
auth_verification_expired,
payment_method_updater
Example:

"irreversible_reject"