Class: ActiveMerchant::Billing::AuthorizeNetCimGateway

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

Overview

Customer Information Manager (CIM)

The Authorize.Net Customer Information Manager (CIM) is an optional additional service that allows you to store sensitive payment information on Authorize.Net’s servers, simplifying payments for returning customers and recurring transactions. It can also help with Payment Card Industry (PCI) Data Security Standard compliance, since customer data is no longer stored locally.

To use the AuthorizeNetCimGateway CIM must be enabled for your account.

Information about CIM is available on the Authorize.Net website. Information about the CIM API is available at the Authorize.Net Integration Center

Login and Password

The login and password are not the username and password you use to login to the Authorize.Net Merchant Interface. Instead, you will use the API Login ID as the login and Transaction Key as the password.

How to Get Your API Login ID and Transaction Key

  1. Log into the Merchant Interface

  2. Select Settings from the Main Menu

  3. Click on API Login ID and Transaction Key in the Security section

  4. Type in the answer to the secret question configured on setup

  5. Click Submit

Constant Summary collapse

AUTHORIZE_NET_CIM_NAMESPACE =
'AnetApi/xml/v1/schema/AnetApiSchema.xsd'
CIM_ACTIONS =
{
  create_customer_profile: 'createCustomerProfile',
  create_customer_payment_profile: 'createCustomerPaymentProfile',
  create_customer_shipping_address: 'createCustomerShippingAddress',
  get_customer_profile: 'getCustomerProfile',
  get_customer_profile_ids: 'getCustomerProfileIds',
  get_customer_payment_profile: 'getCustomerPaymentProfile',
  get_customer_shipping_address: 'getCustomerShippingAddress',
  delete_customer_profile: 'deleteCustomerProfile',
  delete_customer_payment_profile: 'deleteCustomerPaymentProfile',
  delete_customer_shipping_address: 'deleteCustomerShippingAddress',
  update_customer_profile: 'updateCustomerProfile',
  update_customer_payment_profile: 'updateCustomerPaymentProfile',
  update_customer_shipping_address: 'updateCustomerShippingAddress',
  create_customer_profile_transaction: 'createCustomerProfileTransaction',
  validate_customer_payment_profile: 'validateCustomerPaymentProfile'
}
CIM_TRANSACTION_TYPES =
{
  auth_capture: 'profileTransAuthCapture',
  auth_only: 'profileTransAuthOnly',
  capture_only: 'profileTransCaptureOnly',
  prior_auth_capture: 'profileTransPriorAuthCapture',
  refund: 'profileTransRefund',
  void: 'profileTransVoid'
}
CIM_VALIDATION_MODES =
{
  none: 'none',
  test: 'testMode',
  live: 'liveMode',
  old: 'oldLiveMode'
}
BANK_ACCOUNT_TYPES =
{
  checking: 'checking',
  savings: 'savings',
  business_checking: 'businessChecking'
}
ECHECK_TYPES =
{
  ccd: 'CCD',
  ppd: 'PPD',
  web: 'WEB'
}

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, #scrub, #supported_countries, supported_countries, supported_countries=, supports?, #supports_network_tokenization?, #supports_scrubbing?, #test?

Methods included from CreditCardFormatting

#format

Methods included from PostsData

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

Constructor Details

#initialize(options = {}) ⇒ AuthorizeNetCimGateway

Creates a new AuthorizeNetCimGateway

The gateway requires that a valid API Login ID and Transaction Key be passed in the options hash.

Options

  • :login – The Authorize.Net API Login ID (REQUIRED)

  • :password – The Authorize.Net Transaction Key. (REQUIRED)

  • :testtrue or false. If true, perform transactions against the test server. Otherwise, perform transactions against the production server.

  • :test_requeststrue or false. If true, perform transactions without the test flag. This is useful when you need to generate card declines, AVS or CVV errors. Will hold the same value as :test by default.

  • :delimiter – The delimiter used in the direct response. Default is ‘,’ (comma).



102
103
104
105
106
# File 'lib/active_merchant/billing/gateways/authorize_net_cim.rb', line 102

def initialize(options = {})
  requires!(options, :login, :password)
  super
  @options[:test_requests] = test? if @options[:test_requests].nil?
end

Instance Method Details

#create_customer_payment_profile(options) ⇒ Object

Creates a new customer payment profile for an existing customer profile.

Options

  • :customer_profile_id – The Customer Profile ID of the customer the payment profile will be added to. (REQUIRED)

  • :payment_profile – A hash containing the elements of the new payment profile (REQUIRED)

