docdata-order 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 1504b4d5df07a35ae4e4b403776da567d2bab632
+  data.tar.gz: '079dfe209ce3bc7a99f1040721a5290f2ac29c9b'
+SHA512:
+  metadata.gz: 9d0d115f0d0427605c95c3d1d128e0f8f1e8f2667789b95366fd9a97ea887fbed2a1e6cbcc733b91b7226e7ec4e20a70a6ad186344b19e16f945e0c912d1810a
+  data.tar.gz: 69f6a2e859992879043497eb3d27f76e3e373e1bc965aab1e4ebfd87159d5912b97a1ecce6c388b21ccc5dfe738f4add1d39f2c9ca5ab4f3f5a35c2eeff86f63

data/.gitignore

@@ -0,0 +1,15 @@
+/.bundle/
+/.yardoc
+/Gemfile.lock
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+
+# rspec failure tracking
+.rspec_status
+
+.ruby-version
+.ruby-gemset

data/.rspec

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

data/.rubocop.yml

@@ -0,0 +1,38 @@
+# Docdata-order RuboCop configuration
+
+AllCops:
+  TargetRubyVersion: 2.3
+  DisplayCopNames: true
+  DisplayStyleGuide: true
+
+Metrics/AbcSize:
+  Max: 53
+
+Metrics/BlockLength:
+  Exclude:
+    - 'spec/**/*.rb'
+
+Metrics/ClassLength:
+  Enabled: false
+
+Metrics/LineLength:
+  Enabled: false
+
+Metrics/MethodLength:
+  Enabled: false
+
+Style/BlockDelimiters:
+  Exclude:
+    - 'spec/**/*.rb'
+
+Style/GuardClause:
+  Enabled: false
+
+Style/SafeNavigation:
+  Enabled: false
+
+Style/StringLiterals:
+  Enabled: false
+
+Style/SymbolArray:
+  Enabled: false

data/.travis.yml

@@ -0,0 +1,7 @@
+language: ruby
+sudo: false
+cache: bundler
+rvm:
+  - 2.2.9
+  - 2.3.6
+  - 2.4.3

data/CHANGELOG.md

@@ -0,0 +1,5 @@
+# Docdata::Order changelog
+
+## 1.0.0 (2018-02-09)
+
+- First public release.

