Class: ActiveMerchant::Billing::WorldpayGateway

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

Constant Summary collapse

NETWORK_TOKEN_TYPE =
{
  apple_pay: 'APPLEPAY',
  google_pay: 'GOOGLEPAY',
  network_token: 'NETWORKTOKEN'
}
CARD_CODES =
{
  'visa'             => 'VISA-SSL',
  'master'           => 'ECMC-SSL',
  'discover'         => 'DISCOVER-SSL',
  'american_express' => 'AMEX-SSL',
  'jcb'              => 'JCB-SSL',
  'maestro'          => 'MAESTRO-SSL',
  'diners_club'      => 'DINERS-SSL',
  'elo'              => 'ELO-SSL',
  'naranja'          => 'NARANJA-SSL',
  'cabal'            => 'CABAL-SSL',
  'unionpay'         => 'CHINAUNIONPAY-SSL',
  'unknown'          => 'CARD-SSL'
}
AVS_CODE_MAP =
{
  'A' => 'M', # Match
  'B' => 'P', # Postcode matches, address not verified
  'C' => 'Z', # Postcode matches, address does not match
  'D' => 'B', # Address matched; postcode not checked
  'E' => 'I', # Address and postal code not checked
  'F' => 'A', # Address matches, postcode does not match
  'G' => 'C', # Address does not match, postcode not checked
  'H' => 'I', # Address and postcode not provided
  'I' => 'C', # Address not checked postcode does not match
  'J' => 'C', # Address and postcode does not match
}
CVC_CODE_MAP =
{
  'A' => 'M', # CVV matches
  'B' => 'P', # Not provided
  'C' => 'P', # Not checked
  'D' => 'N', # Does not match
}

Constants inherited from Gateway

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

Instance Attribute Summary

Attributes inherited from Gateway

#options

Instance Method Summary collapse

Methods inherited from Gateway

#add_field_to_post_if_present, #add_fields_to_post_if_present, card_brand, #card_brand, #generate_unique_id, inherited, supported_countries, #supported_countries, supported_countries=, supports?, #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 = {}) ⇒ WorldpayGateway

Returns a new instance of WorldpayGateway.



66
67
68
69
# File 'lib/active_merchant/billing/gateways/worldpay.rb', line 66

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

Instance Method Details

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



78
79
80
81
82
# File 'lib/active_merchant/billing/gateways/worldpay.rb', line 78

def authorize(money, payment_method, options = {})
  requires!(options, :order_id)
  payment_details = payment_details(payment_method)
  authorize_request(money, payment_method, payment_details.merge(options))
end

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



84
85
86
87
88
89
90
91
92
93
94
# File 'lib/active_merchant/billing/gateways/worldpay.rb', line 84

def capture(money, authorization, options = {})
  authorization = order_id_from_authorization(authorization.to_s)
  MultiResponse.run do |r|
    r.process { inquire_request(authorization, options, 'AUTHORISED', 'CAPTURED') } unless options[:authorization_validated]
    if r.params
      authorization_currency = r.params['amount_currency_code']
      options = options.merge(currency: authorization_currency) if authorization_currency.present?
    end
    r.process { capture_request(money, authorization, options) }
  end
end

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

Credits only function on a Merchant ID/login/profile flagged for Payouts

aka Credit Fund Transfers (CFT), whereas normal purchases, refunds,
and other transactions should be performed on a normal eCom-flagged
merchant ID.


125
126
127
128
129
130
131
132
# File 'lib/active_merchant/billing/gateways/worldpay.rb', line 125

def credit(money, payment_method, options = {})
  payment_details = payment_details(payment_method)
  if options[:fast_fund_credit]
    fast_fund_credit_request(money, payment_method, payment_details.merge(credit: true, **options))
  else
    credit_request(money, payment_method, payment_details.merge(credit: true, **options))
  end
end

#inquire(authorization, options = {}) ⇒ Object



147
148
149
150
# File 'lib/active_merchant/billing/gateways/worldpay.rb', line 147

def inquire(authorization, options = {})
  order_id = order_id_from_authorization(authorization.to_s) || options[:order_id]
  commit('direct_inquiry', build_order_inquiry_request(order_id, options), :ok, options)
end

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



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

def purchase(money, payment_method, options = {})
  MultiResponse.run do |r|
    r.process { authorize(money, payment_method, options) }
    r.process { capture(money, r.authorization, options.merge(authorization_validated: true)) } unless options[:skip_capture]
  end
end

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



104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
# File 'lib/active_merchant/billing/gateways/worldpay.rb', line 104

def refund(money, authorization, options = {})
  authorization = order_id_from_authorization(authorization.to_s)
  success_criteria = %w(CAPTURED SETTLED SETTLED_BY_MERCHANT SENT_FOR_REFUND)
  success_criteria.push('AUTHORIZED') if options[:cancel_or_refund]
  response = MultiResponse.run do |r|
    r.process { inquire_request(authorization, options, *success_criteria) } unless options[:authorization_validated]
    r.process { refund_request(money, authorization, options) }
  end

  if !response.success? && options[:force_full_refund_if_unsettled] &&
     response.params['last_event'] == 'AUTHORISED'
    void(authorization, options)
  else
    response
  end
end

#scrub(transcript) ⇒ Object



160
161
162
163
164
165
166
167
# File 'lib/active_merchant/billing/gateways/worldpay.rb', line 160

def scrub(transcript)
  transcript.
    gsub(%r((Authorization: Basic )\w+), '\1[FILTERED]').
    gsub(%r((<cardNumber>)\d+(</cardNumber>)), '\1[FILTERED]\2').
    gsub(%r((<cvc>)[^<]+(</cvc>)), '\1[FILTERED]\2').
    gsub(%r((<tokenNumber>)\d+(</tokenNumber>)), '\1[FILTERED]\2').
    gsub(%r((<cryptogram>)[^<]+(</cryptogram>)), '\1[FILTERED]\2')
end

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



142
143
144
145
# File 'lib/active_merchant/billing/gateways/worldpay.rb', line 142

def store(credit_card, options = {})
  requires!(options, :customer)
  store_request(credit_card, options)
end

#supports_network_tokenization?Boolean

Returns:

  • (Boolean)


156
157
158
# File 'lib/active_merchant/billing/gateways/worldpay.rb', line 156

def supports_network_tokenization?
  true
end

#supports_scrubbingObject



152
153
154
# File 'lib/active_merchant/billing/gateways/worldpay.rb', line 152

def supports_scrubbing
  true
end

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



134
135
136
137
138
139
140
# File 'lib/active_merchant/billing/gateways/worldpay.rb', line 134

def verify(payment_method, options = {})
  amount = (eligible_for_0_auth?(payment_method, options) ? 0 : 100)
  MultiResponse.run(:use_first_response) do |r|
    r.process { authorize(amount, payment_method, options) }
    r.process(:ignore_result) { void(r.authorization, options.merge(authorization_validated: true)) }
  end
end

#void(authorization, options = {}) ⇒ Object



96
97
98
99
100
101
102
# File 'lib/active_merchant/billing/gateways/worldpay.rb', line 96

def void(authorization, options = {})
  authorization = order_id_from_authorization(authorization.to_s)
  MultiResponse.run do |r|
    r.process { inquire_request(authorization, options, 'AUTHORISED') } unless options[:authorization_validated]
    r.process { cancel_request(authorization, options) }
  end
end