Payment Profile

  • :payment – A hash containing information on payment. Either :credit_card or :bank_account (REQUIRED)



151
152
153
154
155
156
157
158
# File 'lib/active_merchant/billing/gateways/authorize_net_cim.rb', line 151

def create_customer_payment_profile(options)
  requires!(options, :customer_profile_id)
  requires!(options, :payment_profile)
  requires!(options[:payment_profile], :payment)

  request = build_request(:create_customer_payment_profile, options)
  commit(:create_customer_payment_profile, request)
end

#create_customer_profile(options) ⇒ Object

Creates a new customer profile along with any customer payment profiles and customer shipping addresses for the customer profile.

Returns a Response with the Customer Profile ID of the new customer profile in the authorization field. It is CRITICAL that you save this ID. There is no way to retrieve this through the API. You will not be able to create another Customer Profile with the same information.

Options

  • :profile – A hash containing at least one of the CONDITIONAL profile options below (REQUIRED)

Profile

  • :email – Email address associated with the customer profile (CONDITIONAL)

  • :description – Description of the customer or customer profile (CONDITIONAL)

  • :merchant_customer_id – Merchant assigned ID for the customer (CONDITIONAL)

  • :payment_profile – A hash containing the elements of the new payment profile (optional)

Payment Profile

  • :payment – A hash containing information on payment. Either :credit_card or :bank_account (optional)



131
132
133
134
135
136
137
138
139
# File 'lib/active_merchant/billing/gateways/authorize_net_cim.rb', line 131

def create_customer_profile(options)
  requires!(options, :profile)
  requires!(options[:profile], :email) unless options[:profile][:merchant_customer_id] || options[:profile][:description]
  requires!(options[:profile], :description) unless options[:profile][:email] || options[:profile][:merchant_customer_id]
  requires!(options[:profile], :merchant_customer_id) unless options[:profile][:description] || options[:profile][:email]

  request = build_request(:create_customer_profile, options)
  commit(:create_customer_profile, request)
end

#create_customer_profile_transaction(options) ⇒ Object

Creates a new payment transaction from an existing customer profile

This is what is used to charge a customer whose information you have stored in a Customer Profile.

Returns a Response object that contains the result of the transaction in params['direct_response']

Options

  • :transaction – A hash containing information on the transaction that is being requested. (REQUIRED)

Transaction

  • :type – The type of transaction. Can be either :auth_only, :capture_only, :auth_capture, :prior_auth_capture, :refund or :void. (REQUIRED)

  • :amount – The amount for the transaction. Formatted with a decimal. For example “4.95” (CONDITIONAL)

    - :type == :void (NOT USED)
    - :type == :refund (OPTIONAL)
    - :type == (:auth_only, :capture_only, :auth_capture, :prior_auth_capture) (REQUIRED)
    
  • :customer_profile_id – The Customer Profile ID of the customer to use in this transaction. (CONDITIONAL)

    - :type == (:void, :prior_auth_capture) (OPTIONAL)
    - :type == :refund (CONDITIONAL - required if masked information is not being submitted [see below])
    - :type == (:auth_only, :capture_only, :auth_capture) (REQUIRED)
    
  • :customer_payment_profile_id – The Customer Payment Profile ID of the Customer Payment Profile to use in this transaction. (CONDITIONAL)

    - :type == (:void, :prior_auth_capture) (OPTIONAL)
    - :type == :refund (CONDITIONAL - required if masked information is not being submitted [see below])
    - :type == (:auth_only, :capture_only, :auth_capture) (REQUIRED)
    
  • :trans_id – The payment gateway assigned transaction ID of the original transaction (CONDITIONAL):

    - :type = (:void, :refund, :prior_auth_capture) (REQUIRED)
    - :type = (:auth_only, :capture_only, :auth_capture) (NOT USED)
    
  • :card_code – CVV/CCV code (OPTIONAL)

    - :type = (:void, :refund, :prior_auth_capture) (NOT USED)
    - :type = (:auth_only, :capture_only, :auth_capture) (OPTIONAL)
    
  • :recurring_billing – The recurring billing status (OPTIONAL)

    - :type = (:void, :refund, :prior_auth_capture) (NOT USED)
    - :type = (:auth_only, :capture_only, :auth_capture) (OPTIONAL)
    
  • :customer_shipping_address_id – Payment gateway assigned ID associated with the customer shipping address (CONDITIONAL)

    - :type = (:void, :refund) (OPTIONAL)
    - :type = (:auth_only, :capture_only, :auth_capture) (NOT USED)
    - :type = (:prior_auth_capture) (OPTIONAL)
    

