recurly 2.18.31 → 3.0.0.beta.1

data/lib/recurly/transaction/errors.rb

@@ -1,115 +0,0 @@
-module Recurly
-  class Transaction < Resource
-    # The base error class for transaction errors, raised when a transaction
-    # fails.
-    #
-    # Error messages are customer-friendly, though only {DeclinedError}
-    # messages should be a part of the normal API flow (a {ConfigurationError},
-    # for example, is a problem that a customer cannot solve and requires your
-    # attention).
-    #
-    # If a record of the transaction was stored in Recurly, it will be
-    # accessible via {Error#transaction}.
-    #
-    # @example
-    #   begin
-    #     subscription.save!
-    #   rescue Recurly::Resource::Invalid => e
-    #     # Display e.record.errors...
-    #   rescue Recurly::Transaction::DeclinedError => e
-    #     # Display e.message and/or subscription (and associated) errors...
-    #   rescue Recurly::Transaction::RetryableError => e
-    #     # You should be able to attempt to save this again later.
-    #   rescue Recurly::Transaction::Error => e
-    #     # Alert yourself of the issue (i.e., log e.transaction).
-    #     # Display a generic error message.
-    #   end
-    class Error < API::UnprocessableEntity
-      # @return [Transaction] The transaction as returned (or updated) by
-      #   Recurly.
-      attr_reader :transaction
-
-      def initialize request, response, transaction
-        super request, response
-        update_transaction transaction
-      end
-
-      # @return [String] A customer-friendly error message.
-      def to_s
-        xml.text '/errors/transaction_error/customer_message'
-      end
-
-      # @return [String] The transaction error code.
-      def transaction_error_code
-        xml.text '/errors/transaction_error/error_code'
-      end
-
-      def gateway_error_code
-        xml.text '/errors/transaction_error/gateway_error_code'
-      end
-
-      private
-
-      def update_transaction transaction
-        return unless transaction_xml = xml['/errors/transaction']
-
-        @transaction = transaction
-        transaction = Transaction.from_xml transaction_xml
-        if @transaction.nil?
-          @transaction = transaction
-        else
-          @transaction.instance_variable_get(:@attributes).update(
-            transaction.attributes
-          )
-        end
-        @transaction.persist!
-      end
-    end
-
-    # Raised when a transaction fails for a temporary reason. The transaction
-    # should be retried later.
-    class RetryableError < Error
-    end
-
-    # Raised when a transaction fails due to a misconfiguration, e.g. if the
-    # gateway hasn't been configured.
-    class ConfigurationError < Error
-    end
-
-    # Raised when a transaction fails because the billing information was
-    # invalid.
-    class DeclinedError < Error
-    end
-
-    # Raised when the gateway believes this transaction to be a duplicate.
-    class DuplicateError < DeclinedError
-    end
-
-    # Raised when a 3DS result token is needed to complete a transaction
-    class ThreeDSecureError < DeclinedError
-      def three_d_secure_action_token_id
-        xml.text '/errors/transaction_error/three_d_secure_action_token_id'
-      end
-    end
-
-    class << Error
-      CATEGORY_MAP = Hash.new DeclinedError
-      CATEGORY_MAP.update(
-        'communication'             => RetryableError,
-        'configuration'             => ConfigurationError,
-        'duplicate'                 => DuplicateError,
-        '3d_secure_action_required' => ThreeDSecureError
-      )
-
-      def validate! exception, transaction
-        return unless exception.is_a? API::UnprocessableEntity
-
-        category = exception.send(:xml).text(
-          '/errors/transaction_error/error_category'
-        ) and raise CATEGORY_MAP[category].new(
-          exception.request, exception.response, transaction
-        )
-      end
-    end
-  end
-end

data/lib/recurly/transaction.rb

