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

#account ⇒ AccountMini

Returns Account mini details.

Returns:



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

define_attribute :account, :AccountMini

#action_result ⇒ Hash

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

#amount ⇒ Float

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_check ⇒ String

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_used ⇒ Boolean

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_address ⇒ AddressWithName

Returns:



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

define_attribute :billing_address, :AddressWithName

#collected_at ⇒ DateTime

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_method ⇒ String

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_at ⇒ DateTime

Returns Created at.

Returns:

  • (DateTime) —

    Created at



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

define_attribute :created_at, DateTime

#currency ⇒ String

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_message ⇒ String

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_locale ⇒ String

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_check ⇒ String

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_info ⇒ TransactionFraudInfo

Returns Fraud information.

Returns:



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

define_attribute :fraud_info, :TransactionFraudInfo

#gateway_approval_code ⇒ String

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_message ⇒ String

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_reference ⇒ String

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_code ⇒ String

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_time ⇒ Float

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_values ⇒ Hash

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

#id ⇒ String

Returns Transaction ID.

Returns:

  • (String) —

    Transaction ID



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

define_attribute :id, String

#invoice ⇒ InvoiceMini

Returns Invoice mini details.

Returns:



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

define_attribute :invoice, :InvoiceMini

#ip_address_country ⇒ String

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_v4 ⇒ String

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

#object ⇒ String

Returns Object type.

Returns:

  • (String) —

    Object type



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

define_attribute :object, String

#origin ⇒ String

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_id ⇒ String

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_gateway ⇒ TransactionPaymentGateway

Returns:



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

define_attribute :payment_gateway, :TransactionPaymentGateway

#payment_method ⇒ PaymentMethod

Returns:



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

define_attribute :payment_method, :PaymentMethod

#refunded ⇒ Boolean

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

#status ⇒ String

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_code ⇒ String

Returns Status code.

Returns:

  • (String) —

    Status code



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

define_attribute :status_code, String

#status_message ⇒ String

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_ids ⇒ Array[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 }

#success ⇒ Boolean

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

#type ⇒ String

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_at ⇒ DateTime

Returns Updated at.

Returns:

  • (DateTime) —

    Updated at



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

define_attribute :updated_at, DateTime

#uuid ⇒ String

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_number ⇒ String

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_at ⇒ DateTime

Returns Voided at.

Returns:

  • (DateTime) —

    Voided at



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

define_attribute :voided_at, DateTime

#voided_by_invoice ⇒ InvoiceMini

Returns Invoice mini details.

Returns:



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

define_attribute :voided_by_invoice, :InvoiceMini