For :type == :refund only

  • :credit_card_number_masked – (CONDITIONAL - required for credit card refunds if :customer_profile_id AND :customer_payment_profile_id are missing)

  • :bank_routing_number_masked && :bank_account_number_masked – (CONDITIONAL - required for electronic check refunds if :customer_profile_id AND :customer_payment_profile_id are missing) (NOT ABLE TO TEST - I keep getting “ACH transactions are not accepted by this merchant.” when trying to make a payment and, until that’s possible I can’t refund ([email protected]))



379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
# File 'lib/active_merchant/billing/gateways/authorize_net_cim.rb', line 379

def create_customer_profile_transaction(options)
  requires!(options, :transaction)
  requires!(options[:transaction], :type)
  case options[:transaction][:type]
  when :void
    requires!(options[:transaction], :trans_id)
  when :refund
    requires!(options[:transaction], :trans_id) &&
      (
        (options[:transaction][:customer_profile_id] && options[:transaction][:customer_payment_profile_id]) ||
        options[:transaction][:credit_card_number_masked] ||
        (options[:transaction][:bank_routing_number_masked] && options[:transaction][:bank_account_number_masked])
      )
  when :prior_auth_capture
    requires!(options[:transaction], :amount, :trans_id)
  else
    requires!(options[:transaction], :amount, :customer_profile_id, :customer_payment_profile_id)
  end
  request = build_request(:create_customer_profile_transaction, options)
  commit(:create_customer_profile_transaction, request)
end

#create_customer_profile_transaction_for_refund(options) ⇒ Object

Creates a new payment transaction for refund from an existing customer profile

This is what is used to refund a transaction you have stored in a Customer Profile.

Returns a Response object that contains the result of the transaction in params['direct_response']

Options

  • :transaction – A hash containing information on the transaction that is being requested. (REQUIRED)

Transaction

  • :amount – The total amount to be refunded (REQUIRED)

  • :customer_profile_id – The Customer Profile ID of the customer to use in this transaction. (CONDITIONAL :customer_payment_profile_id must be included if used)

  • :customer_payment_profile_id – The Customer Payment Profile ID of the Customer Payment Profile to use in this transaction. (CONDITIONAL :customer_profile_id must be included if used)

  • :credit_card_number_masked – Four Xs followed by the last four digits of the credit card (CONDITIONAL - used if customer_profile_id and customer_payment_profile_id aren’t given)

  • :bank_routing_number_masked – The last four digits of the routing number to be refunded (CONDITIONAL - must be used with :bank_account_number_masked)

  • :bank_account_number_masked – The last four digits of the bank account number to be refunded, Ex. XXXX1234 (CONDITIONAL - must be used with :bank_routing_number_masked)

  • :tax - A hash containing tax information for the refund (OPTIONAL - :amount, :name (31 characters), :description (255 characters))

  • :duty - A hash containing duty information for the refund (OPTIONAL - :amount, :name (31 characters), :description (255 characters))

  • :shipping - A hash containing shipping information for the refund (OPTIONAL - :amount, :name (31 characters), :description (255 characters))



426
427
428
429
430
431
432
433
# File 'lib/active_merchant/billing/gateways/authorize_net_cim.rb', line 426

def create_customer_profile_transaction_for_refund(options)
  requires!(options, :transaction)
  options[:transaction][:type] = :refund
  requires!(options[:transaction], :trans_id)
  requires!(options[:transaction], :amount)
  request = build_request(:create_customer_profile_transaction, options)
  commit(:create_customer_profile_transaction, request)
end

#create_customer_profile_transaction_for_void(options) ⇒ Object

Creates a new payment transaction for void from an existing customer profile

This is what is used to void a transaction you have stored in a Customer Profile.

Returns a Response object that contains the result of the transaction in params['direct_response']

Options

  • :transaction – A hash containing information on the transaction that is being requested. (REQUIRED)

Transaction

  • :trans_id – The payment gateway assigned transaction id of the original transaction. (REQUIRED)

  • :customer_profile_id – The Customer Profile ID of the customer to use in this transaction.

  • :customer_payment_profile_id – The Customer Payment Profile ID of the Customer Payment Profile to use in this transaction.

  • :customer_shipping_address_id – Payment gateway assigned ID associated with the customer shipping address.



451
452
453
454
455
456
457
# File 'lib/active_merchant/billing/gateways/authorize_net_cim.rb', line 451

def create_customer_profile_transaction_for_void(options)
  requires!(options, :transaction)
  options[:transaction][:type] = :void
  requires!(options[:transaction], :trans_id)
  request = build_request(:create_customer_profile_transaction, options)
  commit(:create_customer_profile_transaction, request)
