klarna-xmlrpc 0.2.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 884cb4983e5eaf740ebf2f4b3d7519dc05046573
+  data.tar.gz: b4a6d9b8bd690dc20d9057ac5e4162ef2e3371af
+SHA512:
+  metadata.gz: 7699b2ddb818d106f8243097106b5bfa298dd53a5f63c950c82435271c775c0e53ac4417a21a2f8adfa64b3e5ca3673c6b0baf56ff4ecc5ec76280979cbf0632
+  data.tar.gz: 83c60e1cf360a8fad00fe34f8ec6c91805d95ddcbca8ca20fc63d17d39a9aa48729108f76118bf9d78062e2c8b8544f3b7c75f28a7689de1392812532e6dacab

data/.travis.yml

@@ -0,0 +1,13 @@
+rvm:
+  - 1.8.7
+  - 1.9.2
+  - ree
+  - ruby-head
+  - rbx
+  - rbx-2.0
+  - jruby
+env:
+  # Don't get any ideas, this will only work with Klarna's test-server. ;)
+  - KLARNA_ESTORE=1562,V6Y95XQ46ymmAWA
+notifications:
+  disabled: true

data/Gemfile

@@ -0,0 +1,14 @@
+source "http://rubygems.org"
+
+# See: klarna.gemspec
+gemspec
+
+platform :jruby do
+  gem 'jruby-openssl'
+end
+
+group :test do
+  group :darwin do
+    gem 'rb-fsevent'
+  end
+end

data/Guardfile

@@ -0,0 +1,16 @@
+guard 'bundler' do
+  watch('Gemfile')
+  watch(/^.+\.gemspec/)
+end
+
+guard 'minitest' do
+  # with Minitest::Unit
+  watch(%r|^test/(.*)_test\.rb|)
+  watch(%r|^lib/(.*)\.rb|)            { |m| "test/#{m[1]}_test.rb" }
+  watch(%r|^test/test_helper\.rb|)    { "test" }
+
+  # with Minitest::Spec
+  # watch(%r|^spec/(.*)_spec\.rb|)
+  # watch(%r|^lib/(.*)\.rb|)            { |m| "spec/#{m[1]}_spec.rb" }
+  # watch(%r|^spec/spec_helper\.rb|)    { "spec" }
+end

data/MIT-LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2010-2011 Jonas Grimfelt, Merchii. http://merchii.com
+
+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.textile

