Payment: Get Payments by Fingerprint

Related API Reference

🔗

API Reference: Get Payments by Fingerprint

Overview

• This operation retrieves all payments associated with a specific payment instrument fingerprint - a unique identifier derived from a payment method's details (e.g. card number, wallet ID, bank account, etc.).
• The fingerprint acts as a consistent reference to the same underlying payment instrument, even across different transactions or sessions.
• Each retrieved payment transaction will include the payment's current status, the details, and any relevant reference data.
• Use this feature if you need to extract all the payment transactions with a specific payment instrument fingerprint

How It Works

Payment Status Model

Download high-resolution Payment Status Model

The following table summarizes the statuses a payment may go through:

Status	Description
ACCEPTED	You submitted a payment request. We verified and accept it, and it has been queued for sending for authorization or capturing (depending on your settings) on our side.
AUTHORIZATION_REQUESTED	We forwarded your authorisation request to the designated payment method (e.g. bank or wallet). It is now being processed externally; final status pending.
AUTHORIZED	The payment method has authorised the requested amount on the payer’s account. Following authorisation, the funds may either be captured through a capture request or released via a cancellation request.
CAPTURE_ REQUEST_ACCEPTED	After successful authorization, you submitted a capture request. We verified and accept it, and it has been queued for processing.
CAPTURE_ REQUESTED	We forwarded your capturing request to the designated payment method (e.g. bank or wallet). It is now being processed externally; final status pending.
CAPTURED	The payment method has captured the authorized amount on the payer’s account.
DECLINED	The payment may be declined during authorisation (e.g. insufficient funds or account issues) or during capture (e.g. expired authorisation or policy violations).
EXPIRED	The authorisation period has expired — the time window between authorisation and capture or cancellation elapsed without action.
CANCELLATION_ REQUEST_ACEPTED	After successful authorization, you submitted a cancellation request. We verified and accept it, and it has been queued for processing
CANCELLATION_ REQUESTED	We forwarded your cancellation request to the designated payment method (e.g. bank or wallet). It is now being processed externally; final status pending.
CANCELLED	The payment method has released the authorized amount on the payer’s account and cancelled the payment.
ERROR	The payment failed due to a technical issue; a retry may be required.

When to Use

• Identify all payments made with the same card, wallet, or bank account.
• Detect repeated use of a payment instrument across different users or merchants.
• Investigate suspicious activity or perform fraud analysis.
• Audit and group transactions linked to a specific payment method.
• Support customer service by reviewing all transactions tied to a specific payment instrument.