Veritrans VT-Web Ruby wrapper

Ruby Wrapper for Veritrans VT-Web. Visit https://www.veritrans.co.id for more information about the product and see documentation at http://docs.veritrans.co.id/vtweb/index.html for more technical details.

Installation

Add this line to your application's Gemfile:

gem 'vtweb'

And then execute:

$ bundle

Or install it yourself as:

$ gem install vtweb

Usage

In your Rails app, create 'vtweb.yml' at config directory (config/vtweb.yml) with this code:

development:
  merchant_id: "T100000000000001XXXXXX"
  merchant_hash_key: "yourmerchanthashkey"
  unfinish_payment_return_url: "http://localhost:3000/cancel_pay"
  finish_payment_return_url: "http://localhost:3000/finish"
  error_payment_return_url: "http://localhost:3000/error"
  vtweb_server: "http://127.0.0.1:4000"

production:
  merchant_id: "A100000000000001XXXXXX"
  merchant_hash_key: "yourmerchanthashkey"
  unfinish_payment_return_url: "http://yourweb.com/canceled"
  finish_payment_return_url: "http://yourweb.com/thank_you"
  error_payment_return_url: "http://yourweb.com/shop_again"

Create a file in 'config/initializers' to set config to vtweb.yml, for example 'store_config.rb':

raw_config = File.read("#{Rails.root}/config/vtweb.yml")
CONFIG = YAML.load(raw_config)[Rails.env].symbolize_keys

In your controller, create a method to use the gem. I took the code from https://github.com/veritrans/veritrans-rails-sample-cart for the example with some modification:

def confirm
  client = ::Vtweb::Client.new
  client.order_id     = SecureRandom.hex(5)
  client.merchant_hash_key = CONFIG[:merchant_hash_key]

  # Example 
  @carts = Cart.all
  @total = Cart.select(:sub_total).sum(:sub_total)

  params["item"] = []    

  @carts.each do |item|
    params["item"] << { "item_id" => item.product_id, "price" => item.product.price.to_s, "quantity" => item.quantity.to_s, 
                              "item_name1" => item.product.name, "item_name2" => item.product.name }
  end

  client.item    							= params["item"]
  client.billing_different_with_shipping 	= 1
  client.required_shipping_address 			= 1
  client.first_name    						= params[:shipping_first_name]
  client.last_name     						= params[:shipping_last_name]
  client.address1      						= params[:shipping_address1]
  client.address2      						= params[:shipping_address2]
  client.city          						= params[:shipping_city]
  client.country_code  						= "IDN"
  client.postal_code   						= params[:shipping_postal_code]
  client.phone         						= params[:shipping_phone]    
  client.shipping_first_name    			= params[:shipping_first_name]
  client.shipping_last_name     			= params[:shipping_last_name]
  client.shipping_address1      			= params[:shipping_address1]
  client.shipping_address2      			= params[:shipping_address2]
  client.shipping_city          			= params[:shipping_city]
  client.shipping_country_code  			= "IDN"
  client.shipping_postal_code   			= params[:shipping_postal_code]
  client.shipping_phone         			= params[:shipping_phone]  
  client.email 							    = params[:email] 

  # Payment Options
  client.promo_bins             			= ['411111', '510510']    
  client.enable_3d_secure      				= 1
  client.installment_banks      			= ['bni', 'cimb', 'mandiri']
  client.installment_terms      			= { bni: ['3','12','2'], cimb: ['3', '6', '12'] }
  client.point_banks            			= ['cimb', 'bni']
  client.bank                   			= 'bni'
  client.payment_methods        			= ['credit_card', 'mandiri_clickpay']

  client.get_keys
  @client = client
  render :layout => 'application'
end

After you get TOKEN_BROWSER and TOKEN_MERCHANT, you have to send a http post request merchant_id, order_id and TOKEN_BROWSER to redirection url of vtweb. This code was also taken from https://github.com/veritrans/veritrans-rails-sample-cart :

<h1 align="center">Confirm Purchase Items</h1>

<%= form_tag(@client.redirection_url, :name => "form_auto_post") do -%>
	<input type="hidden" name="merchant_id" value="<%= @client.merchant_id %>"> 
	<input type="hidden" name="order_id" value="<%= @client.order_id %>">
	<input type="hidden" name="token_browser" value="<%= @client.token["TOKEN_BROWSER"] %>">
	<table border="1" align="center" width="80%" cellpadding="10" bgcolor="#FFFFCC">
  <tr>
    <th>Name</th>
    <th>Price</th>
    <th>Quantity</th>
    <th>Sub Total</th>    
  </tr>
  
  <% for cart in @carts %>
    <tr>
      <td><%= cart.product.name %></td>
      <td><%= cart.product.price %></td>
      <td><%= cart.quantity %></td>
      <td><%= cart.sub_total %></td>
    </tr>    
  <% end %>  
  <tr>
  	<td colspan="2"></td>
  	<td style="text-align=right"><strong>Total</strong></td>
  	<td style="text-align=right"><strong><%= @total %> </strong></td>
  </tr>
	</table>
	<br><br>
	<div align="center">
	<input type="submit" value="Go to payment page">
	</div>
<% end %>

Contributing

1. Fork it http://github.com/panggi/vtweb/fork
2. Create your feature branch (git checkout -b my-new-feature)
3. Commit your changes (git commit -am 'Add some feature')
4. Push to the branch (git push origin my-new-feature)
5. Create new Pull Request