trustly-client-ruby 0.1.71 → 0.1.72

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 5421b7c57a5df06f7871d9293ade9e0a55b29aee
-  data.tar.gz: 1e54994705a9e3e79ea9a06c6c43cfe2f34909e4
+  metadata.gz: bc918b9581ec07800276b9891f056e70ddd0255d
+  data.tar.gz: 0523cdbef296a53d138dee5cfb16d701c5700f5f
 SHA512:
-  metadata.gz: 47efca17a1ba7c273263975eed75c282d931af84f3bafad39943228fb8f781aaf449a4ca23c1e4a94295111f89db4968ce90c87d42d674876007480b93d0456a
-  data.tar.gz: 9fc39003d366ac87d52c956eb71627260c58d0f4274137062575b411fe258220e1595d4b84cd3506ed93a6871e661c0e8a53c5ebcf2337950d76199e5b9f39f6
+  metadata.gz: 4b7655ca5fd49dd69b17f8763b6051f76db51ee946b37666de9bfbe53452988645b8d9b3f2c9a53728740efc6bf36b5f8a916ef96e33f26afeffb803de1480f2
+  data.tar.gz: 84e93a63069ed1cceebcf2738dd36aad4d78db650cc423221048795d984e5503704d58f8583f0054d4b2f1d282e9dbb1d13a93f0155796bd769e4701aac697cf

data/README.md

@@ -1,38 +1,176 @@
-# Trustly::Client::Ruby
+# Trustly-client-ruby
 
-Welcome to your new gem! In this directory, you'll find the files you need to be able to package up your Ruby library into a gem. Put your Ruby code in the file `lib/trustly/client/ruby`. To experiment with that code, run `bin/console` for an interactive prompt.
+This is an example implementation of communication with the Trustly API using Ruby. This a ruby gem that allows you use Trustly Api calls in ruby. It's based on [trustly-client-python] (https://github.com/trustly/trustly-client-python) and [turstly-client-php] (https://github.com/trustly/trustly-client-php)
+
+It implements the standard Payments API as well as gives stubs for executing calls against the API used by the backoffice.
+
+For full documentation on the Trustly API internals visit our developer website: http://trustly.com/developer . All information about software flows and call patters can be found on that site. The documentation within this code will only cover the code itself, not how you use the Trustly API.
+
+This code is provided as-is, use it as inspiration, reference or drop it directly into your own project and use it.
 
-TODO: Delete this and the text above, and describe your gem
 
 ## Installation
 
 Add this line to your application's Gemfile:
 
 ```ruby
-gem 'trustly-client-ruby'
+gem 'trustly-client-ruby',:require=>'trustly'
 ```
 
 And then execute:
 
-    $ bundle
+    $ bundle install
 
 Or install it yourself as:
 
     $ gem install trustly-client-ruby
 
+If you use rails, you can use this generator in order to let trustly find your certificates:
+
+    $ rails g trustly:install
+
+This will copy trustly public certificates under certs/trustly folder:
+    
+    certs/trustly/test.trustly.public.pem
+    certs/trustly/live.trustly.public.pem
+
+You will need to copy test and live private certificates using this naming convention (if you want Trustly to load them automatically but you can use different path and names):
+
+    certs/trustly/test.merchant.private.pem
+    certs/trustly/live.merchant.private.pem 
+
 ## Usage
 