end

#create_customer_shipping_address(options) ⇒ Object

Creates a new customer shipping address for an existing customer profile.

Options

  • :customer_profile_id – The Customer Profile ID of the customer the payment profile will be added to. (REQUIRED)

  • :address – A hash containing the elements of the shipping address (REQUIRED)



166
167
168
169
170
171
172
# File 'lib/active_merchant/billing/gateways/authorize_net_cim.rb', line 166

def create_customer_shipping_address(options)
  requires!(options, :customer_profile_id)
  requires!(options, :address)

  request = build_request(:create_customer_shipping_address, options)
  commit(:create_customer_shipping_address, request)
end

#delete_customer_payment_profile(options) ⇒ Object

Deletes a customer payment profile from an existing customer profile.

Options

  • :customer_profile_id – The Customer Profile ID of the customer with the payment profile to be deleted. (REQUIRED)

  • :customer_payment_profile_id – The Payment Profile ID of the payment profile to be deleted. (REQUIRED)



192
193
194
195
196
197
198
# File 'lib/active_merchant/billing/gateways/authorize_net_cim.rb', line 192

def delete_customer_payment_profile(options)
  requires!(options, :customer_profile_id)
  requires!(options, :customer_payment_profile_id)

  request = build_request(:delete_customer_payment_profile, options)
  commit(:delete_customer_payment_profile, request)
end

#delete_customer_profile(options) ⇒ Object

Deletes an existing customer profile along with all associated customer payment profiles and customer shipping addresses.

Options

  • :customer_profile_id – The Customer Profile ID of the customer to be deleted. (REQUIRED)



179
180
181
182
183
184
# File 'lib/active_merchant/billing/gateways/authorize_net_cim.rb', line 179

def delete_customer_profile(options)
  requires!(options, :customer_profile_id)

  request = build_request(:delete_customer_profile, options)
  commit(:delete_customer_profile, request)
end

#delete_customer_shipping_address(options) ⇒ Object

Deletes a customer shipping address from an existing customer profile.

Options

  • :customer_profile_id – The Customer Profile ID of the customer with the payment profile to be deleted. (REQUIRED)

  • :customer_address_id – The Shipping Address ID of the shipping address to be deleted. (REQUIRED)



206
207
208
209
210
211
212
# File 'lib/active_merchant/billing/gateways/authorize_net_cim.rb', line 206

def delete_customer_shipping_address(options)
  requires!(options, :customer_profile_id)
  requires!(options, :customer_address_id)

  request = build_request(:delete_customer_shipping_address, options)
  commit(:delete_customer_shipping_address, request)
end

#get_customer_payment_profile(options) ⇒ Object

Retrieve a customer payment profile for an existing customer profile.

Returns a Response whose params hash contains all the payment profile information. Sensitive information such as credit card numbers will be masked.

Options

  • :customer_profile_id – The Customer Profile ID of the customer with the payment profile to be retrieved. (REQUIRED)

  • :customer_payment_profile_id – The Payment Profile ID of the payment profile to be retrieved. (REQUIRED)



242
243
244
245
246
247
248
# File 'lib/active_merchant/billing/gateways/authorize_net_cim.rb', line 242

def get_customer_payment_profile(options)
  requires!(options, :customer_profile_id)
  requires!(options, :customer_payment_profile_id)

  request = build_request(:get_customer_payment_profile, options)
  commit(:get_customer_payment_profile, request)
end

#get_customer_profile(options) ⇒ Object

Retrieves an existing customer profile along with all the associated customer payment profiles and customer shipping addresses.

Returns a Response whose params hash contains all the profile information.

Options

  • :customer_profile_id – The Customer Profile ID of the customer to retrieve. (REQUIRED)



221
222
223
224
225
226
# File 'lib/active_merchant/billing/gateways/authorize_net_cim.rb', line 221

def get_customer_profile(options)
  requires!(options, :customer_profile_id)

  request = build_request(:get_customer_profile, options)
  commit(:get_customer_profile, request)
end

#get_customer_profile_ids(options = {}) ⇒ Object



228
229
230
231
# File 'lib/active_merchant/billing/gateways/authorize_net_cim.rb', line 228

def get_customer_profile_ids(options = {})
  request = build_request(:get_customer_profile_ids, options)
  commit(:get_customer_profile_ids, request)
end

#get_customer_shipping_address(options) ⇒ Object

Retrieve a customer shipping address for an existing customer profile.

Returns a Response whose params hash contains all the shipping address information.

