Sign in

v2

latestOpenAPI 3.0.02026-07-3139594346.4 KB
Transactions

Review Transaction

This endpoint is used to manually approve or reject orders for a specified transaction.

post/v1/merchant/transactions/review

Headers

Idempotency-Keystring

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

Request body

decision'approve' | 'reject' required
transaction_referencestring required

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

Example request

{
  "transaction_reference": "LBLJ-TWW7-R9VC"
}

Response

Transaction Details Received

dateinteger

Transaction date. Nullable for Transactions Details.

idstring

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

indemnification_decision'unknown' | 'indemnified' | 'not_indemnified'

Describes whether the transaction is indemnified by Bolt for fraud.

indemnification_reason'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'

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

last4string

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

last_viewed_utcnumber
merchant_order_numberstring
processor'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'

The processor used. Nullable for Transactions Details.

referencestring

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

risk_review_status'unknown' | 'needs_review' | 'reviewed'

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

risk_scoreinteger
status'in_progress' | 'completed' | 'cancelled' | 'failed' | 'pending' | 'created' | 'authorized' | 'rejected_reversible' | 'rejected_irreversible'

The transaction's status.

transaction_propertiesobject
type'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'

The type of transaction.

view_status'not_viewed' | 'viewed' | 'viewing'
auth_verification_status'' | 'new'
authorization_idstring
refund_transaction_idsstring[]
void_cause'merchant_action' | 'shopify_sync' | 'paypal_sync' | 'amazon_pay_sync' | 'irreversible_reject' | 'auth_expire' | 'auth_verification_expired' | 'payment_method_updater'

Determines why the transaction was voided.