Class: ActiveMerchant::Billing::OgoneGateway

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

Overview

Ogone DirectLink Gateway

DirectLink is the API version of the Ogone Payment Platform. It allows server to server communication between Ogone systems and your e-commerce website.

This implementation follows the specification provided in the DirectLink integration guide version 4.3.0 (25 April 2012), available here: secure.ogone.com/ncol/Ogone_DirectLink_EN.pdf

It also features aliases, which allow to store/unstore credit cards, as specified in the Alias Manager Option guide version 3.2.1 (25 April 2012) available here: secure.ogone.com/ncol/Ogone_Alias_EN.pdf

It also implements the 3-D Secure feature, as specified in the DirectLink with 3-D Secure guide version 3.0 (25 April 2012) available here: secure.ogone.com/ncol/Ogone_DirectLink-3-D_EN.pdf

It was last tested on Release 4.92 of Ogone DirectLink + AliasManager + Direct Link 3D (25 April 2012).

For any questions or comments, please contact one of the following:

Usage

gateway = ActiveMerchant::Billing::OgoneGateway.new(
            :login                     => "my_ogone_psp_id",
            :user                      => "my_ogone_user_id",
            :password                  => "my_ogone_pswd",
            :signature                 => "my_ogone_sha_signature", # Only if you configured your Ogone environment so.
            :signature_encryptor       => "sha512", # Can be "none" (default), "sha1", "sha256" or "sha512".
                                                    # Must be the same as the one configured in your Ogone account.
         )

# set up credit card object as in main ActiveMerchant example
creditcard = ActiveMerchant::Billing::CreditCard.new(
  :type       => 'visa',
  :number     => '4242424242424242',
  :month      => 8,
  :year       => 2009,
  :first_name => 'Bob',
  :last_name  => 'Bobsen'
)

# run request
response = gateway.purchase(1000, creditcard, :order_id => "1") # charge 10 EUR

If you don't provide an :order_id, the gateway will generate a random one for you.

puts response.success?      # Check whether the transaction was successful
puts response.message       # Retrieve the message returned by Ogone
puts response.authorization # Retrieve the unique transaction ID returned by Ogone
puts response.order_id      # Retrieve the order ID

Alias feature

To use the alias feature, simply add :billing_id in the options hash:

# Associate the alias to that credit card
gateway.purchase(1000, creditcard, :order_id => "1", :billing_id => "myawesomecustomer")

# You can use the alias instead of the credit card for subsequent orders
gateway.purchase(2000, "myawesomecustomer", :order_id => "2")

# You can also create an alias without making a purchase using store
gateway.store(creditcard, :billing_id => "myawesomecustomer")

# When using store, you can also let Ogone generate the alias for you
response = gateway.store(creditcard)
puts response.billing_id  # Retrieve the generated alias

3-D Secure feature

To use the 3-D Secure feature, simply add :d3d => true in the options hash:
gateway.purchase(2000, "myawesomecustomer", :order_id => "2", :d3d => true)

Specific 3-D Secure request options are (please refer to the documentation for more infos about these options):
  :win_3ds         => :main_window (default), :pop_up or :pop_ix.
  :http_accept     => "*/*" (default), or any other HTTP_ACCEPT header value.
  :http_user_agent => The cardholder's User-Agent string
  :accept_url      => URL of the web page to show the customer when the payment is authorized.
                      (or waiting to be authorized).
  :decline_url     => URL of the web page to show the customer when the acquirer rejects the authorization
                      more than the maximum permitted number of authorization attempts (10 by default, but can
                      be changed in the "Global transaction parameters" tab, "Payment retry" section of the
                      Technical Information page).
  :exception_url   => URL of the web page to show the customer when the payment result is uncertain.
  :paramplus       => Field to submit the miscellaneous parameters and their values that you wish to be
                      returned in the post sale request or final redirection.
  :complus         => Field to submit a value you wish to be returned in the post sale request or output.
  :language        => Customer's language, for example: "en_EN"

Constant Summary collapse

