Transactions

A transaction is a record of a payment operation, including authorizations, captures, refunds, and voids.

What is a Transaction?

Every time a payment is processed through Flintn, a transaction record is created. Transactions contain:

• Payment details - Amount, currency, status

• Customer information - Email, name, billing address

• Card data - Last 4 digits, brand, expiry, BIN data

• Risk information - AVS result, CVV result, fraud score

• Processing details - Processor, fees, timestamps

Transaction Statuses

Transactions move through these states:

PENDING -> AUTHORIZED -> CAPTURED -> SETTLED
                      -> VOIDED
           SETTLED -> REFUNDED
                   -> PARTIALLY_REFUNDED

Status	Description
PENDING	Transaction is being processed
AUTHORIZED	Funds are held but not captured
CAPTURED	Funds have been captured for settlement
SETTLED	Funds have been transferred
VOIDED	Authorization was cancelled (before capture)
REFUNDED	Full amount returned to customer
PARTIALLY_REFUNDED	Partial amount returned to customer
DECLINED	Transaction was declined
FAILED	Transaction failed to process

Transaction Data

Basic Information

Field	Description
id	Unique transaction identifier
amount	Transaction amount in minor units (cents)
currency	Three-letter currency code
status	Current transaction status
created_at	When the transaction was created

Customer Information

Field	Description
customer_id	Your customer identifier
customer_email	Customer email address
customer_name	Customer full name
billing_address	Customer billing address

Card Information

Field	Description
card_last4	Last 4 digits of card number
card_brand	Card brand (Visa, Mastercard, etc.)
card_exp_month	Card expiration month
card_exp_year	Card expiration year
card_bin	Bank Identification Number (first 6 digits)

Risk Information

Field	Description
avs_result	Address Verification System result
cvv_result	CVV verification result
fraud_score	Risk score from fraud detection

Available Actions

Action	Description	Valid From Status
Capture	Convert authorization to charge	AUTHORIZED
Void	Cancel an authorization	AUTHORIZED
Refund	Return funds to customer	SETTLED
Partial Refund	Return partial amount	SETTLED

See Transaction Actions for details.

Accessing Transactions

You can view transactions through:

• Dashboard - Visual interface for viewing and searching transactions

• API - Programmatic access to transaction data

Webhook Events

Monitor transactions in real-time with webhooks:

Event	Description
TRANSACTION_PENDING	Transaction is being processed
TRANSACTION_AUTHORIZED	Authorization successful
TRANSACTION_DECLINED	Transaction was declined
TRANSACTION_FAILED	Transaction processing failed
TRANSACTION_VOIDED	Transaction was voided
TRANSACTION_SETTLED	Funds have been settled
TRANSACTION_REFUNDED	Full refund processed
TRANSACTION_PARTIALLY_REFUNDED	Partial refund processed

See Webhook Events for payload details.

Next Steps

• Dashboard View - Navigate the transaction dashboard

• API Access - Query transactions programmatically

• Actions - Capture, void, and refund transactions