Class: ActiveMerchant::Billing::PayflowGateway

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

Direct Known Subclasses

PayflowUkGateway

Constant Summary collapse

RECURRING_ACTIONS =
Set.new([:add, :modify, :cancel, :inquiry, :reactivate, :payment])

Constants included from PayflowCommonAPI

ActiveMerchant::Billing::PayflowCommonAPI::CARD_MAPPING, ActiveMerchant::Billing::PayflowCommonAPI::CVV_CODE, ActiveMerchant::Billing::PayflowCommonAPI::TRANSACTIONS, ActiveMerchant::Billing::PayflowCommonAPI::XMLNS

Constants inherited from Gateway

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

Instance Attribute Summary

Attributes inherited from Gateway

#options

Instance Method Summary collapse

Methods included from PayflowCommonAPI

#capture, included, #initialize, #void

Methods inherited from Gateway

#card_brand, card_brand, #generate_unique_id, inherited, #initialize, supported_countries, #supported_countries, supported_countries=, supports?, #supports_network_tokenization?, #test?

Methods included from CreditCardFormatting

#format

Methods included from PostsData

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

Instance Method Details

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



16
17
18
19
20
# File 'lib/active_merchant/billing/gateways/payflow.rb', line 16

def authorize(money, credit_card_or_reference, options = {})
  request = build_sale_or_authorization_request(:authorization, money, credit_card_or_reference, options)

  commit(request, options)
end

#cancel_recurring(profile_id) ⇒ Object



85
86
87
88
89
90
# File 'lib/active_merchant/billing/gateways/payflow.rb', line 85

def cancel_recurring(profile_id)
  ActiveMerchant.deprecated RECURRING_DEPRECATION_MESSAGE

  request = build_recurring_request(:cancel, 0, :profile_id => profile_id)
  commit(request, options.merge(:request_type => :recurring))
end

#credit(money, funding_source, options = {}) ⇒ Object



28
29
30
31
32
33
34
35
36
37
38
39
40
41
# File 'lib/active_merchant/billing/gateways/payflow.rb', line 28

def credit(money, funding_source, options = {})
  if funding_source.is_a?(String)
    ActiveMerchant.deprecated CREDIT_DEPRECATION_MESSAGE
    # Perform referenced credit
    refund(money, funding_source, options)
  elsif card_brand(funding_source) == 'check'
    # Perform non-referenced credit
    request = build_check_request(:credit, money, funding_source, options)
    commit(request, options)
  else
    request = build_credit_card_request(:credit, money, funding_source, options)
    commit(request, options)
  end
end

#expressObject



99
100
101
# File 'lib/active_merchant/billing/gateways/payflow.rb', line 99

def express
  @express ||= PayflowExpressGateway.new(@options)
end

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



22
23
24
25
26
# File 'lib/active_merchant/billing/gateways/payflow.rb', line 22

def purchase(money, funding_source, options = {})
  request = build_sale_or_authorization_request(:purchase, money, funding_source, options)

  commit(request, options)
end

#recurring(money, credit_card, options = {}) ⇒ Object

Adds or modifies a recurring Payflow profile. See the Payflow Pro Recurring Billing Guide for more details: www.paypal.com/en_US/pdf/PayflowPro_RecurringBilling_Guide.pdf

Several options are available to customize the recurring profile:

  • profile_id - is only required for editing a recurring profile

  • starting_at - takes a Date, Time, or string in mmddyyyy format. The date must be in the future.

  • name - The name of the customer to be billed. If not specified, the name from the credit card is used.

  • periodicity - The frequency that the recurring payments will occur at. Can be one of

:bimonthly, :monthly, :biweekly, :weekly, :yearly, :daily, :semimonthly, :quadweekly, :quarterly, :semiyearly

  • payments - The term, or number of payments that will be made

  • comment - A comment associated with the profile



75
76
77
78
79
80
81
82
83
# File 'lib/active_merchant/billing/gateways/payflow.rb', line 75

def recurring(money, credit_card, options = {})
  ActiveMerchant.deprecated RECURRING_DEPRECATION_MESSAGE

  options[:name] = credit_card.name if options[:name].blank? && credit_card
  request = build_recurring_request(options[:profile_id] ? :modify : :add, money, options) do |xml|
    add_credit_card(xml, credit_card, options) if credit_card
  end
  commit(request, options.merge(:request_type => :recurring))
end

#recurring_inquiry(profile_id, options = {}) ⇒ Object



92
93
94
95
96
97
# File 'lib/active_merchant/billing/gateways/payflow.rb', line 92

def recurring_inquiry(profile_id, options = {})
  ActiveMerchant.deprecated RECURRING_DEPRECATION_MESSAGE

  request = build_recurring_request(:inquiry, nil, options.update( :profile_id => profile_id ))
  commit(request, options.merge(:request_type => :recurring))
end

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



43
44
45
# File 'lib/active_merchant/billing/gateways/payflow.rb', line 43

def refund(money, reference, options = {})
  commit(build_reference_request(:credit, money, reference, options), options)
end

#scrub(transcript) ⇒ Object



107
108
109
110
111
112
113
# File 'lib/active_merchant/billing/gateways/payflow.rb', line 107

def scrub(transcript)
  transcript.
    gsub(%r((<CardNum>)[^<]*(</CardNum>)), '\1[FILTERED]\2').
    gsub(%r((<CVNum>)[^<]*(</CVNum>)), '\1[FILTERED]\2').
    gsub(%r((<AcctNum>)[^<]*(</AcctNum>)), '\1[FILTERED]\2').
    gsub(%r((<Password>)[^<]*(</Password>)), '\1[FILTERED]\2')
end

#supports_scrubbing?Boolean

Returns:

  • (Boolean)


103
104
105
# File 'lib/active_merchant/billing/gateways/payflow.rb', line 103

def supports_scrubbing?
  true
end

#verify(payment, options = {}) ⇒ Object



47
48
49
50
51
52
53
54
55
56
# File 'lib/active_merchant/billing/gateways/payflow.rb', line 47

def verify(payment, options={})
  if credit_card_type(payment) == 'Amex'
    MultiResponse.run(:use_first_response) do |r|
      r.process { authorize(100, payment, options) }
      r.process(:ignore_result) { void(r.authorization, options) }
    end
  else
    authorize(0, payment, options)
  end
end

#verify_credentialsObject



58
59
60
61
# File 'lib/active_merchant/billing/gateways/payflow.rb', line 58

def verify_credentials
  response = void('0')
  response.params['result'] != '26'
end