data/Gemfile

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in docdata-order.gemspec
+gemspec
+
+gem 'rubocop', '~> 0.50.0'

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2017 Peter Postma
+
+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,134 @@
+# Docdata::Order
+
+[![Gem Version](https://badge.fury.io/rb/docdata-order.svg)](https://badge.fury.io/rb/docdata-order)
+[![Build Status](https://travis-ci.org/KentaaNL/docdata-order.svg?branch=master)](https://travis-ci.org/KentaaNL/docdata-order)
+[![Code Climate](https://codeclimate.com/github/KentaaNL/docdata-order/badges/gpa.svg)](https://codeclimate.com/github/KentaaNL/docdata-order)
+
+Docdata::Order is a Ruby client for the Docdata Order API version 1.3.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'docdata-order'
+```
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install docdata-order
+
+## Usage
+
+### Initialization
+
+Create a Docdata Order client and configure it with your merchant name and password:
+
+```ruby
+order = Docdata::Order::Client.new("name", "password")
+```
+
+The client is configured in live mode by default. To put the client in test mode, use `test: true` as third parameter.
+
+### Create an order
+
+Create a new order with the `create` method. You need to provide the following parameters to create the order:
+
+```ruby
+options = {
+  amount: "12.50",
+  order_reference: "12345",
+  description: "Test order",
+  profile: "profile",
+  shopper: {
+    first_name: "John",
+    last_name: "Doe",
+    email: "john.doe@example.com",
+    language: "en",
+    gender: Docdata::Order::Gender::MALE
+  },
+  address: {
+    street: "Jansbuitensingel",
+    house_number: "29",
+    postal_code: "6811AD",
+    city: "Arnhem",
+    country: "NL"
+  }
+}
+
+response = order.create(options)
+
+if response.success?
+  puts response.order_key
+  puts response.redirect_url
+else
+  puts response.error_message
+end
+```
+
+The `redirect_url` in the response will redirect the user to the Docdata Payment Menu (One Page Checkout).
+
+To create an order and automatically redirect to the bank using iDEAL as payment method, use the parameters above including:
+
+```ruby
+response = order.create(options.merge(
+  payment_method: Docdata::Order::PaymentMethod::IDEAL,
+  issuer_id: Docdata::Order::Ideal::ISSUERS.first[0],
+  return_url: "http://yourwebshop.nl/payment_return"
+))
+```
+
+### Start a payment order
+
+When using Webdirect, you can use `start` to start a payment order.
+
+```ruby
+options = {
+  order_key: "12345",
+  payment_method: Docdata::Order::PaymentMethod::SEPA_DIRECT_DEBIT,
+  account_name: "Onderheuvel",
+  account_iban: "NL44RABO0123456789"
+}
+
+response = order.start(options)
+
+if response.success?
+  puts response.payment_id
+else
+  puts response.error_message
+end
+```
+
+### Retrieve status of an order
+
+To retrieve the status of an order, use `status` with the order key:
+
+```ruby
+response = order.status(order_key: "12345")
+
+if response.success?
+  puts response.paid?
+else
+  puts response.error_message
+end
+```
+
+## Development
+
+After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+
+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`, which will create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/KentaaNL/docdata-order.
+
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](http://opensource.org/licenses/MIT).
+

data/Rakefile

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+require "rubocop/rake_task"
+
+RSpec::Core::RakeTask.new(:spec)
+RuboCop::RakeTask.new(:rubocop)
+
+task default: [:spec, :rubocop]

data/bin/console

@@ -0,0 +1,15 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require "bundler/setup"
+require "docdata/order"
+
+# You can add fixtures and/or initialization code here to make experimenting
+# with your gem easier. You can also use a different console, if you like.
+
+# (If you use this, don't forget to add pry to your Gemfile!)
+# require "pry"
+# Pry.start
+
+require "irb"
+IRB.start(__FILE__)

data/bin/setup

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+set -euo pipefail
+IFS=$'\n\t'
+set -vx
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/docdata-order.gemspec

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'docdata/order/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "docdata-order"
+  spec.version       = Docdata::Order::VERSION
+  spec.authors       = ["Kentaa"]
+  spec.email         = ["support@kentaa.nl"]
+
+  spec.summary       = "Ruby client for the Docdata Order API"
+  spec.homepage      = "https://github.com/KentaaNL/docdata-order"
+  spec.license       = "MIT"
+
+  spec.files = `git ls-files -z`.split("\x0").reject do |f|
+    f.match(%r{^(test|spec|features)/})
+  end
+  spec.bindir        = "exe"
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ["lib"]
+
+  spec.required_ruby_version = ">= 2.0.0"
+
+  spec.add_development_dependency "bundler", "~> 1.14"
+  spec.add_development_dependency "rake", "~> 10.0"
+  spec.add_development_dependency "rspec", "~> 3.0"
+  spec.add_development_dependency "webmock", "~> 2.3", ">= 2.3.2"
+
+  spec.add_dependency "savon", ">= 2.0", "< 3.0"
+end

data/lib/docdata/order.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+require "docdata/order/client"
+require "docdata/order/exception"
+require "docdata/order/gender"
+require "docdata/order/ideal"
+require "docdata/order/payment_method"
+require "docdata/order/request"
+require "docdata/order/response"
+require "docdata/order/urls"
+require "docdata/order/version"

data/lib/docdata/order/client.rb

@@ -0,0 +1,71 @@
+# frozen_string_literal: true
+
+require "savon"
+
+module Docdata
+  module Order
+    # Client for the Docdata Order API.
+    class Client
+      XMLNS_DDP = "http://www.docdatapayments.com/services/paymentservice/1_3/"
+      DDP_VERSION = "1.3"
+
+      def initialize(name, password, options = {})
+        @options = options.merge(merchant: { name: name, password: password })
+      end
+
+      def create(options = {})
+        params = @options.merge(options)
+
+        response = client.call(:create, message: CreateRequest.new(params), attributes: { xmlns: XMLNS_DDP, version: DDP_VERSION })
+
+        raise Exception, response unless response.success?
+
+        CreateResponse.new(params, response)
+      end
+
+      def start(options = {})
+        params = @options.merge(options)
+
+        response = client.call(:start, message: StartRequest.new(params), attributes: { xmlns: XMLNS_DDP, version: DDP_VERSION })
+
+        raise Exception, response unless response.success?
+
+        StartResponse.new(params, response)
+      end
+
+      def status(options = {})
+        params = @options.merge(options)
+
+        response = client.call(:status_extended, message: ExtendedStatusRequest.new(params), attributes: { xmlns: XMLNS_DDP, version: DDP_VERSION })
+
+        raise Exception, response unless response.success?
+
+        ExtendedStatusResponse.new(params, response)
+      end
+
+      private
+
+      def client
+        @client ||= begin
+          params = { wsdl: wsdl_url, raise_errors: false, namespace_identifier: nil, namespaces: { "xmlns:ddp" => XMLNS_DDP } }
+
+          if @options[:debug]
+            params.merge!(log: true, log_level: :debug, pretty_print_xml: true)
+          end
+
+          params[:logger] = Rails.logger if defined?(Rails)
+
+          Savon.client(params)
+        end
+      end
+
+      def wsdl_url
+        if @options[:test]
+          Urls::WSDL_TEST_URL
+        else
+          Urls::WSDL_LIVE_URL
+        end
+      end
+    end
+  end
+end

data/lib/docdata/order/exception.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+module Docdata
+  module Order
+    class Exception < StandardError
+    end
+  end
+end

data/lib/docdata/order/gender.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module Docdata
+  module Order
+    module Gender
+      MALE = "M"
+      FEMALE = "F"
+      UNDEFINED = "U"
+    end
+  end
+end

data/lib/docdata/order/ideal.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+module Docdata
+  module Order
+    module Ideal
+      ISSUERS = {
+        "ABNANL2A" => "ABN AMRO",
+        "ASNBNL21" => "ASN Bank",
+        "BUNQNL2A" => "Bunq",
+        "INGBNL2A" => "ING",
+        "KNABNL2H" => "Knab bank",
+        "RABONL2U" => "Rabobank",
+        "RBRBNL21" => "RegioBank",
+        "SNSBNL2A" => "SNS Bank",
+        "TRIONL2U" => "Triodos Bank",
+        "FVLBNL22" => "Van Lanschot"
+      }.freeze
+    end
+  end
+end

data/lib/docdata/order/payment_method.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+module Docdata
+  module Order
+    module PaymentMethod
+      IDEAL = "IDEAL"
+      VISA = "VISA"
+      MASTER_CARD = "MASTERCARD"
+      AMERICAN_EXPRESS = "AMEX"
+      PAYPAL = "PAYPAL_EXPRESS_CHECKOUT"
+      SEPA_DIRECT_DEBIT = "SEPA_DIRECT_DEBIT"
+    end
+  end
+end

data/lib/docdata/order/request.rb

@@ -0,0 +1,282 @@
+# frozen_string_literal: true
+
+require "builder/xmlmarkup"
+require "bigdecimal"
+require "securerandom"
+
+module Docdata
+  module Order
+    # Base class for XML requests to Docdata.
+    class Request
+      attr_reader :options
+
+      def initialize(options = {})
+        @options = options
+      end
+
+      def to_s
+        builder = Builder::XmlMarkup.new
+
+        # Merchant credentials.
+        builder.merchant(name: merchant_name, password: merchant_password)
+
+        build_request(builder)
+
+        # This element contains information about the application contacting the webservice.
+        # This info is useful when debugging troubleshooting technical integration issues.
+        builder.integrationInfo do |integration|
+          # The name of the plugin used to contact this webservice.
+          integration.webshopPlugin("docdata-order")
+          # The version of the plugin used to contact this webservice.
+          integration.webshopPluginVersion(Docdata::Order::VERSION)
+          # The name of the plugin creator used to contact this webservice.
+          integration.integratorName("Kentaa")
+          # The programming language used to contact this webservice.
+          integration.programmingLanguage("Ruby #{RUBY_VERSION}")
+          # The operating system from which this webservice is contacted.
+          integration.operatingSystem(RUBY_PLATFORM)
+          # The full version number (including minor e.q. 1.3.0)
+          # of the xsd which is used during integration. DDP can make minor
+          # (non-breaking) changes to the xsd. These are reflected in a minor
+          # version number. It can therefore be useful to know if a different
+          # minor version of the xsd was used during merchant development than
+          # the one currently active in production.
+          integration.ddpXsdVersion(Docdata::Order::Client::DDP_VERSION)
+        end
+
+        builder.target!
+      end
+
+      private
+
+      def merchant_name
+        options.fetch(:merchant).fetch(:name)
+      end
+
+      def merchant_password
+        options.fetch(:merchant).fetch(:password)
+      end
+
+      def build_request
+        raise NotImplementedError
+      end
+    end
+
+    # Create an Order in the Docdata system.
+    class CreateRequest < Request
+      def build_request(builder)
+        # Unique merchant reference to this order.
+        builder.merchantOrderReference(order_reference)
+
+        # Preferences to use for this payment.
+        builder.paymentPreferences do |preferences|
+          # The profile that is used to select the payment methods that can be used to pay this order.
+          preferences.profile(profile)
+          preferences.numberOfDaysToPay(14)
+        end
+
+        # Information concerning the shopper who placed the order.
+        builder.shopper(id: shopper_id) do |shopper|
+          # Shopper's full name.
+          shopper.name do |name|
+            # The first given name.
+            name.first(shopper_first_name)
+            # Any subsequent given name or names. May also be used as middle initial.
+            name.middle(shopper_infix) if shopper_infix
+            # The family or inherited name(s).
+            name.last(shopper_last_name)
+          end
+
+          # Shopper's e-mail address.
+          shopper.email(shopper_email)
+          # Shopper's preferred language. Language code according to ISO 639.
+          shopper.language(code: shopper_language)
+          # Shopper's gender.
+          shopper.gender(shopper_gender)
+          # Ip address of the shopper. Will be used in the future for riskchecks. Can be ipv4 or ipv6.
+          shopper.ipAddress(shopper_ip_address) if shopper_ip_address
+        end
+
+        # Total order gross amount. The amount in the minor unit for the given currency.
+        # (E.g. for EUR in cents)
+        builder.totalGrossAmount(amount, currency: currency)
+
+        # Name and address to use for billing.
+        builder.billTo do |bill|
+          bill.name do |name|
+            # The first given name.
+            name.first(shopper_first_name)
+            # Any subsequent given name or names. May also be used as middle initial.
+            name.middle(shopper_infix) if shopper_infix
+            # The family or inherited name(s).
+            name.last(shopper_last_name)
+          end
+          # Address of the destination.
+          bill.address do |address|
+            # Address lines must be filled as specific as possible using the house number
+            # and optionally the house number addition field.
+            address.street(address_street)
+            # The house number.
+            address.houseNumber(address_house_number)
+            address.postalCode(address_postal_code)
+            address.city(address_city)
+            # Country code according to ISO 3166.
+            address.country(code: address_country)
+          end
+        end
+
+        # The description of the order.
+        builder.description(description)
+
+        # The description that is used by payment providers on shopper statements.
+        builder.receiptText(receipt_text)
+      end
+
+      private
+
+      def amount
+        decimal = BigDecimal.new(options.fetch(:amount).to_s)
+        decimal *= 100 # to cents
+        decimal.to_i
+      end
+
+      def order_reference
+        options.fetch(:order_reference)
+      end
+
+      def profile
+        options.fetch(:profile)
+      end
+
+      def shopper_id
+        options.fetch(:shopper)[:id] || SecureRandom.hex
+      end
+
+      def shopper_first_name
+        options.fetch(:shopper).fetch(:first_name)
+      end
+
+      def shopper_infix
+        options.fetch(:shopper)[:infix]
+      end
+
+      def shopper_last_name
+        options.fetch(:shopper).fetch(:last_name)
+      end
+
+      def shopper_email
+        options.fetch(:shopper).fetch(:email)
+      end
+
+      def shopper_language
+        options.fetch(:shopper).fetch(:language)
+      end
+
+      def shopper_gender
+        options.fetch(:shopper).fetch(:gender)
+      end
+
+      def shopper_ip_address
+        options.fetch(:shopper)[:ip_address]
+      end
+
+      def address_street
+        options.fetch(:address).fetch(:street)
+      end
+
+      def address_house_number
+        options.fetch(:address).fetch(:house_number)
+      end
+
+      def address_postal_code
+        options.fetch(:address).fetch(:postal_code)
+      end
+
+      def address_city
+        options.fetch(:address).fetch(:city)
+      end
+
+      def address_country
+        options.fetch(:address).fetch(:country)
+      end
+
+      def currency
+        options[:currency] || "EUR"
+      end
+
+      def description
+        options.fetch(:description)
+      end
+
+      def receipt_text
+        options.fetch(:description)[0, 49]
+      end
+    end
+
+    # Start a payment order (Webdirect).
+    class StartRequest < Request
+      def build_request(builder)
+        # Payment order key belonging to the order for which a transaction needs to be started.
+        builder.paymentOrderKey(order_key)
+
+        builder.payment do |payment|
+          payment.paymentMethod(payment_method)
+
+          case payment_method
+          when PaymentMethod::IDEAL
+            payment.iDealPaymentInput do |input|
+              input.issuerId(issuer_id)
+            end
+          when PaymentMethod::SEPA_DIRECT_DEBIT
+            payment.directDebitPaymentInput do |input|
+              input.holderName(account_name)
+              input.iban(account_iban)
+              input.bic(account_bic) if account_bic
+            end
+          else
+            raise ArgumentError, "Payment method not supported: #{payment_method}"
+          end
+        end
+      end
+
+      private
+
+      def order_key
+        options.fetch(:order_key)
+      end
+
+      def payment_method
+        options.fetch(:payment_method)
+      end
+
+      def issuer_id
+        options.fetch(:issuer_id)
+      end
+
+      def account_name
+        options.fetch(:account_name)
+      end
+
+      def account_iban
+        options.fetch(:account_iban)
+      end
+
+      def account_bic
+        options[:account_bic]
+      end
+    end
+
+    # Retrieve additional status information of an Order.
+    class ExtendedStatusRequest < Request
+      def build_request(builder)
+        builder.paymentOrderKey(order_key)
+      end
+
+      private
+
+      def order_key
+        options.fetch(:order_key)
+      end
+    end
+  end
+end

data/lib/docdata/order/response.rb

@@ -0,0 +1,328 @@
+# frozen_string_literal: true
+
+require "uri"
+
+module Docdata
+  module Order
+    # Base class for responses.
+    class Response
+      attr_reader :options, :response
+
+      def initialize(options, response)
+        @options = options
+        @response = response
+      end
+
+      def body
+        response.body
+      end
+
+      def error_message
+        errors[:error] if errors
+      end
+
+      def error_code
+        errors[:error].attributes["code"] if errors
+      end
+    end
+
+    # Response to a create operation.
+    class CreateResponse < Response
+      def data
+        body[:create_response]
+      end
+
+      def success?
+        data.key?(:create_success)
+      end
+
+      def error?
+        data.key?(:create_errors)
+      end
+
+      def errors
+        data[:create_errors]
+      end
+
+      def order_key
+        data[:create_success][:key]
+      end
+
+      def redirect_url
+        params = {
+          command: "show_payment_cluster",
+          merchant_name: merchant_name,
+          client_language: client_language,
+          payment_cluster_key: order_key
+        }
+
+        if payment_method
+          params[:default_pm] = payment_method
+
+          case payment_method
+          when PaymentMethod::IDEAL
+            params[:default_act] = true
+            params[:ideal_issuer_id] = issuer_id if issuer_id
+          when PaymentMethod::PAYPAL
+            params[:default_act] = true
+          end
+        end
+
+        if return_url
+          params.merge!(
+            return_url_success: build_return_url("success"),
+            return_url_canceled: build_return_url("cancelled"),
+            return_url_pending: build_return_url("pending"),
+            return_url_error: build_return_url("error")
+          )
+        end
+
+        uri = URI.parse(redirect_base_url)
+        uri.query = URI.encode_www_form(params)
+        uri.to_s
+      end
+
+      private
+
+      def redirect_base_url
+        if options[:test]
+          Urls::MENU_TEST_URL
+        else
+          Urls::MENU_LIVE_URL
+        end
+      end
+
+      def merchant_name
+        options.fetch(:merchant).fetch(:name)
+      end
+
+      def client_language
+        options.fetch(:shopper).fetch(:language)
+      end
+
+      def payment_method
+        options[:payment_method]
+      end
+
+      def issuer_id
+        options[:issuer_id]
+      end
+
+      def return_url
+        options[:return_url]
+      end
+
+      def build_return_url(status)
+        uri = URI.parse(return_url)
+        query = URI.decode_www_form(uri.query || "") << ["status", status]
+        uri.query = URI.encode_www_form(query)
+        uri.to_s
+      end
+    end
+
+    # Response to a start operation.
+    class StartResponse < Response
+      def data
+        body[:start_response]
+      end
+
+      def success?
+        data.key?(:start_success)
+      end
+
+      def error?
+        data.key?(:start_errors)
+      end
+
+      def errors
+        data[:start_errors]
+      end
+
+      def payment_response
+        data[:start_success][:payment_response]
+      end
+
+      def payment_success
+        payment_response[:payment_success] if payment_response
+      end
+
+      def payment_id
+        payment_success[:id] if payment_success
+      end
+    end
+
+    # Response to a extended status operation.
+    class ExtendedStatusResponse < Response
+      def data
+        body[:extended_status_response]
+      end
+
+      def success?
+        data.key?(:status_success)
+      end
+
+      def error?
+        data.key?(:status_errors)
+      end
+
+      def errors
+        data[:status_errors]
+      end
+
+      def report
+        data[:status_success][:report]
+      end
+
+      def payment
+        payment = report[:payment]
+
+        # When multiple payments are found, return the payment with the newest ID.
+        if payment.is_a?(Array)
+          payment.sort_by { |key, _value| key[:id] }.last
+        else
+          payment
+        end
+      end
+
+      def payment_id
+        payment[:id] if payment
+      end
+
+      def payment_method
+        payment[:payment_method] if payment
+      end
+
+      def authorization
+        payment[:authorization] if payment
+      end
+
+      # The state of the authorization. Current known values:
+      #                           NEW   This is a new payment without any actions performed on it yet.
+      #                 RISK_CHECK_OK   For this payment the risk check was okay.
+      #             RISK_CHECK_FAILED   The risk check for this payment triggered.
+      #                       STARTED   The user has provided details and is authenticated.
+      #                   START_ERROR   The payment system could not start the payment due to a technical error.
+      #                 AUTHENTICATED   The shopper is authenticated by the acquirer.
+      # REDIRECTED_FOR_AUTHENTICATION   The shopper is redirected to the acquirer web-site for authentication.
+      #         AUTHENTICATION_FAILED   The shopper is not authenticated by the acquirer.
+      #          AUTHENTICATION_ERROR   Unable to do the authentication of the shopper by the acquirer.
+      #                    AUTHORIZED   This payment is authorized.
+      #  REDIRECTED_FOR_AUTHORIZATION   The shopper is redirected to the acquirer web-site for authorization.
+      #       AUTHORIZATION_REQUESTED   Requested authorization for this payment, waiting for a notification from acquirer.
+      #          AUTHORIZATION_FAILED   The payment was not authorized due to a functional error.
+      #           AUTHORIZATION_ERROR   Unable to do the payment authorization due to a technical error.
+      #                      CANCELED   The payment is canceled.
+      #                 CANCEL_FAILED   Payment is not canceled, due to functional error.
+      #                  CANCEL_ERROR   Payment is not canceled, due to technical error.
+      #              CANCEL_REQUESTED   A cancel request sent to acquirer.
+      def authorization_status
+        authorization[:status] if authorization
+      end
+
+      def approximate_totals
+        report[:approximate_totals]
+      end
+
+      def total_registered
+        to_decimal(approximate_totals[:total_registered])
+      end
+
+      def total_shopper_pending
+        to_decimal(approximate_totals[:total_shopper_pending])
+      end
+
+      def total_acquirer_pending
+        to_decimal(approximate_totals[:total_acquirer_pending])
+      end
+
+      def total_acquirer_approved
+        to_decimal(approximate_totals[:total_acquirer_approved])
+      end
+
+      def total_captured
+        to_decimal(approximate_totals[:total_captured])
+      end
+
+      def total_refunded
+        to_decimal(approximate_totals[:total_refunded])
+      end
+
+      def total_reversed
+        to_decimal(approximate_totals[:total_chargedback])
+      end
+
+      def total_charged_back
+        to_decimal(approximate_totals[:total_chargedback])
+      end
+
+      def paid?
+        (total_registered == total_captured) || (total_registered == total_acquirer_approved)
+      end
+
+      def refunded?
+        total_registered == total_refunded
+      end
+
+      def charged_back?
+        total_registered == total_charged_back
+      end
+
+      def reversed?
+        total_registered == total_reversed
+      end
+
+      def started?
+        (authorization_status == "NEW" || authorization_status == "STARTED" ||
+          (total_captured.zero? && total_acquirer_approved.zero?)) && authorization_status != "CANCELED"
+      end
+
+      def cancelled?
+        authorization_status == "CANCELED"
+      end
+
+      def account_iban
+        case payment_method
+        when PaymentMethod::IDEAL
+          payment_info = payment[:extended][:i_deal_payment_info]
+          payment_info[:shopper_bank_account][:iban] if payment_info && payment_info[:shopper_bank_account]
+        when PaymentMethod::SEPA_DIRECT_DEBIT
+          payment_info = payment[:extended][:sepa_direct_debit_payment_info]
+          payment_info[:iban] if payment_info
+        end
+      end
+
+      def account_bic
+        case payment_method
+        when PaymentMethod::IDEAL
+          payment_info = payment[:extended][:i_deal_payment_info]
+          payment_info[:shopper_bank_account][:bic] if payment_info && payment_info[:shopper_bank_account]
+        when PaymentMethod::SEPA_DIRECT_DEBIT
+          payment_info = payment[:extended][:sepa_direct_debit_payment_info]
+          payment_info[:bic] if payment_info
+        end
+      end
+
+      def account_name
+        if payment_method == PaymentMethod::IDEAL
+          payment_info = payment[:extended][:i_deal_payment_info]
+          payment_info[:holder_name] if payment_info
+        end
+      end
+
+      def mandate_number
+        if payment_method == PaymentMethod::SEPA_DIRECT_DEBIT
+          payment_info = payment[:extended][:sepa_direct_debit_payment_info]
+          payment_info[:mandate_number] if payment_info
+        end
+      end
+
+      private
+
+      def to_decimal(cents)
+        total = BigDecimal.new(cents)
+        total /= 100.0
+        total
+      end
+    end
+  end
+end

data/lib/docdata/order/urls.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module Docdata
+  module Order
+    module Urls
+      # WSDL location, see Order API 1.3.
+      WSDL_LIVE_URL = "https://secure.docdatapayments.com/ps/services/paymentservice/1_3?wsdl"
+      WSDL_TEST_URL = "https://test.docdatapayments.com/ps/services/paymentservice/1_3?wsdl"
+
+      # Payment Menu base URL, see Functional API.
+      MENU_LIVE_URL = "https://secure.docdatapayments.com/ps/menu"
+      MENU_TEST_URL = "https://test.docdatapayments.com/ps/menu"
+    end
+  end
+end

data/lib/docdata/order/version.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+module Docdata
+  module Order
+    VERSION = "1.0.0"
+  end
+end

metadata

@@ -0,0 +1,148 @@
+--- !ruby/object:Gem::Specification
+name: docdata-order
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- Kentaa
+autorequire: 
+bindir: exe
+cert_chain: []
+date: 2018-02-09 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.14'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.14'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: webmock
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.3'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 2.3.2
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.3'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 2.3.2
+- !ruby/object:Gem::Dependency
+  name: savon
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '2.0'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '2.0'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+description: 
+email:
+- support@kentaa.nl
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".rspec"
+- ".rubocop.yml"
+- ".travis.yml"
+- CHANGELOG.md
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- bin/console
+- bin/setup
+- docdata-order.gemspec
+- lib/docdata/order.rb
+- lib/docdata/order/client.rb
+- lib/docdata/order/exception.rb
+- lib/docdata/order/gender.rb
+- lib/docdata/order/ideal.rb
+- lib/docdata/order/payment_method.rb
+- lib/docdata/order/request.rb
+- lib/docdata/order/response.rb
+- lib/docdata/order/urls.rb
+- lib/docdata/order/version.rb
+homepage: https://github.com/KentaaNL/docdata-order
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.0.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.6.14
+signing_key: 
+specification_version: 4
+summary: Ruby client for the Docdata Order API
+test_files: []