Class: Recurly::Resources::Transaction

Inherits:
Recurly::Resource show all
Defined in:
lib/recurly/resources/transaction.rb

Instance Attribute Summary collapse

Attributes inherited from Recurly::Resource

#attributes

Method Summary

Methods inherited from Recurly::Resource

#==, #get_response, #inspect, #requires_client?, #to_json, #to_s

Methods included from Schema::SchemaFactory

#schema

Methods included from Schema::ResourceCaster

#cast

Methods included from Schema::SchemaValidator

#get_did_you_mean, #validate!, #validate_attribute!

Instance Attribute Details

#accountAccountMini

Returns Account mini details.

Returns:



11
# File 'lib/recurly/resources/transaction.rb', line 11

define_attribute :account, :AccountMini

#action_resultHash

Returns Action result params to be used in Recurly-JS to complete a payment when using asynchronous payment methods, e.g., Boleto, iDEAL and Sofort.

Returns:

  • (Hash)

    Action result params to be used in Recurly-JS to complete a payment when using asynchronous payment methods, e.g., Boleto, iDEAL and Sofort.



15
# File 'lib/recurly/resources/transaction.rb', line 15

define_attribute :action_result, Hash

#amountFloat

Returns Total transaction amount sent to the payment gateway.

Returns:

  • (Float)

    Total transaction amount sent to the payment gateway.



19
# File 'lib/recurly/resources/transaction.rb', line 19

define_attribute :amount, Float

#avs_checkString

Returns When processed, result from checking the overall AVS on the transaction.

Returns:

  • (String)

    When processed, result from checking the overall AVS on the transaction.



23
# File 'lib/recurly/resources/transaction.rb', line 23

define_attribute :avs_check, String

#backup_payment_method_usedBoolean

Returns Indicates if the transaction was completed using a backup payment.

Returns:

  • (Boolean)

    Indicates if the transaction was completed using a backup payment



27
# File 'lib/recurly/resources/transaction.rb', line 27

define_attribute :backup_payment_method_used, :Boolean

#billing_addressAddressWithName

Returns:



31
# File 'lib/recurly/resources/transaction.rb', line 31

define_attribute :billing_address, :AddressWithName

#collected_atDateTime

Returns Collected at, or if not collected yet, the time the transaction was created.

Returns:

  • (DateTime)

    Collected at, or if not collected yet, the time the transaction was created.



35
# File 'lib/recurly/resources/transaction.rb', line 35

define_attribute :collected_at, DateTime

#collection_methodString

Returns The method by which the payment was collected.

Returns:

  • (String)

    The method by which the payment was collected.



39
# File 'lib/recurly/resources/transaction.rb', line 39

define_attribute :collection_method, String

#created_atDateTime

Returns Created at.

Returns:

  • (DateTime)

    Created at



43
# File 'lib/recurly/resources/transaction.rb', line 43

define_attribute :created_at, DateTime

#currencyString

Returns 3-letter ISO 4217 currency code.

Returns:

  • (String)

    3-letter ISO 4217 currency code.



47
# File 'lib/recurly/resources/transaction.rb', line 47

define_attribute :currency, String

#customer_messageString

Returns For declined (`success=false`) transactions, the message displayed to the customer.

Returns:

  • (String)

    For declined (`success=false`) transactions, the message displayed to the customer.



51
# File 'lib/recurly/resources/transaction.rb', line 51

define_attribute :customer_message, String

#customer_message_localeString

Returns Language code for the message.

Returns:

  • (String)

    Language code for the message



55
# File 'lib/recurly/resources/transaction.rb', line 55

define_attribute :customer_message_locale, String

#cvv_checkString

Returns When processed, result from checking the CVV/CVC value on the transaction.

Returns:

  • (String)

    When processed, result from checking the CVV/CVC value on the transaction.



59
# File 'lib/recurly/resources/transaction.rb', line 59

define_attribute :cvv_check, String

#fraud_infoTransactionFraudInfo

Returns Fraud information.

Returns:



63
# File 'lib/recurly/resources/transaction.rb', line 63