URLS = 
{
  :order       => 'https://secure.ogone.com/ncol/%s/orderdirect.asp',
  :maintenance => 'https://secure.ogone.com/ncol/%s/maintenancedirect.asp'
}
CVV_MAPPING = 
{ 'OK' => 'M',
'KO' => 'N',
'NO' => 'P' }
AVS_MAPPING = 
{ 'OK' => 'M',
'KO' => 'N',
'NO' => 'R' }
SUCCESS_MESSAGE = 
"The transaction was successful"
THREE_D_SECURE_DISPLAY_WAYS = 
{ :main_window => 'MAINW',  # display the identification page in the main window
                          # (default value).
:pop_up      => 'POPUP',  # display the identification page in a pop-up window
                          # and return to the main window at the end.
:pop_ix      => 'POPIX' }
OGONE_NO_SIGNATURE_DEPRECATION_MESSAGE =

display the identification page in a pop-up window and remain in the pop-up window.

"Signature usage will be the default for a future release of ActiveMerchant. You should either begin using it, or update your configuration to explicitly disable it (signature_encryptor: none)"
OGONE_STORE_OPTION_DEPRECATION_MESSAGE = 
"The 'store' option has been renamed to 'billing_id', and its usage is deprecated."

Constants inherited from Gateway

Gateway::CREDIT_DEPRECATION_MESSAGE, Gateway::CURRENCIES_WITHOUT_FRACTIONS, Gateway::DEBIT_CARDS

Instance Attribute Summary

Attributes inherited from Gateway

#options

Instance Method Summary collapse

Methods inherited from Gateway

#card_brand, card_brand, inherited, supports?, #test?

Methods included from CreditCardFormatting

#format

Constructor Details

#initialize(options = {}) ⇒ OgoneGateway

Returns a new instance of OgoneGateway.



139
140
141
142
 
# File 'lib/active_merchant/billing/gateways/ogone.rb', line 139

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

Instance Method Details

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

Verify and reserve the specified amount on the account, without actually doing the transaction.



145
146
147
148
149
150
151
152
153
 
# File 'lib/active_merchant/billing/gateways/ogone.rb', line 145

def authorize(money, payment_source, options = {})
  post = {}
  add_invoice(post, options)
  add_payment_source(post, payment_source, options)
  add_address(post, payment_source, options)
  add_customer_data(post, options)
  add_money(post, money, options)
  commit('RES', post)
end

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

Complete a previously authorized transaction.



167
168
169
170
171
172
173
174
 
# File 'lib/active_merchant/billing/gateways/ogone.rb', line 167

def capture(money, authorization, options = {})
  post = {}
  add_authorization(post, reference_from(authorization))
  add_invoice(post, options)
  add_customer_data(post, options)
  add_money(post, money, options)
  commit('SAL', post)
end

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

Credit the specified account by a specific amount.



184
185
186
187
188
189
190
191
192
 
# File 'lib/active_merchant/billing/gateways/ogone.rb', line 184

def credit(money, identification_or_credit_card, options = {})
  if reference_transaction?(identification_or_credit_card)
    deprecated CREDIT_DEPRECATION_MESSAGE
    # Referenced credit: refund of a settled transaction
    refund(money, identification_or_credit_card, options)
  else # must be a credit card or card reference
    perform_non_referenced_credit(money, identification_or_credit_card, options)
  end
end

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

Verify and transfer the specified amount.



156
157
158
159
160
161
162
163
164
 
# File 'lib/active_merchant/billing/gateways/ogone.rb', line 156

def purchase(money, payment_source, options = {})
  post = {}
  add_invoice(post, options)
  add_payment_source(post, payment_source, options)
  add_address(post, payment_source, options)
  add_customer_data(post, options)
  add_money(post, money, options)
  commit('SAL', post)
end

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

Refund of a settled transaction



195
196
197
 
# File 'lib/active_merchant/billing/gateways/ogone.rb', line 195

def refund(money, reference, options = {})
  perform_reference_credit(money, reference, options)
end

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

Store a credit card by creating an Ogone Alias



200
201
202
203
204
205
 
# File 'lib/active_merchant/billing/gateways/ogone.rb', line 200

def store(payment_source, options = {})
  options.merge!(:alias_operation => 'BYOGONE') unless options.has_key?(:billing_id) || options.has_key?(:store)
  response = authorize(1, payment_source, options)
  void(response.authorization) if response.success?
  response
end

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

Cancels a previously authorized transaction.



177
178
179
180
181
 
# File 'lib/active_merchant/billing/gateways/ogone.rb', line 177

def void(identification, options = {})
  post = {}
  add_authorization(post, reference_from(identification))
  commit('DES', post)
end