Class: ActiveMerchant::Billing::PinGateway

Inherits:
Gateway
  • Object
show all
Defined in:
lib/active_merchant/billing/gateways/pin.rb

Constant Summary

Constants inherited from Gateway

Gateway::CREDIT_DEPRECATION_MESSAGE, Gateway::CURRENCIES_WITHOUT_FRACTIONS, Gateway::DEBIT_CARDS, Gateway::RECURRING_DEPRECATION_MESSAGE, Gateway::STANDARD_ERROR_CODE

Instance Attribute Summary

Attributes inherited from Gateway

#options

Instance Method Summary collapse

Methods inherited from Gateway

card_brand, #card_brand, #generate_unique_id, inherited, non_fractional_currency?, #scrub, supported_countries, #supported_countries, supported_countries=, supports?, #supports_network_tokenization?, #supports_scrubbing?, #test?

Methods included from CreditCardFormatting

#expdate, #format

Methods included from PostsData

included, #raw_ssl_request, #ssl_get, #ssl_post, #ssl_request

Constructor Details

#initialize(options = {}) ⇒ PinGateway

Returns a new instance of PinGateway



14
15
16
17
# File 'lib/active_merchant/billing/gateways/pin.rb', line 14

def initialize(options = {})
  requires!(options, :api_key)
  super
end

Instance Method Details

#authorize(money, creditcard, options = {}) ⇒ Object

Authorize an amount on a credit card. Once authorized, you can later capture this charge using the charge token that is returned.



56
57
58
59
60
# File 'lib/active_merchant/billing/gateways/pin.rb', line 56

def authorize(money, creditcard, options = {})
  options[:capture] = false

  purchase(money, creditcard, options)
end

#capture(money, token, options = {}) ⇒ Object

Captures a previously authorized charge. Capturing only part of the original authorization is currently not supported.



64
65
66
# File 'lib/active_merchant/billing/gateways/pin.rb', line 64

def capture(money, token, options = {})
  commit(:put, "charges/#{CGI.escape(token)}/capture", { :amount => amount(money) }, options)
end

#purchase(money, creditcard, options = {}) ⇒ Object

Create a charge using a credit card, card token or customer token

To charge a credit card: purchase(, [creditcard hash], …) To charge a customer: purchase(, [token], …)



23
24
25
26
27
28
29
30
31
32
33
34
# File 'lib/active_merchant/billing/gateways/pin.rb', line 23

def purchase(money, creditcard, options = {})
  post = {}

  add_amount(post, money, options)
  add_customer_data(post, options)
  add_invoice(post, options)
  add_creditcard(post, creditcard)
  add_address(post, creditcard, options)
  add_capture(post, options)

  commit(:post, 'charges', post, options)
end

#refund(money, token, options = {}) ⇒ Object

Refund a transaction, note that the money attribute is ignored at the moment as the API does not support partial refunds. The parameter is kept for compatibility reasons



50
51
52
# File 'lib/active_merchant/billing/gateways/pin.rb', line 50

def refund(money, token, options = {})
  commit(:post, "charges/#{CGI.escape(token)}/refunds", { :amount => amount(money) }, options)
end

#store(creditcard, options = {}) ⇒ Object

Create a customer and associated credit card. The token that is returned can be used instead of a credit card parameter in the purchase method



38
39
40
41
42
43
44
45
# File 'lib/active_merchant/billing/gateways/pin.rb', line 38

def store(creditcard, options = {})
  post = {}

  add_creditcard(post, creditcard)
  add_customer_data(post, options)
  add_address(post, creditcard, options)
  commit(:post, 'customers', post, options)
end

#update(token, creditcard, options = {}) ⇒ Object

Updates the credit card for the customer.



69
70
71
72
73
74
75
76
# File 'lib/active_merchant/billing/gateways/pin.rb', line 69

def update(token, creditcard, options = {})
  post = {}

  add_creditcard(post, creditcard)
  add_customer_data(post, options)
  add_address(post, creditcard, options)
  commit(:put, "customers/#{CGI.escape(token)}", post, options)
end