@@ -1,131 +0,0 @@
-module Recurly
-  class Transaction < Resource
-    require 'recurly/transaction/errors'
-
-    # @macro [attach] scope
-    #   @scope class
-    #   @return [Pager] a pager that yields +$1+ transactions.
-    scope :authorizations, type: 'authorization'
-    scope :purchases,      type: 'purchase'
-    scope :refunds,        type: 'refund'
-    scope :successful,     state: 'successful'
-    scope :failed,         state: 'failed'
-    scope :voided,         state: 'voided'
-
-    # @return [Account]
-    belongs_to :account
-    # @return [Invoice, nil]
-    belongs_to :invoice
-
-    # @return [Pager<Subscription>, nil]
-    has_many :subscriptions
-
-    # @return [Transaction, nil]
-    has_one :original_transaction, class_name: :Transaction, readonly: true
-
-    define_attribute_methods %w(
-      id
-      uuid
-      action
-      amount_in_cents
-      tax_in_cents
-      currency
-      payment_method
-      status
-      reference
-      recurring
-      test
-      voidable
-      refundable
-      cvv_result
-      avs_result
-      avs_result_street
-      avs_result_postal
-      created_at
-      updated_at
-      details
-      transaction_error
-      source
-      ip_address
-      collected_at
-      description
-      tax_exempt
-      tax_code
-      accounting_code
-      fraud
-      product_code
-      gateway_type
-      origin
-      message
-      approval_code
-      date
-      gateway
-      gateway_error_codes
-      invoice_id
-      invoice_number
-      invoice_number_prefix
-      failure_type
-      billing_phone
-      billing_postal
-      billing_country
-      subscription_id
-      manually_entered
-      avalara_transaction_type
-      avalara_service_type
-    )
-    alias to_param uuid
-    alias fraud_info fraud
-
-    def self.to_xml(attrs)
-      transaction = new attrs
-      transaction.to_xml
-    end
-
-    # @return ["credit", "charge", nil] The type of transaction.
-    attr_reader :type
-
-    # @see Resource#initialize
-    def initialize(attributes = {})
-      super({ :currency => Recurly.default_currency }.merge attributes)
-    end
-
-    # Saves new records only.
-    #
-    # @return [true, false]
-    # @raise [Recurly::Error] For persisted transactions.
-    # @see Resource#save
-    def save
-      return super if new_record?
-      raise Recurly::Error, "#{self.class.collection_name} cannot be updated"
-    end
-
-    # Refunds the transaction.
-    #
-    # @return [Transaction, false] The updated original transaction if voided,
-    #   a new refund transaction, false if the transaction isn't voidable or
-    #   refundable.
-    # @raise [Error] If the refund fails.
-    # @param amount_in_cents [Integer, nil] The amount (in cents) to refund
-    #   (refunds fully if nil).
-    def refund amount_in_cents = nil
-      return false unless link? :refund
-      refund = self.class.from_response(
-        follow_link :refund, :params => { :amount_in_cents => amount_in_cents }
-      )
-      refund.uuid == uuid ? copy_from(refund) && self : refund
-    end
-
-    def signable_attributes
-      super.merge :amount_in_cents => amount_in_cents, :currency => currency
-    end
-
-    # @return [String]
-    def inspect
-      attributes = self.class.attribute_names
-      unless type == 'credit_card'
-        attributes -= %w(cvv_result avs_result avs_result_street)
-      end
-      super attributes
-    end
-  end
-end

data/lib/recurly/usage.rb

@@ -1,29 +0,0 @@
-module Recurly
-  class Usage < Resource
-    # @return [MeasuredUnit]
-    belongs_to :measured_unit
-
-    define_attribute_methods %w(
-      id
-      usage_type
-      unit_amount_in_cents
-      usage_percentage
-      amount
-      amount_decimal
-      merchant_tag
-      usage_timestamp
-      recording_timestamp
-      billed_at
-      created_at
-      updated_at
-      subscription_id
-      add_on_code
-      measured_unit_id
-      modified_at
-    )
-
-    # Usages are only writeable and readable through {SubscriptionAddOns} instances.
-    embedded!
-    private_class_method :find
-  end
-end

