openpayu 0.0.2

checksums.yaml

@@ -0,0 +1,15 @@
+---
+!binary "U0hBMQ==":
+  metadata.gz: !binary |-
+    NmU5MTA2MGMwNmY3ZTE4ODJjOGMyODQ1NTBlZWJjMzAxZmQ1MTczMw==
+  data.tar.gz: !binary |-
+    OTQ4YWY1YzljNjFhMTE0NWEwN2IxYzNjMzZlZjM3N2RjZDQ2NWIwMQ==
+SHA512:
+  metadata.gz: !binary |-
+    ZjJlYWEwYWMxNDVjMzRjYzI5MDEyZmQzNDg3MTBlNjQyOTEyOWZhZjA4MTY5
+    ZjQ4NTdmMDY0MmEzODMyZTk4MDhkN2Y5NDQ1YTFmZTY4ZWI4Y2M5ODE3Y2Zj
+    MjFiOGYzMDQ3NzIyZjU0MTY1MmI4NGJmNTQwM2UwNGFhYzAzOTY=
+  data.tar.gz: !binary |-
+    ZGE1YzRjMjVkMTA1OTMzZTY3MWYyZTk0MmY3ZDE0YmY4YjVmYmRkNDZhMWMy
+    ZjUxYjg1YzhhZDZmY2U5ZTE3MDQzMmQ1MmUyNjgwYjc4OGI5OWE0MDJkYjQz
+    NzYwYmE5NGI3YzYzMjk3ODcxYzkzM2JlMGI2NDdhMWI5MjU4ZTU=

data/.gitignore

@@ -0,0 +1,18 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp
+dokumenty
+.DS_Store

data/.rspec

@@ -0,0 +1,3 @@
+--color
+--format documentation
+

data/.rubocop.yml

@@ -0,0 +1,45 @@
+# This is the configuration used to check the rubocop source code.
+
+MethodLength:
+  Max: 22
+
+LineLength:
+  Max: 80
+
+ClassLength:
+  Max: 140
+
+CyclomaticComplexity:
+  Max: 10
+
+Output:
+  Ignore:
+    - '^.*\.rake$'
+    - '^.*/script/.*$'
+    - '^.*/tasks/.*$'
+    - 'Rakefile$'
+    - '^.*/config/recipes/.*$'
+
+Documentation:
+  Description: 'Document classes and non-namespace modules.'
+  Enabled: false
+
+EmptyLinesAroundBody:
+  Description: "Keeps track of blank lines around expression bodies."
+  Enabled: false
+
+SymbolName:
+  Description: 'Symbol literals should use snake_case.'
+  Enabled: false
+
+BracesAroundHashParameters:
+  Description: 'Enforce braces style inside hash parameters.'
+  Enabled: false
+
+AlignParameters:
+  Description: Align the parameters of a method call if they span more than.
+  Enabled: false
+
+SignalException:
+  Description: 'Checks for proper usage of fail and raise.'
+  Enabled: false

data/.ruby-gemset

@@ -0,0 +1 @@
+openpayu_sdk_ruby

data/.ruby-version

@@ -0,0 +1 @@
+ruby-1.9.3-p194

data/.travis.yml