@@ -0,0 +1,139 @@
+h1. KLARNA "!https://secure.travis-ci.org/merchii/klarna-ruby.png!":http://travis-ci.org/merchii/klarna-ruby
+
+_A Ruby wrapper for the Klarna XML-RPC API._
+
+h2. What is Klarna?
+
+*"Klarna":http://klarna.com* is a payment solution with focus on e-commerce. Visit "klarna.com":http://klarna.com for more information, or why not "Wikipedia: Klarna":http://en.wikipedia.org/wiki/Klarna. We might be biased, but at "Merchii":http://merchii.com we currently consider Klarna the most convenient online payment solution that exists - and that's why we lean on it.
+
+*Supported countries:*
+
+Sweden (SE), Norway (NO), Denmark (DK), Finland (FI), Germany (DE), Netherlands (NL).
+
+h2. Implementation/Background
+
+This gem was developed as a semi-1:1 implementation of the corresponding API implementations provided by Klarna (with a few simple justifications and heavily refactored methods). Klarnas official implementations were not implemented using OO patterns and as their implementation was changing very often without any notice/versioning I kept it simple as possible.
+
+Since Klarna 2.0 was released they'va refactored their implementations a lot which makes it a good idea to review this implementation as well. Like stated in the TODO I had a clean classy DSL in mind.
+
+This is not a complete implementation, but not far from it and enough for most use cases - a few of the more advanced API methods needs a review/revisit (code disabled now).
+
+h2. Setup
+
+Install the gem:
+
+<pre>
+  $ gem install klarna
+</pre>
+
+...or if you use "Bundler":http://gembundler.com:
+
+@Gemfile@:
+
+<pre>
+  gem 'klarna'
+</pre>
+
+...and @$ bundle install@.
+
+h2. Usage
+
+Trivial example looking up an address using - in this case - a Swedish SSN:
+
+<pre>
+  require 'rubygems'
+  require 'klarna'
+
+  Klarna.configure do |c|
+    c.store_id = 123
+    c.store_secret = 'secret'
+
+    c.mode = :test
+    c.http_logging = false
+  end
+
+  client = Klarna::API::Client.new
+
+  client.get_addresses("430415-8399", :SE)
+</pre>
+
+See the code/docs for more information.
+
+h2. Testing
+
+A couple of ways...
+
+*Specs*
+
+To run unit/integration tests, simply do:
+
+<pre>
+  $ bundle exec rake test
+</pre>
+
+...or if you use "Guard":http://github.com/guard/guard:
+
+<pre>
+  $ bundle exec guard
+</pre>
+
+*Dummie client*
+
+<pre>
+  $ cd examples
+  $ ruby console.rb
+</pre>
+
+*Web/Sinatra app*
+
+1. Start the server...
+
+<pre>
+  $ cd examples
+  $ ruby web.rb
+  ...
+  >> Listening on 0.0.0.0:4567, CTRL+C to stop
+</pre>
+
+2. Open it up!
+
+@http://localhost:4567@
+
+*NOTE:* The web app actions/forms are probably completely broken currently as it hasn't been updated to reflect the current library implementation.
+
+h2. Debugging
+
+*HTTP-debugging in Wireshark*
+
+Ensure port @4567@ (port used for Klarna API integration test/debugging) is in the list of captured ports in the HTTP/HTTPS preferences, or these requests/responses will not be captured. Note: Port @80@ (port used for Klarna API integration in production) is captured by default.
+
+*XML-RPC-debugging in a XML-RPC client*
+
+Try this:
+
+Endpoint: @http://beta-test.klarna.com:4567@
+Method: @get_addresses@
+Params: @["1.0","ruby/xmlrpc","430415-8399",2,"AY2qnVNi8ccTsuDw2XNovQ==",2,2]@
+
+h2. References
+
+* "Klarna API Documentation":http://integration.klarna.com/en/api/step-by-step
+* "XML-RPC Overview":http://en.wikipedia.org/wiki/XML-RPC
+
+h2. Tools
+
+* "XML-RPC Client":http://ditchnet.org/xmlrpc/ for XML-RPC debugging on OS X.
+* "Wireshark":http://wireshark.org for platform-independent protocol sniffing, useful for debugging XML-RPC requests/responses.
+
+h2. Notes
+
+This gem was developed for our own requirements at "Merchii":http://github.com/merchii, so feel free to send pull-requests with enhancements of any kind (features, bug-fixes, documentation, tests, etc.) to make it better or useful for you as well.
+
+h2. To-do
+
+See the "TODO":https://github.com/merchii/klarna-ruby/blob/master/TODO.
+
+h2. License
+
+Released under the MIT license.
+Copyright (c) "Jonas Grimfelt":http://github.com/grimen, "Merchii":http://merchii.com

data/Rakefile

@@ -0,0 +1,22 @@
+# encoding: utf-8
+require 'bundler/gem_tasks'
+require 'rake/testtask'
+require 'rdoc/task'
+
+desc 'Default: Run all tests.'
+task :default => :test
+
+desc 'Test gem for klarna.'
+Rake::TestTask.new(:test) do |test|
+  test.libs << ['lib', 'test']
+  test.pattern = 'test/**/*_test.rb'
+end
+
+desc 'Generate gem documentation for klarna.'
+Rake::RDocTask.new(:rdoc) do |rdoc|
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title    = 'Klarna Ruby API-wrapper Documentation'
+  rdoc.options << '--line-numbers' << '--inline-source'
+  rdoc.rdoc_files.include('README.textile')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end

data/TODO

