Class: Increase::Models::PendingTransaction::Source::CardAuthorization

Inherits:
Internal::Type::BaseModel show all
Defined in:
lib/increase/models/pending_transaction.rb,
sig/increase/models/pending_transaction.rbs

Overview

See Also:

  • Increase::Models::PendingTransaction::Source#card_authorization

Defined Under Namespace

Modules: Actioner, Currency, Direction, ProcessingCategory, Type Classes: AdditionalAmounts, Healthcare, NetworkDetails, NetworkIdentifiers, SchemeFee, Verification

Instance Attribute Summary collapse

Class Method Summary collapse

Instance Method Summary collapse

Methods inherited from Internal::Type::BaseModel

==, #==, #[], coerce, #deconstruct_keys, #deep_to_h, dump, fields, hash, #hash, inherited, inspect, #inspect, known_fields, optional, recursively_to_h, required, #to_h, #to_json, #to_s, to_sorbet_type, #to_yaml

Methods included from Internal::Type::Converter

#coerce, coerce, #dump, dump, inspect, #inspect, meta_info, new_coerce_state, type_info

Methods included from Internal::Util::SorbetRuntimeSupport

#const_missing, #define_sorbet_constant!, #sorbet_constant_defined?, #to_sorbet_type, to_sorbet_type

Constructor Details

#initialize(authorization_identification_response:, retrieval_reference_number:, trace_number:, transaction_id:) ⇒ Object

Network-specific identifiers for a specific request or transaction.

Parameters:

  • The randomly generated 6-character Authorization Identification Response code sent back to the acquirer in an approved response.

  • A life-cycle identifier used across e.g., an authorization and a reversal. Expected to be unique per acquirer within a window of time. For some card networks the retrieval reference number includes the trace counter.

  • A counter used to verify an individual authorization. Expected to be unique per acquirer within a window of time.

  • A globally unique transaction identifier provided by the card network, used across multiple life-cycle requests.




# File 'lib/increase/models/pending_transaction.rb', line 1009

Instance Attribute Details

#actioner ⇒ Symbol, Increase::Models::PendingTransaction::Source::CardAuthorization::Actioner

Whether this authorization was approved by Increase, the card network through stand-in processing, or the user through a real-time decision.

Parameters:

Returns:



804
 
# File 'lib/increase/models/pending_transaction.rb', line 804

required :actioner, enum: -> { Increase::PendingTransaction::Source::CardAuthorization::Actioner }

#additional_amounts ⇒ Increase::Models::PendingTransaction::Source::CardAuthorization::AdditionalAmounts

Additional amounts associated with the card authorization, such as ATM surcharge fees. These are usually a subset of the amount field and are used to provide more detailed information about the transaction.

Parameters:

Returns:



812
813
 
# File 'lib/increase/models/pending_transaction.rb', line 812

required :additional_amounts,
-> { Increase::PendingTransaction::Source::CardAuthorization::AdditionalAmounts }

#amount ⇒ Integer

The pending amount in the minor unit of the transaction's currency. For dollars, for example, this is cents.

Parameters:

Returns:



820
 
# File 'lib/increase/models/pending_transaction.rb', line 820

required :amount, Integer

#card_payment_id ⇒ String

The ID of the Card Payment this transaction belongs to.

Parameters:

Returns:



826
 
# File 'lib/increase/models/pending_transaction.rb', line 826

required :card_payment_id, String

#currency ⇒ Symbol, Increase::Models::PendingTransaction::Source::CardAuthorization::Currency

The ISO 4217 code for the transaction's currency.

Parameters:

Returns:



833
 
# File 'lib/increase/models/pending_transaction.rb', line 833

required :currency, enum: -> { Increase::PendingTransaction::Source::CardAuthorization::Currency }

#digital_wallet_token_id ⇒ String?

If the authorization was made via a Digital Wallet Token (such as an Apple Pay purchase), the identifier of the token that was used.

Parameters:

Returns:



840
 
# File 'lib/increase/models/pending_transaction.rb', line 840

