Method: ActiveMerchant::Billing::UsaEpayAdvancedGateway#run_transaction

Defined in:
lib/active_merchant/billing/gateways/usa_epay_advanced.rb

#run_transaction(options = {}) ⇒ Object

Run a transaction.

Note: run_sale, run_auth_only, run_credit, run_check_sale, run_check_credit methods are also available. Each takes the same options as run_transaction, but the :command option is not required.

Recurring Note: If recurring options are included USA ePay will create a new customer record with the supplied information. The customer number will be returned in the response.

Options

  • :payment_method – credit_card or check

  • :command – sale, credit, void, creditvoid, authonly, capture, postauth, check, checkcredit; defaults to sale; only required for run_transaction when other than sale

  • :reference_number – for the original transaction; obtained by sale or authonly

  • :authorization_code – required for postauth; obtained offline

  • :ignore_duplicate – set true if you want to override the duplicate transaction handling

  • :account_holder – name of account holder

  • :customer_id – merchant assigned id

  • :customer_receipt – set true to email receipt to billing email address

  • :customer_template – name of template

  • :software – stamp merchant software version for tracking

  • :billing_address – see UsaEpayCimGateway documentation for all address fields

  • :shipping_address – see UsaEpayCimGateway documentation for all address fields

  • :recurring – used for recurring billing transactions

    • :schedule – disabled, daily, weekly, bi-weekly (every two weeks), monthly, bi-monthly (every two months), quarterly, bi-annually (every six months), annually

    • :next – date customer billed next (Date/Time)

    • :expire – date the recurring transactions end (Date/Time)

    • :number_left – transactions remaining in billing cycle

    • :amount – amount to be billed each recurring transaction

    • :enabled – states if currently active

  • :line_items – XXX not implemented yet

  • :custom_fields – XXX not implemented yet

Transaction Options

  • :amount – total amount

  • :invoice – transaction invoice number; truncated to 10 characters; defaults to reference_number

  • :po_number – commercial purchase order number; upto 25 characters

  • :order_id – should be used to assign a unique id; upto 64 characters

  • :clerk – sales clerk

  • :terminal – terminal name

  • :table – table name/number

  • :description – description

  • :comments – comments

  • :allow_partial_auth – allow partial authorization if full amount is not available; defaults false

  • :currency – numeric currency code

  • :tax – tax portion of amount

  • :tip – tip portion of amount

  • :non_tax – true if transaction is non-taxable

  • :shipping – shipping portion of amount

  • :discount – amount of discount

  • :subtotal – amount of transaction before tax, tip, shipping, and discount are applied

Response

  • #message – transaction response hash



674
675
676
677
 
# File 'lib/active_merchant/billing/gateways/usa_epay_advanced.rb', line 674

def run_transaction(options = {})
  request = build_request(__method__, options)
  commit(__method__, request)
end