AI agents: this site is available as Markdown at /llms.txt. Each page has a Markdown version at its URL with a .md suffix, and the full API is described in /api/v3/openapi.json.

Verify a transaction by reference

Verify a transaction with the unique reference you set when you created it (tx_ref).

Last updated 13 September 2026

get

https://api.flutterwave.com/v3/transactions/verify_by_reference

authorization string required

Pass your secret key as a bearer token in the request header to authorize this call

FILL IN ALL REQUIRED FIELDS

tx_ref string
The unique reference you set when you created the transaction.

FILL IN ALL REQUIRED FIELDS

status string

message string

data object

FILL IN ALL REQUIRED FIELDS

id integer

tx_ref string

flw_ref string

device_fingerprint string

amount integer

currency string

charged_amount integer

app_fee integer

merchant_fee integer

processor_response string

auth_model string

ip string

narration string

status string

payment_type string

created_at string

account_id integer

card object

FILL IN ALL REQUIRED FIELDS

first_6digits string

last_4digits string

issuer string

country string

type string

token string

expiry string

meta string

amount_settled integer

customer object

FILL IN ALL REQUIRED FIELDS

id integer

name string

phone_number string

email string

created_at string

Shell

1
1


FL.AI

Answers from the Flutterwave docs

Hi, I’m FL.AI

Ask anything about Flutterwave’s APIs, guides and coverage.

FL.AI can make mistakes. Check important details in the docs.

Get API Keys