data/lib/recurly/verify.rb

@@ -1,12 +0,0 @@
-module Recurly
-  class Verify < Resource
-    define_attribute_methods %w(
-      gateway_code
-    )
-
-    def self.to_xml(attrs)
-      verify = new attrs
-      verify.to_xml
-    end
-  end
-end

data/lib/recurly/webhook/account_notification.rb

@@ -1,13 +0,0 @@
-module Recurly
-  module Webhook
-    # The AccountNotification class provides a generic interface
-    # for account-related webhook notifications.
-    class AccountNotification < Notification
-      # @return [Account]
-      has_one :account
-
-      # @return [ShippingAddress]
-      has_one :shipping_address
-    end
-  end
-end

data/lib/recurly/webhook/billing_info_update_failed_notification.rb

@@ -1,6 +0,0 @@
-module Recurly
-  module Webhook
-    class BillingInfoUpdateFailedNotification < AccountNotification
-    end
-  end
-end

data/lib/recurly/webhook/billing_info_updated_notification.rb

@@ -1,6 +0,0 @@
-module Recurly
-  module Webhook
-    class BillingInfoUpdatedNotification < AccountNotification
-    end
-  end
-end

data/lib/recurly/webhook/canceled_account_notification.rb

@@ -1,6 +0,0 @@
-module Recurly
-  module Webhook
-    class CanceledAccountNotification < AccountNotification
-    end
-  end
-end

data/lib/recurly/webhook/canceled_gift_card_notification.rb

@@ -1,6 +0,0 @@
-module Recurly
-  module Webhook
-    class CanceledGiftCardNotification < GiftCardNotification
-    end
-  end
-end

data/lib/recurly/webhook/canceled_subscription_notification.rb

@@ -1,6 +0,0 @@
-module Recurly
-  module Webhook
-    class CanceledSubscriptionNotification < SubscriptionNotification
-    end
-  end
-end

data/lib/recurly/webhook/closed_credit_invoice_notification.rb

@@ -1,6 +0,0 @@
-module Recurly
-  module Webhook
-    class ClosedCreditInvoiceNotification < InvoiceNotification
-    end
-  end
-end

data/lib/recurly/webhook/closed_invoice_notification.rb

@@ -1,6 +0,0 @@
-module Recurly
-  module Webhook
-    class ClosedInvoiceNotification < InvoiceNotification
-    end
-  end
-end

data/lib/recurly/webhook/credit_payment_notification.rb

@@ -1,12 +0,0 @@
-module Recurly
-  module Webhook
-    # The CreditPayment class provides a generic interface
-    # for credit-payment-related webhook notifications.
-    class CreditPaymentNotification < Notification
-      # @return [Account]
-      has_one :account
-      # @return [CreditPayment]
-      has_one :credit_payment
-    end
-  end
-end

data/lib/recurly/webhook/deactivated_item_notification.rb

@@ -1,6 +0,0 @@
-module Recurly
-  module Webhook
-    class DeactivatedItemNotification < ItemNotification
-    end
-  end
-end

data/lib/recurly/webhook/deleted_shipping_address_notification.rb

@@ -1,6 +0,0 @@
-module Recurly
-  module Webhook
-    class DeletedShippingAddressNotification < AccountNotification
-    end
-  end
-end

data/lib/recurly/webhook/dunning_notification.rb

@@ -1,14 +0,0 @@
-module Recurly
-  module Webhook
-    class DunningNotification < Notification
-      # @return [Account]
-      has_one :account
-      # @return [Subscription]
-      has_one :subscription
-      # @return [Invoice]
-      has_one :invoice
-      # @return [Transaction]
-      has_one :transaction
-    end
-  end
-end

data/lib/recurly/webhook/expired_subscription_notification.rb

