Class/Module Index [+]

Quicksearch

ActiveMerchant::Billing::NetRegistryGateway

Gateway for netregistry.com.au.

Note that NetRegistry itself uses gateway service providers. At the time of this writing, there are at least two (Quest and Ingenico). This module has only been tested with Quest.

Also note that NetRegistry does not offer a test mode, nor does it have support for the authorize/capture/void functionality by default (you may arrange for this as described in “Programming for NetRegistry’s E-commerce Gateway.” [rubyurl.com/hNG]), and no void functionality is documented. As a result, the authorize and capture have not yet been tested through a live gateway, and void will raise an error.

If you have this functionality enabled, please consider contributing to ActiveMerchant by writing tests/code for these methods, and submitting a patch.

In addition to the standard ActiveMerchant functionality, the response will contain a ‘receipt’ parameter (response.params) if a receipt was issued by the gateway.

Public Class Methods

new(options = {}) click to toggle source

Create a new NetRegistry gateway.

Options :login and :password must be given.

# File lib/active_merchant/billing/gateways/net_registry.rb, line 50
def initialize(options = {})
  requires!(options, :login, :password)
  @options = options
  super
end

Public Instance Methods

authorize(money, credit_card, options = {}) click to toggle source

Note that authorize and capture only work if your account vendor is St George, and if your account has been setup as described in “Programming for NetRegistry’s E-commerce Gateway.” [rubyurl.com/hNG]

# File lib/active_merchant/billing/gateways/net_registry.rb, line 60
def authorize(money, credit_card, options = {})
  params = {
    'AMOUNT'  => amount(money),
    'CCNUM'   => credit_card.number,
    'CCEXP'   => expiry(credit_card)
  }
  add_request_details(params, options)
  commit(:authorization, params)
end
capture(money, authorization, options = {}) click to toggle source

Note that authorize and capture only work if your account vendor is St George, and if your account has been setup as described in “Programming for NetRegistry’s E-commerce Gateway.” [rubyurl.com/hNG]

# File lib/active_merchant/billing/gateways/net_registry.rb, line 74
def capture(money, authorization, options = {})
  requires!(options, :credit_card)
  credit_card = options[:credit_card]

  params = {
    'PREAUTHNUM' => authorization,
    'AMOUNT'     => amount(money),
    'CCNUM'      => credit_card.number,
    'CCEXP'      => expiry(credit_card)
  }
  add_request_details(params, options)
  commit(:capture, params)
end
credit(money, identification, options = {}) click to toggle source
# File lib/active_merchant/billing/gateways/net_registry.rb, line 98
def credit(money, identification, options = {})
  params = {
    'AMOUNT'  => amount(money),
    'TXNREF'  => identification
  }
  add_request_details(params, options)
  commit(:credit, params)
end
purchase(money, credit_card, options = {}) click to toggle source
# File lib/active_merchant/billing/gateways/net_registry.rb, line 88
def purchase(money, credit_card, options = {})
  params = {
    'AMOUNT'  => amount(money),
    'CCNUM'   => credit_card.number,
    'CCEXP'   => expiry(credit_card)
  }
  add_request_details(params, options)
  commit(:purchase, params)
end
status(identification) click to toggle source

Specific to NetRegistry.

Run a ‘status’ command. This lets you view the status of a completed transaction.

# File lib/active_merchant/billing/gateways/net_registry.rb, line 112
def status(identification)
  params = {
    'TXNREF'  => identification
  }
  
  commit(:status, params)
end

[Validate]

Generated with the Darkfish Rdoc Generator 2.