Skip to main content

Get authorization by reference number

Gets complete authorization data by reference number for final state transactions including payment intent information.

Path Parameters
referenceNumber string REQUIRED

Authorization reference number

Responses
200

Successful response

Schema OPTIONAL
reference_number string OPTIONAL

Unique reference number of the authorization

type string OPTIONAL

Type of authorization

status string OPTIONAL

Current status of the authorization

amount number OPTIONAL

Transaction amount

date_time string OPTIONAL

Date and time of the authorization

currency string OPTIONAL

Currency code

entry_mode object OPTIONAL

Entry mode information for the transaction

source string OPTIONAL

Source of the transaction

reader object OPTIONAL

Reader device information

type string OPTIONAL

Type of reader device

serial string OPTIONAL

Serial number of the reader

model string OPTIONAL

Model of the reader

firmware string OPTIONAL

Firmware version

read_mode string OPTIONAL

Reading mode used

pin boolean OPTIONAL

Whether PIN was used

hex_sign string OPTIONAL

Hexadecimal signature

arqc string OPTIONAL

Application Request Cryptogram

aid string OPTIONAL

Application Identifier

contactless boolean OPTIONAL

Whether contactless was used

fallback boolean OPTIONAL

Whether fallback was used

payment_method object OPTIONAL

Payment method details

type string OPTIONAL

Type of payment method

card object OPTIONAL

Card information

type string OPTIONAL

Type of card

brand string OPTIONAL

Card brand

name string OPTIONAL

Card name

account_type string OPTIONAL

Account type

obfuscated_pan string OPTIONAL

Obfuscated PAN

fingerprint string OPTIONAL

Card fingerprint identifier

holder object OPTIONAL

Card holder information

authentication_mode string OPTIONAL

Authentication mode used

name string OPTIONAL

Card holder name

surname string OPTIONAL

Card holder surname

full_name string OPTIONAL

Card holder full name

app_label string OPTIONAL

Application label

merchant object OPTIONAL

Merchant information

id string OPTIONAL

Merchant identifier

terminal_id string OPTIONAL

Terminal identifier

identification object OPTIONAL

Merchant identification information

type string OPTIONAL

Type of identification

number string OPTIONAL

Identification number

address object OPTIONAL

Merchant address information

line1 string OPTIONAL

Address line 1

line2 string OPTIONAL

Address line 2

city string OPTIONAL

City

country_code string OPTIONAL

Country code

postal_code string OPTIONAL

Postal code

state string OPTIONAL

State or province

merchant object OPTIONAL
id string OPTIONAL
terminal_id string OPTIONAL
merchant_category_code integer OPTIONAL

Merchant category code

legal_name string OPTIONAL

Legal name of the merchant

trade_name string OPTIONAL

Trade name of the merchant

phone_number string OPTIONAL

Merchant phone number

tracking object OPTIONAL

Transaction tracking information

ticket_number string OPTIONAL

Ticket number

location object OPTIONAL

Geographic location information

latitude number OPTIONAL

Latitude coordinate

longitude number OPTIONAL

Longitude coordinate

ip string OPTIONAL

IP address

user_agent string OPTIONAL

User agent string

processor_result object OPTIONAL

Processor result information

date string OPTIONAL

Processing date

authorization_code string OPTIONAL

Authorization code from processor

processor_reference_number string OPTIONAL

Processor reference number

result object OPTIONAL

Processor error details

code string OPTIONAL

Error code

message string OPTIONAL

Error message

description string OPTIONAL

Error description

payment_plan object OPTIONAL

Payment plan information

installment_quantity integer OPTIONAL

Number of installments

installment_id integer OPTIONAL

Installment identifier

payment_intent object OPTIONAL

Payment intent data for authorization response

uuid string OPTIONAL

Payment intent UUID

state string OPTIONAL

Current state of the payment intent

autorizations object[] OPTIONAL

List of related authorizations

reference_number string OPTIONAL

Reference number of the authorization

type string OPTIONAL

Type of authorization

status string OPTIONAL

Status of the authorization

404

Error response

Schema OPTIONAL
app_name string OPTIONAL
app_version string OPTIONAL
status_code number OPTIONAL
message string OPTIONAL
message_code string OPTIONAL
error_code string OPTIONAL
validations object[] OPTIONAL
property_name string OPTIONAL
error_message string OPTIONAL
error_code string OPTIONAL
attempted_value string OPTIONAL