Options

  • :customer_profile_id – The Customer Profile ID of the customer with the payment profile to be retrieved. (REQUIRED)

  • :customer_address_id – The Shipping Address ID of the shipping address to be retrieved. (REQUIRED)



258
259
260
261
262
263
264
# File 'lib/active_merchant/billing/gateways/authorize_net_cim.rb', line 258

def get_customer_shipping_address(options)
  requires!(options, :customer_profile_id)
  requires!(options, :customer_address_id)

  request = build_request(:get_customer_shipping_address, options)
  commit(:get_customer_shipping_address, request)
end

#update_customer_payment_profile(options) ⇒ Object

Updates a customer payment profile for an existing customer profile.

Warning: if you do not provide a parameter in the :payment_profile hash, it is automatically set to nil at Authorize.Net. You will most likely want to first get the profile hash using get_customer_payment_profile and then only change the elements you wish to change.

Options

  • :customer_profile_id – The Customer Profile ID of the customer with the payment profile to be updated. (REQUIRED)

  • :payment_profile – A hash containing the values the Customer Payment Profile should be updated to. (REQUIRED)

Payment Profile

  • :customer_payment_profile_id – The Customer Payment Profile ID of the Customer Payment Profile to update. (REQUIRED)



301
302
303
304
305
306
307
# File 'lib/active_merchant/billing/gateways/authorize_net_cim.rb', line 301

def update_customer_payment_profile(options)
  requires!(options, :customer_profile_id, :payment_profile)
  requires!(options[:payment_profile], :customer_payment_profile_id)

  request = build_request(:update_customer_payment_profile, options)
  commit(:update_customer_payment_profile, request)
end

#update_customer_profile(options) ⇒ Object

Updates an existing customer profile.

Warning: if you do not provide a parameter in the :payment_profile hash, it is automatically set to nil at Authorize.Net. You will most likely want to first get the profile hash using get_customer_profile and then only change the elements you wish to change.

Options

  • :profile – A hash containing the values the Customer Profile should be updated to. (REQUIRED)

Profile

  • :customer_profile_id – The Customer Profile ID of the customer profile to update. (REQUIRED)



279
280
281
282
283
284
285
# File 'lib/active_merchant/billing/gateways/authorize_net_cim.rb', line 279

def update_customer_profile(options)
  requires!(options, :profile)
  requires!(options[:profile], :customer_profile_id)

  request = build_request(:update_customer_profile, options)
  commit(:update_customer_profile, request)
end

#update_customer_shipping_address(options) ⇒ Object

Updates a customer shipping address for an existing customer profile.

Warning: if you do not provide a parameter in the :address hash, it is automatically set to nil at Authorize.Net. You will most likely want to first get the profile hash using get_customer_shipping_address and then only change the elements you wish to change.

Options

  • :customer_profile_id – The Customer Profile ID of the customer with the payment profile to be updated. (REQUIRED)

  • :address – A hash containing the values the Customer Shipping Address should be updated to. (REQUIRED)

Address

  • :customer_address_id – The Customer Address ID of the Customer Payment Profile to update. (REQUIRED)



323
324
325
326
327
328
329
# File 'lib/active_merchant/billing/gateways/authorize_net_cim.rb', line 323

def update_customer_shipping_address(options)
  requires!(options, :customer_profile_id, :address)
  requires!(options[:address], :customer_address_id)

  request = build_request(:update_customer_shipping_address, options)
  commit(:update_customer_shipping_address, request)
end

#validate_customer_payment_profile(options) ⇒ Object

Verifies an existing customer payment profile by generating a test transaction

Returns a Response object that contains the result of the transaction in params['direct_response']

Options

  • :customer_profile_id – The Customer Profile ID of the customer to use in this transaction. (REQUIRED)

  • :customer_payment_profile_id – The Customer Payment Profile ID of the Customer Payment Profile to be verified. (REQUIRED)

  • :customer_address_id – The Customer Address ID of the Customer Shipping Address to be verified. (OPTIONAL)

  • :card_code – If the payment profile is a credit card, the CCV/CVV code to validate with (OPTIONAL)

  • :validation_mode:live or :test In Test Mode, only field validation is performed. (REQUIRED In Live Mode, a transaction is generated and submitted to the processor with the amount of $0.01. If successful, the transaction is immediately voided. (REQUIRED)



471
472
473
474
475
476
# File 'lib/active_merchant/billing/gateways/authorize_net_cim.rb', line 471

def validate_customer_payment_profile(options)
  requires!(options, :customer_profile_id, :customer_payment_profile_id, :validation_mode)

  request = build_request(:validate_customer_payment_profile, options)
  commit(:validate_customer_payment_profile, request)
end