-TODO: Write usage instructions here
+Currently only **Deposit** and **Refund** api calls. However, other calls can be implemented very easily.
+
+### Api
+
+In order to use Trustly Api, we'll need to create a **Trustly::Api::Signed**. Example:
+
+```ruby
+api = Trustly::Api::Signed.new({
+	:username=>"yourusername",
+	:password=>"xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
+})
+```
+
+This will automatically load pem files from **certs/trustly** with default optons. If you want to specify other paths or options then you can call:
+
+```ruby
+api = Trustly::Api::Signed.new({
+	 :username=>"yourusername",
+	 :password=>"xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
+    :host        => 'test.trustly.com',
+    :port        => 443,
+    :is_https    => true,
+    :private_pem => "#{Rails.root}/certs/trustly/test.merchant.private.pem",
+    :public_pem  => "#{Rails.root}/certs/trustly/test.trustly.public.pem"
+})
+```
+
+### Deposit call
+
+Deposit is straightfoward call. Only required arguments example:
+
+```ruby
+deposit = api.deposit({"EndUserID"=>10002,"MessageID"=>12349,"Amount"=>3})
+```
+Optional arguments are:
+
+- Locale:  default value "es_ES"
+- Country: default "ES"
+- Currency default "EUR"
+- SuggestedMinAmount
+- SuggestedMaxAmount
+- Amount
+- Currency
+- Country
+- IP
+- SuccessURL: default "https://www.trustly.com/success"
+- FailURL   : default "https://www.trustly.com/fail"
+- TemplateURL
+- URLTarget
+- MobilePhone
+- Firstname
+- Lastname
+- NationalIdentificationNumber
+- ShopperStatement
+- NotificationURL: default "https://test.trustly.com/demo/notifyd_test"
+
+This will return a **Trustly::Data::JSONRPCResponse**:
+
+```ruby
+> deposit.get_data('url')
+=> "https://test.trustly.com/_/orderclient.php?SessionID=755ea475-dcf1-476e-ac70-07913501b34e&OrderID=4257552724&Locale=es_ES"
+
+> deposit.get_data()
+=> {
+	"orderid" => "4257552724", 
+	"url"     => "https://test.trustly.com/_/orderclient.php?SessionID=755ea475-dcf1-476e-ac70-07913501b34e&OrderID=4257552724&Locale=es_ES"
+}
+```
+
+You can check if there was an error:
+
+```ruby
+> deposit.error?
+=> true
+
+> deposit.success?
+=> false
+
+> deposit.error_msg
+=> "ERROR_DUPLICATE_MESSAGE_ID"
+```
+
+### Refund call
+
 
-## Development
 
-After checking out the repo, run `bin/setup` to install dependencies. Then, run `bin/console` for an interactive prompt that will allow you to experiment.
+### Notifications
+
+After a **deposit** or **refund** call, Trustly will send a notification to **NotificationURL**. If you are using rails the execution flow will look like this:
+
+```ruby
+def controller_action
+	api = Trustly::Api::Signed.new({..}) 
+	notification = Trustly::JSONRPCNotificationRequest.new(params)
+	if api.verify_trustly_signed_notification(notification)
+	   # do something with notification
+	   ...
+	   # reply to trustly
+	   response = api.notification_response(notification,true)
+	   render :text => response.json()
+	else
+		render :nothing => true, :status => 200
+	end
+end
+``` 
+
+You can use **Trustly::JSONRPCNotificationRequest** object to access data provided using the following methods:
+
+```ruby
+ notification.get_data
+=> {"amount"=>"902.50", "currency"=>"EUR", "messageid"=>"98348932", "orderid"=>"87654567", "enduserid"=>"32123", "notificationid"=>"9876543456", "timestamp"=>"2010-01-20 14:42:04.675645+01", "attributes"=>{}}
+
+> notification.get_method
+=> "credit"
+
+> notification.get_uuid
+=> "258a2184-2842-b485-25ca-293525152425"
+
+> notification.get_signature
+=> "R9+hjuMqbsH0Ku ... S16VbzRsw=="
+
+> notification.get_data('amount')
+=> "902.50"
+```
+
 
-To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release` to create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
 
 ## Contributing
 
-1. Fork it ( https://github.com/[my-github-username]/trustly-client-ruby/fork )
+1. Fork it ( https://github.com/jcarreti/trustly-client-ruby/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`)

data/lib/trustly.rb

@@ -13,8 +13,8 @@ require "trustly/data/request"
 require "trustly/data/response"
 require "trustly/data/jsonrpc_request"
 require "trustly/data/jsonrpc_response"
-require "trustly/data/jsonrpcnotificationrequest"
-require "trustly/data/jsonrpcnotificationrequest"
+require "trustly/data/jsonrpcnotification_request"
+require "trustly/data/jsonrpcnotification_request"
 
 require "trustly/api"
 require "trustly/api/signed"

data/lib/trustly/api/signed.rb