@@ -0,0 +1,30 @@
+
+== CURRENT
+
+x [issue]: Test the invoice activation in a proper way - not allowed in the Klarna 2.0 API (for some weird reason...)
+
+
+== HIGH-PRIO
+
+* [feature]: Review/Implement something like: our_settype_integer, our_strip_string, our_settype_string (consider one generic method, e.g. parse(:price, value) - all validation/masking/casting in one place)
+* [feature]: Ensure valid string format/stripping (e.g. SSN, etc) using regular expressions
+* [feature]: Compare implementation with Klarna's new API 2.0
+* [feature]: Ensure correct params datatypes are submitted (validation - consider generic method)
+* [feature]: Klarna::DSL - wrapper DSL for less sucky integrations
+* [feature]: Implement #get_pclasses method to export pclasses as hash (and maybe export to YAML?)
+* [feature]: ActiveMerchant-integration (fork ActiveMerchant and add klarna as new gateway with "klarna-ruby" as dependency)
+
+
+== LOW-PRIO
+
+* [feature]: Finalize the rest of the specs for already implemented methods, commented out currently.
+* [feature]: Implement Reservation methods
+* [feature]: Bring back "examples/web" - probably not working at all now.
+* [feature]: Rack middleware?
+* [refactor]: Only load activesupport-extensions we actually use.
+
+== MAYBE
+
+* [feature]: Mock XML-responses by default to avoid live API calls, but allow live calls using ENV['REMOTE]=true
+
+    https://github.com/myronmarston/vcr

data/examples/Gemfile

@@ -0,0 +1,8 @@
+source 'http://gemcutter.org'
+
+gem 'sinatra', :require => false
+gem 'sinatra-mapping', :require => false
+gem 'haml', :require => false
+gem 'activesupport'
+gem 'nokogiri'
+gem 'klarna', :path => '..'

data/examples/config/initializer.rb

@@ -0,0 +1,15 @@
+$LOAD_PATH.unshift File.join(File.dirname(__FILE__), '..', 'lib')
+require 'klarna'
+
+# Configuration.
+Klarna.setup do |config|
+  config.mode = :test
+
+  config.country = :SE
+
+  config.store_id = 2
+  config.store_secret = 'lakrits'
+
+  config.logging = true
+  config.http_logging = false
+end

data/examples/console.rb

@@ -0,0 +1,71 @@
+# encoding: utf-8
+
+require 'rubygems'
+require 'bundler'
+Bundler.require(:default)
+require 'active_support/all'
+require 'pp'
+
+require File.expand_path("config/initializer", File.dirname(__FILE__)).to_s
+
+# == Initialize a Klarna API-client.
+
+Klarna.configure do |c|
+  c.store_id = ENV['KLARNA_ESTORE_ID'].presence
+  c.store_secret = ENV['KLARNA_ESTORE_SECRET'].presence
+  c.mode = ENV['KLARNA_MODE'].presence
+  c.http_logging = true
+end
+
+begin
+  @@klarna = ::Klarna::API::Client.new(::Klarna.store_id, ::Klarna.store_secret)
+rescue Klarna::API::Errors::KlarnaCredentialsError => e
+  puts e
+rescue ::Klarna::API::Errors::KlarnaServiceError => e
+  puts e
+end
+
+@@klarna.client_ip = '192.168.0.196'
+
+puts @@klarna.endpoint_uri.inspect
+
+puts ::Klarna::API::PNO_FORMATS[:SE].inspect
+
+print "SSN: "
+test_pno = "820328-0154" # "4304158399" # gets.strip # "4304158399"
+
+puts "------------------------------"
+puts "eid: #{Klarna.store_id}"
+puts "secret: #{Klarna.store_secret}"
+puts "------------------------------"
+puts "pno: #{test_pno}"
+
+pno_secret = @@klarna.send(:digest, Klarna.store_id, test_pno, Klarna.store_secret)
+
+puts "pno_secret: #{pno_secret}"
+puts "------------------------------"
+
+puts @@klarna.get_addresses(test_pno, ::Klarna::API::PNO_FORMATS[:SE])
+
+# ----------------------
+
+order_items = []
+order_items << @@klarna.make_goods(1, "ABC1", "T-shirt 1", 1.00 * 100, 25)
+# order_items << @@klarna.make_goods(1, "ABC2", "T-shirt 2", 7.00 * 100, 25)
+# order_items << @@klarna.make_goods(1, "ABC3", "T-shirt 3", 17.00 * 100, 25)
+
+#address = @@klarna.make_address("", "Junibackg. 42", "23634", "Hollviken", :SE, "076 526 00 00", "076 526 00 00", "karl.lidin@klarna.com")
+address = @@klarna.make_address("", "Sollentunavägen 68", "18743", "Täby", :SE, "0702167225", "0702167225", "grimen@gmail.com")
+
+# invoice_no = @@klarna.add_transaction("USER-#{test_pno}", 'ORDER-1', order_items, 0, 0, :NORMAL, test_pno, "Karl", "Lidin", address, '85.230.98.196', :SEK, :SE, :SV, :SE) #, nil, nil, nil, nil, nil, nil, nil, :TEST_MODE => true)
+invoice_no = @@klarna.add_transaction("USER-#{test_pno}", 'ORDER-1', order_items, 0, 0, :NORMAL, test_pno, "Jonas", "Grimfelt", address, '85.230.98.196', :SEK, :SE, :SV, :SE) #, nil, nil, nil, nil, nil, nil, nil, :TEST_MODE => true)
+
+pp "Invoice-no: #{invoice_no}"
+
+# FIXME: Since Klarna API changed this fails even with the TEST_MODE (2) flag set.
+
+# invoice_url = @@klarna.activate_invoice(invoice_no)
+
+# pp "Invoice-URL: #{invoice_url}"
+
+

data/examples/views/_address.haml

@@ -0,0 +1,22 @@
+- prefix ||= ''
+
+%p
+  = field "First name:", :"#{prefix}first_name", :text, :size => "20", :value => ""
+  *
+%p
+  = field "Last name:", :"#{prefix}last_name", :text, :size => "20", :value => ""
+  *
+%p
+  = field "Street address:", :"#{prefix}street_address", :text, :size => "40", :value => ""
+  *
+%p
+  = field "House number:", :"#{prefix}house_number", :text, :size => "2", :value => ""
+  (* Germany only)
+%p
+  = field "Postal code:", :"#{prefix}postal_code", :text, :size => "5", :value => ""
+  *
+%p
+  = field "City:", :"#{prefix}city", :text, :size => "20", :value => ""
+  *
+%p
+  = country_selector("Country:", :prefix => prefix)

data/examples/views/_articles.haml

@@ -0,0 +1,21 @@
+%table
+  %thead
+    %tr
+      %th Quantity
+      %th Art.no.
+      %th Title
+      %th Price
+      %th VAT
+  %tbody
+    %tr
+      %td= field "", :"product[0]_quantity", :text, :value => "1", :size => 2
+      %td= field "", :"product[0]_article_no", :text, :value => "101", :size => 6
+      %td= field "", :"product[0]_title", :text, :value => "Product #1", :size => 20
+      %td= field "", :"product[0]_price", :text, :value => "99,00", :size => 8
+      %td= field "", :"product[0]_vat", :text, :value => "25,00", :size => 4
+    %tr
+      %td= field "", :"product[1]_quantity", :text, :value => "1", :size => 2
+      %td= field "", :"product[1]_article_no", :text, :value => "102", :size => 6
+      %td= field "", :"product[1]_title", :text, :value => "Product #2", :size => 20
+      %td= field "", :"product[1]_price", :text, :value => "149,00", :size => 8
+      %td= field "", :"product[1]_vat", :text, :value => "25,00", :size => 4

data/examples/views/checkout_page_example.haml

@@ -0,0 +1,2 @@
+%h1 Checkout Page (Example)
+%p Example of a valid checkout page for a Klarna-connected store.

data/examples/views/essential/add_transaction/_form.haml

@@ -0,0 +1,32 @@
+%h3 Add Transaction (Create Invoice)
+
+%form{:action => '/essential/add_transaction', :name => 'add_transaction'}
+  %p
+    = field "SSN:", :pno, :text, :size => 12, :value => "430415-8399"
+    *
+  = partial(:address)
+  %p
+    = field "E-mail:", :email, :email, :size => 30
+    *
+  %p
+    = field "Phone:", :phone, :tel, :size => 10
+    *
+  %p
+    = field "Mobile:", :mobile, :tel, :size => 10
+  %p
+    = field "Order ID:", :order_id, :text, :size => 10
+  %p
+    = field "Auto-activation:", :auto_activation, :checkbox
+  %p
+    = field "Pre-pay:", :pre_pay, :checkbox
+  %p
+    = currency_selector("Currency:")
+  %p
+    = language_selector("Language:")
+  %p
+    = field "Yearly salary:", :yearly_salary, :text, :size => 10
+    (* with invoice purchases over 6000 SEK, DKK, NOK or 600 EUR)
+  %p
+    = field "Reference ID:", :reference, :text, :size => 10
+  %p
+    = submit_button "Create"