@@ -0,0 +1,10 @@
+language: ruby
+rvm:
+  - "1.9.2"
+  - "1.9.3"
+  - jruby-19mode # JRuby in 1.9 mode
+# uncomment this line if your project needs to run something other than `rake`:
+script: bundle exec rspec spec
+addons:
+  code_climate:
+    repo_token: a909fe634532217548c2a59fa663bb2bad564b0218993c1a6b4e2a2d97664d51

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in openpayu_ruby.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2013 Krzysztof Streflik
+
+MIT License
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,193 @@
+[![Build Status](https://magnum.travis-ci.com/PayU/openpayu_ruby_sdk.png?token=sqp5QvsmzqEqtVB3sNsK&branch=master)](https://magnum.travis-ci.com/PayU/openpayu_ruby_sdk)
+[![Code Climate](https://codeclimate.com/repos/524eb044f3ea00329815dff1/badges/885c2d52f25c02295344/gpa.png)](https://codeclimate.com/repos/524eb044f3ea00329815dff1/feed)
+
+# OpenpayuSdkRuby
+
+The OpenPayU Ruby library provides integration access to the PayU Gateway API ver. 2.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'openpayu'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install openpayu
+
+##Configure Gem
+  To configure OpenPayU environment add a file to config/initializers/openpayu.rb containing:
+
+    OpenPayU::Configuration.configure do |config|
+        config.merchant_pos_id  = '8389534'
+        config.signature_key    = '95873498573498573897fb42d'
+        config.algorithm        = 'MD5' # MD5, SHA-1, SHA-256
+        config.service_domain   = 'payu.com'
+        config.protocol         = 'https'
+        config.data_format      = 'json' # json, xml
+        config.env              = 'secure'
+        config.order_url        = 'http://localhost/order'
+        config.notify_url       = 'http://localhost/notify'
+        config.continue_url     = 'http://localhost/success'
+    end
+
+  Or by providing a path to YAML file
+
+    OpenPayU::Configuration.configure File.join(Rails.root, 'config/openpayu.yml')
+
+  Structure of YAML file:
+
+    development:
+      merchant_pos_id: '8389534'
+      signature_key: 95873498573498573897fb42d
+      algorithm: MD5 # MD5, SHA-1, SHA-256
+      service_domain: payu.com
+      protocol: https
+      data_format: json # json, xml
+      env: secure
+      order_url: http://localhost/order
+      notify_url: http://localhost/notify
+      continue_url: http://localhost/success
+    production:
+      merchant_pos_id: '8389534'
+      signature_key: 95873498573498573897fb42d
+      algorithm: MD5 # MD5, SHA-1, SHA-256
+      service_domain: payu.com
+      protocol: https
+      data_format: json # json, xml
+      env: secure
+      order_url: http://localhost/order
+      notify_url: http://localhost/notify
+      continue_url: http://localhost/success
+
+##Usage
+
+###Creating Transparent order
+  To create an order you must provide a Hash with order:
+
+    order = {
+      merchant_pos_id: "8389534",
+      customer_ip: "127.0.0.1", # You can user request.remote_ip in your controller
+      ext_order_id: 1342, #Order id in your system
+      order_url: "http://localhost/",
+      description: "New order",
+      currency_code: "PLN",
+      total_amount: 10000,
+      notify_url: "http://localhost/",
+      continue_url: "http://localhost/",
+      validity_time: '48000',
+      buyer: {
+        email: 'dd@ddd.pl',
+        phone: '123123123',
+        first_name: 'Jan',
+        last_name: 'Kowalski',
+        language: 'pl_PL',
+        NIN: "123456"
+      },
+      products: [
+        {
+          name: 'Mouse',
+          unit_price: 10000,
+          quantity: 1
+        }
+      ],
+      pay_methods: [
+        {
+          type: 'CARD_TOKEN',
+          value: 'Token value'
+        }
+      ]
+    }
+
+  When you have ready order Hash you can create new order:
+
+    @response = OpenPayU::Order.create(order)
+
+  If request succeed to create it will return "COMPLETE" as a status_code.
+  There might be also a redirect to page with confirmation.
+  There are three redirect types:
+
+  * WARNING_CONTINUE_REDIRECT
+  * WARNING_CONTINUE_CVV
+  * WARNING_CONTINUE_3DS
+
+```
+case @response.status["status_code"]
+when 'COMPLETE'
+  # order has been created
+when /WARNING_CONTINUE_/
+  #need to redirec user to a provided URL
+  redirect_to @response.redirect_uri
+else
+  #in other cases something went wrong
+  logger.info "Unable to create order. 
+    Status: #{@response.status["status_code"]}.
+    Response: #{@response}"
+end
+```
+
+###Creating Hosted order
+
+  If you pass the same Hash of order as above to hosted_order_form you will
+  get a String containgin a form to embed in your view
+
+    #in your controller
+    @order_form_data = OpenPayU.hosted_order_form(order)
+
+    # in your view
+    <%= @order_form_data.html_safe %>
+
+###Retrieving order from OpenPayU
+  You can retrieve order by its PayU order_id
+
+    @response = OpenPayU::Order.retrieve("Z963D5JQR2230925GUEST000P01")
+
+###Cancelling order 
+  You can cancel order by its PayU order_id
+
+    @response = OpenPayU::Order.cancel("Z963D5JQR2230925GUEST000P01")
+
+###Updating order status
+  You can update order status to accept order when Autoreceive in POS is turned off
+
+    status_update = {
+            order_id: "Z963D5JQR2230925GUEST000P01",
+            order_status: 'COMPLETED'
+          }
+    @response = OpenPayU::Order.status_update(status_update)
+
+###Handling notifications from PayU
+  PayU sends requests to your application when order status changes
+
+    @response = OpenPayU::Order.consume_notification(request) #request object from controller
+    @response.order_status #NEW PENDING CANCELLED REJECTED COMPLETED WAITING_FOR_CONFIRMATION
+    #you should response to PayU with special structure (OrderNotifyResponse)
+    render json: OpenPayU::Order.build_notify_response(@response.req_id)
+
+
+###Refund money
+
+    @refund = OpenPayU::Refund.create({
+      order_id: "Z963D5JQR2230925GUEST000P01", #required
+      description: "Money refund", #required
+      ext_refund_id: 21312, #Refund Id in your syste, optional
+      amount: 1000, #If not provided, returns whole transaction, optional
+      commission_amount: 123, #optional
+      currency_code: "PLN" #optional
+    })
+    
+
+
+
+
+## Contributing
+
+1. Fork it
+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

data/Rakefile

@@ -0,0 +1 @@
+require "bundler/gem_tasks"

data/doc/EmptyResponseError.html

@@ -0,0 +1,123 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+  <head>
+    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
+<title>
+  Exception: EmptyResponseError
+  
+    &mdash; Documentation by YARD 0.8.7.2
+  
+</title>
+
+  <link rel="stylesheet" href="css/style.css" type="text/css" charset="utf-8" />
+
+  <link rel="stylesheet" href="css/common.css" type="text/css" charset="utf-8" />
+
+<script type="text/javascript" charset="utf-8">
+  hasFrames = window.top.frames.main ? true : false;
+  relpath = '';
+  framesUrl = "frames.html#!" + escape(window.location.href);
+</script>
+
+
+  <script type="text/javascript" charset="utf-8" src="js/jquery.js"></script>
+
+  <script type="text/javascript" charset="utf-8" src="js/app.js"></script>
+
+
+  </head>
+  <body>
+    <div id="header">
+      <div id="menu">
+  
+    <a href="_index.html">Index (E)</a> &raquo;
+    
+    
+    <span class="title">EmptyResponseError</span>
+  
+
+  <div class="noframes"><span class="title">(</span><a href="." target="_top">no frames</a><span class="title">)</span></div>
+</div>
+
+      <div id="search">
+  
+    <a class="full_list_link" id="class_list_link"
+        href="class_list.html">
+      Class List
+    </a>
+  
+    <a class="full_list_link" id="method_list_link"
+        href="method_list.html">
+      Method List
+    </a>
+  
+    <a class="full_list_link" id="file_list_link"
+        href="file_list.html">
+      File List
+    </a>
+  
+</div>
+      <div class="clear"></div>
+    </div>
+
+    <iframe id="search_frame"></iframe>
+
+    <div id="content"><h1>Exception: EmptyResponseError
+  
+  
+  
+</h1>
+
+<dl class="box">
+  
+    <dt class="r1">Inherits:</dt>
+    <dd class="r1">
+      <span class="inheritName">StandardError</span>
+      
+        <ul class="fullTree">
+          <li>Object</li>
+          
+            <li class="next">StandardError</li>
+          
+            <li class="next">EmptyResponseError</li>
+          
+        </ul>
+        <a href="#" class="inheritanceTree">show all</a>
+      
+      </dd>
+    
+  
+  
+    
+  
+    
+  
+  
+  
+    <dt class="r2 last">Defined in:</dt>
+    <dd class="r2 last">lib/openpayu/exceptions.rb</dd>
+  
+</dl>
+<div class="clear"></div>
+
+
+
+
+
+
+
+
+
+  
+
+</div>
+
+    <div id="footer">
+  Generated on Tue Dec 17 15:20:59 2013 by
+  <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
+  0.8.7.2 (ruby-1.9.3).
+</div>
+
+  </body>
+</html>