define_attribute :fraud_info, :TransactionFraudInfo

#gateway_approval_codeString

Returns Transaction approval code from the payment gateway.

Returns:

  • (String)

    Transaction approval code from the payment gateway.



67
# File 'lib/recurly/resources/transaction.rb', line 67

define_attribute :gateway_approval_code, String

#gateway_messageString

Returns Transaction message from the payment gateway.

Returns:

  • (String)

    Transaction message from the payment gateway.



71
# File 'lib/recurly/resources/transaction.rb', line 71

define_attribute :gateway_message, String

#gateway_referenceString

Returns Transaction reference number from the payment gateway.

Returns:

  • (String)

    Transaction reference number from the payment gateway.



75
# File 'lib/recurly/resources/transaction.rb', line 75

define_attribute :gateway_reference, String

#gateway_response_codeString

Returns For declined transactions (`success=false`), this field lists the gateway error code.

Returns:

  • (String)

    For declined transactions (`success=false`), this field lists the gateway error code.



79
# File 'lib/recurly/resources/transaction.rb', line 79

define_attribute :gateway_response_code, String

#gateway_response_timeFloat

Returns Time, in seconds, for gateway to process the transaction.

Returns:

  • (Float)

    Time, in seconds, for gateway to process the transaction.



83
# File 'lib/recurly/resources/transaction.rb', line 83

define_attribute :gateway_response_time, Float

#gateway_response_valuesHash

Returns The values in this field will vary from gateway to gateway.

Returns:

  • (Hash)

    The values in this field will vary from gateway to gateway.



87
# File 'lib/recurly/resources/transaction.rb', line 87

define_attribute :gateway_response_values, Hash

#idString

Returns Transaction ID.

Returns:

  • (String)

    Transaction ID



91
# File 'lib/recurly/resources/transaction.rb', line 91

define_attribute :id, String

#invoiceInvoiceMini

Returns Invoice mini details.

Returns:



95
# File 'lib/recurly/resources/transaction.rb', line 95

define_attribute :invoice, :InvoiceMini

#ip_address_countryString

Returns Origin IP address country, 2-letter ISO 3166-1 alpha-2 code, if known by Recurly.

Returns:

  • (String)

    Origin IP address country, 2-letter ISO 3166-1 alpha-2 code, if known by Recurly.



99
# File 'lib/recurly/resources/transaction.rb', line 99

define_attribute :ip_address_country, String

#ip_address_v4String

Returns IP address provided when the billing information was collected: - When the customer enters billing information into the Recurly.js or Hosted Payment Pages, Recurly records the IP address. - When the merchant enters billing information using the API, the merchant may provide an IP address. - When the merchant enters billing information using the UI, no IP address is recorded.

Returns:

  • (String)

    IP address provided when the billing information was collected: - When the customer enters billing information into the Recurly.js or Hosted Payment Pages, Recurly records the IP address. - When the merchant enters billing information using the API, the merchant may provide an IP address. - When the merchant enters billing information using the UI, no IP address is recorded.



103
# File 'lib/recurly/resources/transaction.rb', line 103

define_attribute :ip_address_v4, String

#objectString

Returns Object type.

Returns:

  • (String)

    Object type



107
# File 'lib/recurly/resources/transaction.rb', line 107

define_attribute :object, String

#originString

Returns Describes how the transaction was triggered.

Returns:

  • (String)

    Describes how the transaction was triggered.



111
# File 'lib/recurly/resources/transaction.rb', line 111

define_attribute :origin, String

#original_transaction_idString

Returns If this transaction is a refund (`type=refund`), this will be the ID of the original transaction on the invoice being refunded.

Returns:

  • (String)

    If this transaction is a refund (`type=refund`), this will be the ID of the original transaction on the invoice being refunded.



115
# File 'lib/recurly/resources/transaction.rb', line 115

define_attribute :original_transaction_id, String

#payment_gatewayTransactionPaymentGateway



119
# File 'lib/recurly/resources/transaction.rb', line 119

define_attribute :payment_gateway, :TransactionPaymentGateway

#payment_methodPaymentMethod

Returns:



123
# File 'lib/recurly/resources/transaction.rb', line 123

define_attribute :payment_method, :PaymentMethod

#refundedBoolean

Returns Indicates if part or all of this transaction was refunded.

Returns:

  • (Boolean)

    Indicates if part or all of this transaction was refunded.



127
# File 'lib/recurly/resources/transaction.rb', line 127

define_attribute :refunded, :Boolean

#statusString

Returns The current transaction status. Note that the status may change, e.g. a `pending` transaction may become `declined` or `success` may later become `void`.

Returns:

  • (String)

    The current transaction status. Note that the status may change, e.g. a `pending` transaction may become `declined` or `success` may later become `void`.



131
# File 'lib/recurly/resources/transaction.rb', line 131

define_attribute :status, String

#status_codeString

Returns Status code.

Returns:

  • (String)

    Status code



135
# File 'lib/recurly/resources/transaction.rb', line 135

define_attribute :status_code, String

#status_messageString

Returns For declined (`success=false`) transactions, the message displayed to the merchant.

Returns:

  • (String)

    For declined (`success=false`) transactions, the message displayed to the merchant.



139
# File 'lib/recurly/resources/transaction.rb', line 139

define_attribute :status_message, String

#subscription_idsArray[String]

Returns If the transaction is charging or refunding for one or more subscriptions, these are their IDs.

Returns:

  • (Array[String])

    If the transaction is charging or refunding for one or more subscriptions, these are their IDs.



143
# File 'lib/recurly/resources/transaction.rb', line 143

define_attribute :subscription_ids, Array, { :item_type => String }

#successBoolean

Returns Did this transaction complete successfully?.

Returns:

  • (Boolean)

    Did this transaction complete successfully?



147
# File 'lib/recurly/resources/transaction.rb', line 147

define_attribute :success, :Boolean

#typeString

Returns - `authorization` – verifies billing information and places a hold on money in the customer's account. - `capture` – captures funds held by an authorization and completes a purchase. - `purchase` – combines the authorization and capture in one transaction. - `refund` – returns all or a portion of the money collected in a previous transaction to the customer. - `verify` – a $0 or $1 transaction used to verify billing information which is immediately voided.

Returns:

  • (String)
    • `authorization` – verifies billing information and places a hold on money in the customer's account. - `capture` – captures funds held by an authorization and completes a purchase. - `purchase` – combines the authorization and capture in one transaction. - `refund` – returns all or a portion of the money collected in a previous transaction to the customer. - `verify` – a $0 or $1 transaction used to verify billing information which is immediately voided.



151
# File 'lib/recurly/resources/transaction.rb', line 151

define_attribute :type, String

#updated_atDateTime

Returns Updated at.

Returns:

  • (DateTime)

    Updated at



155
# File 'lib/recurly/resources/transaction.rb', line 155

define_attribute :updated_at, DateTime

#uuidString

Returns The UUID is useful for matching data with the CSV exports and building URLs into Recurly's UI.

Returns:

  • (String)

    The UUID is useful for matching data with the CSV exports and building URLs into Recurly's UI.



159
# File 'lib/recurly/resources/transaction.rb', line 159

define_attribute :uuid, String

#vat_numberString

Returns VAT number for the customer on this transaction. If the customer's Billing Info country is BR or AR, then this will be their Tax Identifier. For all other countries this will come from the VAT Number field in the Billing Info.

Returns:

  • (String)

    VAT number for the customer on this transaction. If the customer's Billing Info country is BR or AR, then this will be their Tax Identifier. For all other countries this will come from the VAT Number field in the Billing Info.



163
# File 'lib/recurly/resources/transaction.rb', line 163

define_attribute :vat_number, String

#voided_atDateTime

Returns Voided at.

Returns:

  • (DateTime)

    Voided at



167
# File 'lib/recurly/resources/transaction.rb', line 167

define_attribute :voided_at, DateTime

#voided_by_invoiceInvoiceMini

Returns Invoice mini details.

Returns:



171
# File 'lib/recurly/resources/transaction.rb', line 171

define_attribute :voided_by_invoice, :InvoiceMini