@@ -110,6 +110,24 @@ class Trustly::Api::Signed < Trustly::Api
     #options["HoldNotifications"] = "1" unless 
   end
 
+  def refund(_options)
+    options = {
+      "OrderID" => "EUR"
+    }.merge(_options)
+
+    # check for required options
+    ["OrderID","Amount","Currency"].each{|req_attr| raise Trustly::Exception::DataError, "Option not valid '#{req_attr}'" if options.try(:[],req_attr).nil? }
+
+    request = Trustly::Data::JSONRPCRequest.new('Deposit',options,nil)
+    return self.call_rpc(request)
+  end
+
+  def notification_response(notification,success=true)
+    response = Trustly::JSONRPCNotificationResponse.new(notification,success)
+    response.set_signature(self.sign_merchant_request(notification))
+    return notification
+  end
+
   def withdraw(_options)
 
   end

data/lib/trustly/data/{jsonrpcnotificationrequest.rb → jsonrpcnotification_request.rb}

@@ -3,15 +3,19 @@ class Trustly::JSONRPCNotificationRequest < Trustly::Data
   attr_accessor :notification_body, :payload
 
   def initialize(notification_body)
-    super
+    super()
     self.notification_body = notification_body
-    begin
-      self.payload = JSON.parse(self.notification_body)
-    rescue JSON::ParserError => e 
-      raise Trustly::Exception::DataError, e.message
+    unless self.notification_body.is_a?(Hash)
+      begin
+        self.payload = JSON.parse(self.notification_body)
+      rescue JSON::ParserError => e 
+        raise Trustly::Exception::DataError, e.message
+      end
+
+      raise Trustly::Exception::JSONRPCVersionError, 'JSON RPC Version #{(self.get_version()} is not supported' if self.get_version() != '1.1'
+    else
+      self.payload = self.notification_body.deep_stringify_keys
     end
-
-    raise Trustly::Exception::JSONRPCVersionError, 'JSON RPC Version #{(self.get_version()} is not supported' if self.get_version() != '1.1'
   end
 
   def get_version()

data/lib/trustly/version.rb

@@ -1,3 +1,3 @@
 module Trustly
-  VERSION = "0.1.71"
+  VERSION = "0.1.72"
 end

data/lib/trustly/version.rb~

@@ -1,3 +1,3 @@
 module Trustly
-  VERSION = "0.1.7"
+  VERSION = "0.1.71"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: trustly-client-ruby
 version: !ruby/object:Gem::Version
-  version: 0.1.71
+  version: 0.1.72
 platform: ruby
 authors:
 - Jorge Carretie
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2015-06-30 00:00:00.000000000 Z
+date: 2015-07-01 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rake
@@ -50,14 +50,13 @@ files:
 - lib/generators/trustly/templates/live.trustly.public.pem
 - lib/generators/trustly/templates/test.trustly.public.pem
 - lib/trustly.rb
-- lib/trustly.rb~
 - lib/trustly/api.rb
 - lib/trustly/api/signed.rb
 - lib/trustly/data.rb
 - lib/trustly/data/jsonrpc_request.rb
 - lib/trustly/data/jsonrpc_response.rb
-- lib/trustly/data/jsonrpcnotificationrequest.rb
-- lib/trustly/data/jsonrpcnotificationresponse.rb
+- lib/trustly/data/jsonrpcnotification_request.rb
+- lib/trustly/data/jsonrpcnotification_response.rb
 - lib/trustly/data/request.rb
 - lib/trustly/data/response.rb
 - lib/trustly/exception.rb

data/lib/trustly.rb~

@@ -1,19 +0,0 @@
-module Trustly
-end
-
-require "trustly/exception/authentification_error"
-require "trustly/exception/connection_error"
-require "trustly/exception/data_error"
-require "trustly/exception/jsonrpc_version_error"
-require "trustly/exception/signature_error"
-
-require "trustly/data"
-require "trustly/data/jsonrpc_request"
-require "trustly/data/jsonrpc_response"
-require "trustly/data/jsonrpcnotificationrequest"
-require "trustly/data/jsonrpcnotificationrequest"
-
-require "trustly/api"
-require "trustly/api/signed"
-require "trustly/version"
-