@@ -1,6 +0,0 @@
-module Recurly
-  module Webhook
-    class ExpiredSubscriptionNotification < SubscriptionNotification
-    end
-  end
-end

data/lib/recurly/webhook/failed_charge_invoice_notification.rb

@@ -1,6 +0,0 @@
-module Recurly
-  module Webhook
-    class FailedChargeInvoiceNotification < InvoiceNotification
-    end
-  end
-end

data/lib/recurly/webhook/failed_payment_notification.rb

@@ -1,6 +0,0 @@
-module Recurly
-  module Webhook
-    class FailedPaymentNotification < TransactionNotification
-    end
-  end
-end

data/lib/recurly/webhook/fraud_info_updated_notification.rb

@@ -1,6 +0,0 @@
-module Recurly
-  module Webhook
-    class FraudInfoUpdatedNotification < TransactionNotification
-    end
-  end
-end

data/lib/recurly/webhook/gift_card_notification.rb

@@ -1,8 +0,0 @@
-module Recurly
-  module Webhook
-    class GiftCardNotification < Notification
-      has_one :gift_card
-
-    end
-  end
-end

data/lib/recurly/webhook/invoice_notification.rb

@@ -1,12 +0,0 @@
-module Recurly
-  module Webhook
-    # The InvoiceNotification class provides a generic interface
-    # for account-related webhook notifications.
-    class InvoiceNotification < Notification
-      # @return [Account]
-      has_one :account
-      # @return [Invoice]
-      has_one :invoice
-    end
-  end
-end

data/lib/recurly/webhook/item_notification.rb

@@ -1,7 +0,0 @@
-module Recurly
-  module Webhook
-    class ItemNotification < Notification
-      has_one :item
-    end
-  end
-end

data/lib/recurly/webhook/low_balance_gift_card_notification.rb

@@ -1,6 +0,0 @@
-module Recurly
-  module Webhook
-    class LowBalanceGiftCardNotification < SubscriptionNotification
-    end
-  end
-end

data/lib/recurly/webhook/new_account_notification.rb

@@ -1,6 +0,0 @@
-module Recurly
-  module Webhook
-    class NewAccountNotification < AccountNotification
-    end
-  end
-end

data/lib/recurly/webhook/new_charge_invoice_notification.rb

@@ -1,6 +0,0 @@
-module Recurly
-  module Webhook
-    class NewChargeInvoiceNotification < InvoiceNotification
-    end
-  end
-end

data/lib/recurly/webhook/new_credit_invoice_notification.rb

@@ -1,6 +0,0 @@
-module Recurly
-  module Webhook
-    class NewCreditInvoiceNotification < InvoiceNotification
-    end
-  end
-end

data/lib/recurly/webhook/new_credit_payment_notification.rb

@@ -1,6 +0,0 @@
-module Recurly
-  module Webhook
-    class NewCreditPaymentNotification < CreditPaymentNotification
-    end
-  end
-end

data/lib/recurly/webhook/new_dunning_event_notification.rb

@@ -1,6 +0,0 @@
-module Recurly
-  module Webhook
-    class NewDunningEventNotification < DunningNotification
-    end
-  end
-end

data/lib/recurly/webhook/new_invoice_notification.rb

@@ -1,6 +0,0 @@
-module Recurly
-  module Webhook
-    class NewInvoiceNotification < InvoiceNotification
-    end
-  end
-end

data/lib/recurly/webhook/new_item_notification.rb

@@ -1,6 +0,0 @@
-module Recurly
-  module Webhook
-    class NewItemNotification < ItemNotification
-    end
-  end
-end

data/lib/recurly/webhook/new_shipping_address_notification.rb

@@ -1,6 +0,0 @@
-module Recurly
-  module Webhook
-    class NewShippingAddressNotification < AccountNotification
-    end
-  end
-end

data/lib/recurly/webhook/new_subscription_notification.rb