required :digital_wallet_token_id, String, nil?: true

#direction ⇒ Symbol, Increase::Models::PendingTransaction::Source::CardAuthorization::Direction

The direction describes the direction the funds will move, either from the cardholder to the merchant or from the merchant to the cardholder.

Parameters:

Returns:



847
 
# File 'lib/increase/models/pending_transaction.rb', line 847

required :direction, enum: -> { Increase::PendingTransaction::Source::CardAuthorization::Direction }

#expires_at ⇒ Time

The ISO 8601 time at which this authorization will expire and the pending transaction will be released.

Parameters:

Returns:



854
 
# File 'lib/increase/models/pending_transaction.rb', line 854

required :expires_at, Time

#healthcare ⇒ Increase::Models::PendingTransaction::Source::CardAuthorization::Healthcare?

The healthcare-related fields for this authorization. Only present for specific programs.

Parameters:

Returns:



861
862
863
 
# File 'lib/increase/models/pending_transaction.rb', line 861

required :healthcare,
-> { Increase::PendingTransaction::Source::CardAuthorization::Healthcare },
nil?: true

#id ⇒ String

The Card Authorization identifier.

Parameters:

Returns:



797
 
# File 'lib/increase/models/pending_transaction.rb', line 797

required :id, String

#merchant_acceptor_id ⇒ String

The merchant identifier (commonly abbreviated as MID) of the merchant the card is transacting with.

Parameters:

Returns:



870
 
# File 'lib/increase/models/pending_transaction.rb', line 870

required :merchant_acceptor_id, String

#merchant_category_code ⇒ String

The Merchant Category Code (commonly abbreviated as MCC) of the merchant the card is transacting with.

Parameters:

Returns:



877
 
# File 'lib/increase/models/pending_transaction.rb', line 877

required :merchant_category_code, String

#merchant_city ⇒ String?

The city the merchant resides in.

Parameters:

Returns:



883
 
# File 'lib/increase/models/pending_transaction.rb', line 883

required :merchant_city, String, nil?: true

#merchant_country ⇒ String

The country the merchant resides in.

Parameters:

Returns:



889
 
# File 'lib/increase/models/pending_transaction.rb', line 889

required :merchant_country, String

#merchant_descriptor ⇒ String

The merchant descriptor of the merchant the card is transacting with.

Parameters:

Returns:



895
 
# File 'lib/increase/models/pending_transaction.rb', line 895

required :merchant_descriptor, String

#merchant_postal_code ⇒ String?

The merchant's postal code. For US merchants this is either a 5-digit or 9-digit ZIP code, where the first 5 and last 4 are separated by a dash.

Parameters:

Returns:



902
 
# File 'lib/increase/models/pending_transaction.rb', line 902

required :merchant_postal_code, String, nil?: true

#merchant_state ⇒ String?

The state the merchant resides in.

Parameters:

Returns:



908
 
# File 'lib/increase/models/pending_transaction.rb', line 908

required :merchant_state, String, nil?: true

#network_details ⇒ Increase::Models::PendingTransaction::Source::CardAuthorization::NetworkDetails

Fields specific to the network.

Parameters:

Returns:



914
 
# File 'lib/increase/models/pending_transaction.rb', line 914

required :network_details, -> { Increase::PendingTransaction::Source::CardAuthorization::NetworkDetails }

#network_identifiers ⇒ Increase::Models::PendingTransaction::Source::CardAuthorization::NetworkIdentifiers

Network-specific identifiers for a specific request or transaction.

Parameters:

Returns:



920
921
 
# File 'lib/increase/models/pending_transaction.rb', line 920

required :network_identifiers,
-> { Increase::PendingTransaction::Source::CardAuthorization::NetworkIdentifiers }

#network_risk_score ⇒ Integer?

The risk score generated by the card network. For Visa this is the Visa Advanced Authorization risk score, from 0 to 99, where 99 is the riskiest. For Pulse the score is from 0 to 999, where 999 is the riskiest.

Parameters:

Returns:



929
 
# File 'lib/increase/models/pending_transaction.rb', line 929

required :network_risk_score, Integer, nil?: true

#original_card_payment_id ⇒ String?

The ID of the Card Payment containing the original authorization or card validation this transaction references. For a merchant-initiated transaction, this is the Card Payment from when the card was first stored, which is typically where the CVV2 was verified. The reference this is derived from is supplied by the merchant or their acquirer, so it is not guaranteed to be present.

Parameters:

Returns:



939
 
# File 'lib/increase/models/pending_transaction.rb', line 939

required :original_card_payment_id, String, nil?: true

#pending_transaction_id ⇒ String?

The identifier of the Pending Transaction associated with this Transaction.

Parameters:

Returns:



945
 
# File 'lib/increase/models/pending_transaction.rb', line 945

required :pending_transaction_id, String, nil?: true

#physical_card_id ⇒ String?

If the authorization was made in-person with a physical card, the Physical Card that was used.

Parameters:

Returns:



952
 
# File 'lib/increase/models/pending_transaction.rb', line 952

required :physical_card_id, String, nil?: true

#presentment_amount ⇒ Integer

The pending amount in the minor unit of the transaction's presentment currency.

Parameters:

Returns:



958
 
# File 'lib/increase/models/pending_transaction.rb', line 958

required :presentment_amount, Integer

#presentment_currency ⇒ String

The ISO 4217 code for the transaction's presentment currency.

Parameters:

Returns:



965
 
# File 'lib/increase/models/pending_transaction.rb', line 965

required :presentment_currency, String

#processing_category ⇒ Symbol, Increase::Models::PendingTransaction::Source::CardAuthorization::ProcessingCategory

The processing category describes the intent behind the authorization, such as whether it was used for bill payments or an automatic fuel dispenser.

Parameters:

Returns:



972
973
 
# File 'lib/increase/models/pending_transaction.rb', line 972

required :processing_category,
enum: -> { Increase::PendingTransaction::Source::CardAuthorization::ProcessingCategory }

#real_time_decision_id ⇒ String?

The identifier of the Real-Time Decision sent to approve or decline this transaction.

Parameters:

Returns:



980
 
# File 'lib/increase/models/pending_transaction.rb', line 980

required :real_time_decision_id, String, nil?: true

#scheme_fees ⇒ Array<Increase::Models::PendingTransaction::Source::CardAuthorization::SchemeFee>

The scheme fees associated with this card authorization.

Parameters:

Returns:



986
987
 
# File 'lib/increase/models/pending_transaction.rb', line 986

required :scheme_fees,
-> { Increase::Internal::Type::ArrayOf[Increase::PendingTransaction::Source::CardAuthorization::SchemeFee] }

#terminal_id ⇒ String?

The terminal identifier (commonly abbreviated as TID) of the terminal the card is transacting with.

Parameters:

Returns:



994
 
# File 'lib/increase/models/pending_transaction.rb', line 994

required :terminal_id, String, nil?: true

#type ⇒ Symbol, Increase::Models::PendingTransaction::Source::CardAuthorization::Type

A constant representing the object's type. For this resource it will always be card_authorization.

Parameters:

Returns:



1001
 
# File 'lib/increase/models/pending_transaction.rb', line 1001

required :type, enum: -> { Increase::PendingTransaction::Source::CardAuthorization::Type }

#verification ⇒ Increase::Models::PendingTransaction::Source::CardAuthorization::Verification

Fields related to verification of cardholder-provided values.

Parameters:

Returns:



1007
 
# File 'lib/increase/models/pending_transaction.rb', line 1007

required :verification, -> { Increase::PendingTransaction::Source::CardAuthorization::Verification }

Class Method Details

.values ⇒ Array<Symbol>

Returns:




# File 'lib/increase/models/pending_transaction.rb', line 1142

Instance Method Details

#to_hash ⇒ {

Returns:



599
 
# File 'sig/increase/models/pending_transaction.rbs', line 599

def to_hash: -> {