SystemPay

SystemPay is a gem to ease credit card payment with Natixis Paiements / CyberplusPaiement (Banque Populaire) bank system. It's a Ruby on Rails port of the connexion kits published by the bank.

• Gem Homepage : http://github.com/iMenlo/system_pay
• Cyberplus SystemPay documentation : https://systempay.cyberpluspaiement.com

INSTALL

gem install system_pay

or, in your Gemfile

gem 'system_pay'

USAGE

Create a config yml data file to store your site_id and certificates values:

in config/system_pay.yml:

development:
  vads_site_id: '00000000'
  certificat: '0000000000000000'
  vads_validation_mode: 1
  vads_shop_name: 'My shop'
  vads_shop_url: 'www.example.com'
test:
  vads_site_id: '00000000'
  certificat: '0000000000000000'
  vads_validation_mode: 1
  vads_shop_name: 'My shop'
  vads_shop_url: 'www.example.com'
production:
  vads_site_id: '00000000'
  certificat: '0000000000000000'
  vads_validation_mode: 0
  vads_shop_name: 'My shop'
  vads_shop_url: 'www.example.com'
  vads_ctx_mode: PRODUCTION

# NB: you can place here any of the class variables

in order controller :

@system_pay = SystemPay::Vads.new(:amount => @order.amount_in_cents, :trans_id => @order.id)
# NB: nil instance variables are ignored (not transmitted to the bank server)

in order view :

= form_tag @system_pay.target_url do
  = system_pay_hidden_fields(@system_pay)
  = submit_tag "Access to the bank website"

in a controller for call back from the bank :

class OrderTransactionsController < ApplicationController

  protect_from_forgery :except => [:bank_callback]

  def bank_callback
    @transaction = Transaction.where(:order_id => params[:vads_order_id], :state => ['sent', 'ready']).first if params[:vads_order_id] =~ /^[\d-]+$/
    unless @transaction
      logger.info "bank_callback ignored: no transaction matching order_id '#{params[:vads_order_id]}'."
    else
      # store whatever returned parameters you need, at least the payment_certificate:
      @transaction.payment_certificate  = params[:vads_payment_certificate]
      @transaction.result               = params[:vads_result].to_i
      @transaction.auth_result          = params[:vads_auth_result].to_i
      @transaction.extra_result         = params[:vads_extra_result].to_i
      @transaction.warranty_result      = params[:vads_warranty_result]
      @transaction.card_brand           = params[:vads_card_brand]
      begin
        @transaction.expiry_date        = DateTime.new(params[:vads_expiry_year].to_i, params[:vads_expiry_month].to_i, 1)
      rescue
        @transaction.expiry_date        = DateTime.now
      end

      # or store all returned parameters as text:
      @transaction.returned_params      = params.to_a.sort.map{|k,v| "#{k}: #{v}"}.join("\n")

      # get transaction result
      @result = SystemPay::Vads.diagnose(params)

      # store
      @transaction.tech_msg = @result[:tech_msg]
      @transaction.user_msg  = @result[:user_msg]
      @transaction.save

      # change state
      case @result[:status]
      when :success
        @transaction.success!
      when :cancel
        @transaction.cancel!
      when :error
        @transaction.error!
      when :bad_params
        @transaction.error!
      end
    end

    render :text => "Pragma: no-cache\nContent-type: text/plain\n\nversion=V2\nOK"
  end

Thanks

This gem is inspired by Novelys paiement_cic, many thanks to the team.

License

Copyright (c) 2012 iMenlo Team, released under the MIT license