Module: Spree::Payment::Processing
- Included in:
- Spree::Payment
- Defined in:
- app/models/spree/payment/processing.rb
Instance Method Summary collapse
- #authorize! ⇒ Object
- #cancel! ⇒ Object
-
#capture!(amount = nil) ⇒ Object
Takes the amount in cents to capture.
- #gateway_options ⇒ Object
-
#process! ⇒ Object
“process!” means: - Do nothing when: - There is no payment method - The payment method does not require a source - The payment is in the “processing” state - ‘auto_capture?’ is false and the payment is already authorized.
-
#purchase! ⇒ Object
Captures the entire amount of a payment.
- #void_transaction! ⇒ Object
Instance Method Details
#authorize! ⇒ Object
37 38 39 |
# File 'app/models/spree/payment/processing.rb', line 37 def handle_payment_preconditions { } end |
#cancel! ⇒ Object
86 87 88 89 |
# File 'app/models/spree/payment/processing.rb', line 86 def cancel! response = payment_method.cancel(response_code) handle_void_response(response) end |
#capture!(amount = nil) ⇒ Object
Takes the amount in cents to capture. Can be used to capture partial amounts of a payment, and will create a new pending payment record for the remaining amount to capture later.
49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 |
# File 'app/models/spree/payment/processing.rb', line 49 def capture!(amount = nil) return true if completed? amount ||= money.money.cents started_processing! protect_from_connection_error do check_environment # Standard ActiveMerchant capture usage response = payment_method.capture( amount, response_code, ) money = ::Money.new(amount, currency) capture_events.create!(amount: money.to_f) update_attributes!(amount: captured_amount) handle_response(response, :complete, :failure) end end |
#gateway_options ⇒ Object
91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 |
# File 'app/models/spree/payment/processing.rb', line 91 def order.reload = { :email => order.email, :customer => order.email, :customer_id => order.user_id, :ip => order.last_ip_address, # Need to pass in a unique identifier here to make some # payment gateways happy. # # For more information, please see Spree::Payment#set_unique_identifier :order_id => gateway_order_id } .merge!({ :shipping => order.ship_total * 100, :tax => order.additional_tax_total * 100, :subtotal => order.item_total * 100, :discount => order.promo_total * 100, :currency => currency }) .merge!({ :billing_address => order.bill_address.try(:active_merchant_hash), :shipping_address => order.ship_address.try(:active_merchant_hash) }) end |
#process! ⇒ Object
“process!” means:
- Do nothing when:
- There is no payment method
- The payment method does not require a source
- The payment is in the "processing" state
- 'auto_capture?' is false and the payment is already authorized.
- Raise an exception when:
- The source is missing or invalid
- The payment is in a state that cannot transition to 'processing'
(failed/void/invalid states). Note: 'completed' can transition to
'processing' and thus calling #process! on a completed Payment
will attempt to re-authorize/re-purchase the payment.
- Otherwise:
- If 'auto_capture?' is true:
- Call #purchase on the payment gateway. (i.e. authorize+capture)
even if the payment is already completed.
- Else:
- Call #authorize on the payment gateway even if the payment is
already completed.
23 24 25 26 27 28 29 30 31 32 33 34 35 |
# File 'app/models/spree/payment/processing.rb', line 23 def process! return if payment_method.nil? if payment_method.auto_capture? purchase! else if pending? # do nothing. already authorized. else end end end |
#purchase! ⇒ Object
Captures the entire amount of a payment.
42 43 44 |
# File 'app/models/spree/payment/processing.rb', line 42 def purchase! handle_payment_preconditions { process_purchase } end |
#void_transaction! ⇒ Object
68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 |
# File 'app/models/spree/payment/processing.rb', line 68 def void_transaction! return true if void? protect_from_connection_error do check_environment if payment_method.payment_profiles_supported? # Gateways supporting payment profiles will need access to credit card object because this stores the payment profile information # so supply the authorization itself as well as the credit card, rather than just the authorization code response = payment_method.void(self.response_code, source, ) else # Standard ActiveMerchant void usage response = payment_method.void(self.response_code, ) end handle_void_response(response) end end |