@@ -1,6 +0,0 @@
-module Recurly
-  module Webhook
-    class NewSubscriptionNotification < SubscriptionNotification
-    end
-  end
-end

data/lib/recurly/webhook/new_usage_notification.rb

@@ -1,8 +0,0 @@
-module Recurly
-  module Webhook
-    class NewUsageNotification < AccountNotification
-      # @return [Usage]
-      has_one :usage
-    end
-  end
-end

data/lib/recurly/webhook/notification.rb

@@ -1,18 +0,0 @@
-module Recurly
-  module Webhook
-    # The Notification class provides a generic interface
-    # for account-related webhook notifications.
-    class Notification < Resource
-      # Provides a convenience method to reload assocated members because Webhook
-      # notifications are not to be considered current.
-      def self.has_one member_name, options = {}
-        define_method("#{member_name}!") do
-          member = self[member_name]
-          member.reload if member
-        end
-
-        super
-      end
-    end
-  end
-end

data/lib/recurly/webhook/paid_charge_invoice_notification.rb

@@ -1,6 +0,0 @@
-module Recurly
-  module Webhook
-    class PaidChargeInvoiceNotification < InvoiceNotification
-    end
-  end
-end

data/lib/recurly/webhook/past_due_charge_invoice_notification.rb

@@ -1,6 +0,0 @@
-module Recurly
-  module Webhook
-    class PastDueChargeInvoiceNotification < InvoiceNotification
-    end
-  end
-end

data/lib/recurly/webhook/past_due_invoice_notification.rb

@@ -1,6 +0,0 @@
-module Recurly
-  module Webhook
-    class PastDueInvoiceNotification < InvoiceNotification
-    end
-  end
-end

data/lib/recurly/webhook/paused_subscription_renewal_notification.rb

@@ -1,6 +0,0 @@
-module Recurly
-  module Webhook
-    class PausedSubscriptionRenewalNotification < SubscriptionNotification
-    end
-  end
-end

data/lib/recurly/webhook/prerenewal_notification.rb

@@ -1,6 +0,0 @@
-module Recurly
-  module Webhook
-    class PrerenewalNotification < SubscriptionNotification
-    end
-  end
-end

data/lib/recurly/webhook/processing_charge_invoice_notification.rb

@@ -1,6 +0,0 @@
-module Recurly
-  module Webhook
-    class ProcessingChargeInvoiceNotification < InvoiceNotification
-    end
-  end
-end

data/lib/recurly/webhook/processing_credit_invoice_notification.rb

@@ -1,6 +0,0 @@
-module Recurly
-  module Webhook
-    class ProcessingCreditInvoiceNotification < InvoiceNotification
-    end
-  end
-end

data/lib/recurly/webhook/processing_invoice_notification.rb

@@ -1,6 +0,0 @@
-module Recurly
-  module Webhook
-    class ProcessingInvoiceNotification < InvoiceNotification
-    end
-  end
-end

data/lib/recurly/webhook/processing_payment_notification.rb

@@ -1,6 +0,0 @@
-module Recurly
-  module Webhook
-    class ProcessingPaymentNotification < TransactionNotification
-    end
-  end
-end

data/lib/recurly/webhook/purchased_gift_card_notification.rb

@@ -1,7 +0,0 @@
-module Recurly
-  module Webhook
-    class PurchasedGiftCardNotification < GiftCardNotification
-
-    end
-  end
-end

data/lib/recurly/webhook/reactivated_account_notification.rb

@@ -1,6 +0,0 @@
-module Recurly
-  module Webhook
-    class ReactivatedAccountNotification < SubscriptionNotification
-    end
-  end
-end

data/lib/recurly/webhook/reactivated_item_notification.rb

@@ -1,6 +0,0 @@
-module Recurly
-  module Webhook
-    class ReactivatedItemNotification < ItemNotification
-    end
-  end
-end