connect-sdk-ruby 1.0.0

data/spec/fixtures/resources/payment/duplicate_request.json

@@ -0,0 +1,8 @@
+{
+   "errorId" : "75b0f13a-04a5-41b3-83b8-b295ddb23439-000013c6",
+   "errors" : [ {
+      "code" : "1409",
+      "message" : "DUPLICATE REQUEST IN PROGRESS",
+      "httpStatusCode" : 409
+   } ]
+}

data/spec/fixtures/resources/payment/invalid_authorization.json

@@ -0,0 +1,9 @@
+{
+    "errorId": "fbd8d914-c889-45d3-a396-9e0d9ff9db88-0000006f",
+    "errors": [
+        {
+            "code": "9002",
+            "message": "MISSING_OR_INVALID_AUTHORIZATION"
+        }
+    ]
+}

data/spec/fixtures/resources/payment/invalid_request.json

@@ -0,0 +1,11 @@
+{
+    "errorId": "2c164323-20d3-4e9e-8578-dc562cd7506c-00000058",
+    "errors": [
+        {
+            "code": "21000120",
+            "requestId": "2001803",
+            "propertyName": "cardPaymentMethodSpecificInput.card.expiryDate",
+            "message": "paymentMethodSpecificInput.card.expiryDate (1210) IS IN THE PAST OR NOT IN CORRECT MMYY FORMAT"
+        }
+    ]
+}

data/spec/fixtures/resources/payment/method_not_allowed.html

@@ -0,0 +1 @@
+Method Not Allowed

data/spec/fixtures/resources/payment/not_found.html

@@ -0,0 +1 @@
+Not Found

data/spec/fixtures/resources/payment/pending_approval.json

@@ -0,0 +1,39 @@
+{
+    "creationOutput": {
+        "additionalReference": "00000200002014254946",
+        "externalReference": "000002000020142549460000100001"
+    },
+    "payment": {
+        "id": "000002000020142549460000100001",
+        "paymentOutput": {
+            "amountOfMoney": {
+                "amount": 2345,
+                "currencyCode": "CAD"
+            },
+            "references": {
+                "paymentReference": "0"
+            },
+            "paymentMethod": "card",
+            "cardPaymentMethodSpecificOutput": {
+                "paymentProductId": 1,
+                "authorisationCode": "OK1131",
+                "card": {
+                    "cardNumber": "************9176",
+                    "expiryDate": "1220"
+                },
+                "fraudResults": {
+                    "fraudServiceResult": "error",
+                    "avsResult": "X",
+                    "cvvResult": "M"
+                }
+            }
+        },
+        "status": "PENDING_APPROVAL",
+        "statusOutput": {
+            "isCancellable": true,
+            "statusCode": 600,
+            "statusCodeChangeDateTime": "20150331120036",
+            "isAuthorized": true
+        }
+    }
+}

data/spec/fixtures/resources/payment/rejected.json

@@ -0,0 +1,46 @@
+{
+    "errorId": "2c164323-20d3-4e9e-8578-dc562cd7506c-0000003c",
+    "errors": [
+        {
+            "code": "21000020",
+            "requestId": "2001798",
+            "message": "VALUE **************** OF FIELD CREDITCARDNUMBER DID NOT PASS THE LUHNCHECK"
+        }
+    ],
+    "paymentResult": {
+        "creationOutput": {
+            "additionalReference": "00000200002014254436",
+            "externalReference": "000002000020142544360000100001"
+        },
+        "payment": {
+            "id": "000002000020142544360000100001",
+            "paymentOutput": {
+                "amountOfMoney": {
+                    "amount": 2345,
+                    "currencyCode": "CAD"
+                },
+                "references": {
+                    "paymentReference": "0"
+                },
+                "paymentMethod": "card",
+                "cardPaymentMethodSpecificOutput": {
+                    "paymentProductId": 1
+                }
+            },
+            "status": "REJECTED",
+            "statusOutput": {
+                "errors": [
+                    {
+                        "code": "21000020",
+                        "requestId": "2001798",
+                        "message": "VALUE **************** OF FIELD CREDITCARDNUMBER DID NOT PASS THE LUHNCHECK"
+                    }
+                ],
+                "isCancellable": false,
+                "statusCode": 100,
+                "statusCodeChangeDateTime": "20150330173151",
+                "isAuthorized": false
+            }
+        }
+    }
+}

data/spec/fixtures/resources/properties.proxy.yml

@@ -0,0 +1,13 @@
+--- # YAML settings used in testing the SDK
+  connect.api.endpoint.host: api-sandbox.globalcollect.com
+  connect.api.authorizationType: v1HMAC
+  connect.api.connectTimeout: -1
+  connect.api.socketTimeout: -1
+  connect.api.maxConnections: 10
+  connect.api.integrator: Ingenico
+  # change uri to preferred proxy
+  connect.api.proxy.uri: http://localhost:9999
+  # change username and password to authentication credentials for the proxy, omit the entries if no authentication is required
+  # authentication is done using basic proxy authentication. Therefore, to avoid leaking credentials you should connect to the proxy using SSL
+  connect.api.proxy.username: global-collect
+  connect.api.proxy.password: global-collect

data/spec/fixtures/resources/properties.yml

@@ -0,0 +1,7 @@
+--- # YAML settings used in testing the SDK
+  connect.api.endpoint.host: api-sandbox.globalcollect.com
+  connect.api.authorizationType: v1HMAC
+  connect.api.connectTimeout: -1
+  connect.api.socketTimeout: -1
+  connect.api.maxConnections: 100
+  connect.api.integrator: Ingenico

data/spec/integration/connection_pooling_spec.rb

@@ -0,0 +1,78 @@
+require 'spec_helper'
+require 'integration_setup'
+require 'ingenico/connect/sdk/merchant/services/convert_amount_params'
+require 'ingenico/connect/sdk/factory'
+require 'yaml'
+
+describe 'connection pooling with the server' do
+
+  before(:context){WebMock.allow_net_connect!}
+  after(:context){WebMock.disable_net_connect!}
+
+  it 'runs with one connection per request' do
+    run_connection_pooling_test(10, 10)
+  end
+
+  it 'runs with one connection per two requests' do
+    run_connection_pooling_test(10, 5)
+  end
+
+  it 'runs with one connection for 10 requests' do
+    run_connection_pooling_test(10, 1)
+  end
+end
+
+class Event  # as per https://emptysqua.re/blog/an-event-synchronization-primitive-for-ruby/
+  def initialize
+    @lock = Mutex.new
+    @cond = ConditionVariable.new
+    @flag = false
+  end
+
+  def set
+    @lock.synchronize do
+      @flag = true
+      @cond.broadcast
+    end
+  end
+
+  def wait
+    @lock.synchronize do
+      unless @flag
+        @cond.wait(@lock)
+      end
+    end
+  end
+end
+
+# sends *request_count* requests with a maximum number of connections in the connection pool equal to *max_connections*
+def run_connection_pooling_test(request_count, max_connections)
+  configuration = Integration.init_communicator_configuration(max_connections: max_connections)
+  begin
+    communicator = Ingenico::Connect::SDK::Factory.create_communicator_from_configuration(configuration)
+    flag = Event.new
+    runner_threads = Array.new(request_count){ |i| Thread.new{run_request(i, communicator, flag)} }
+    flag.set
+  ensure
+    communicator.close unless communicator.nil?
+  end
+  results = Array.new(request_count){ |i| runner_threads[i].value }  # returned values are arrays of size 2
+  puts "running times of #{request_count} threads using #{max_connections} connections:"
+  puts "each pair is the thread's start and end time in milliseconds"
+  results.each do |pair|
+    puts pair[0].to_s + ' ' + pair[1].to_s
+  end
+end
+
+def run_request(i, communicator, flag)
+  request = Ingenico::Connect::SDK::Merchant::Services::ConvertAmountParams.new
+  request.source = 'USD'
+  request.target = 'EUR'
+  request.amount = 100*(i+1)
+
+  client = Ingenico::Connect::SDK::Factory.create_client_from_communicator(communicator)
+  flag.wait
+  start_time = Time.now
+  client.merchant(Integration::MERCHANT_ID).services.convert_amount(request)
+  return [start_time.to_i*1000, Time.now.to_i*1000]
+end

data/spec/integration/convert_amount_spec.rb

@@ -0,0 +1,25 @@
+require 'rspec'
+require 'spec_helper'
+require 'integration_setup'
+require 'webmock/rspec'
+require 'ingenico/connect/sdk/merchant/services/convert_amount_params'
+
+describe 'convertAmount with the server' do
+
+  before(:context){WebMock.allow_net_connect!}
+  after(:context){WebMock.disable_net_connect!}
+
+  it 'communicates with the GlobalCollect platform' do
+
+    request = Ingenico::Connect::SDK::Merchant::Services::ConvertAmountParams.new
+    request.amount = 123
+    request.source = 'USD'
+    request.target = 'EUR'
+
+    Integration.init_client(false) do |client|
+      response = client.merchant(Integration::MERCHANT_ID).services.convert_amount(request)
+      expect(response).to_not be_nil
+      expect(response.converted_amount).to be > 0
+    end
+  end
+end

data/spec/integration/idempotence_spec.rb

@@ -0,0 +1,59 @@
+require 'spec_helper'
+require 'integration_setup'
+require 'securerandom'
+require 'webmock/rspec'
+require 'ingenico/connect/sdk/domain/definitions/amount_of_money'
+require 'ingenico/connect/sdk/domain/definitions/address'
+require 'ingenico/connect/sdk/domain/payment/create_payment_request'
+require 'ingenico/connect/sdk/domain/payment/customer'
+require 'ingenico/connect/sdk/domain/payment/order'
+require 'ingenico/connect/sdk/domain/payment/redirect_payment_product809_specific_input'
+require 'ingenico/connect/sdk/domain/payment/redirect_payment_method_specific_input'
+require 'ingenico/connect/sdk/call_context'
+
+describe 'Idempotence with the server' do
+
+  before(:context){WebMock.allow_net_connect!}
+  after(:context){WebMock.disable_net_connect!}
+
+  it 'realises when an idempotent request is sent twice' do
+    amount_of_money = Ingenico::Connect::SDK::Domain::Definitions::AmountOfMoney.new
+    amount_of_money.currency_code = 'EUR'
+    amount_of_money.amount = 100
+    billing_address = Ingenico::Connect::SDK::Domain::Definitions::Address.new
+    billing_address.country_code = 'NL'
+    customer = Ingenico::Connect::SDK::Domain::Payment::Customer.new
+    customer.locale = 'en'
+    customer.billing_address = billing_address
+    order = Ingenico::Connect::SDK::Domain::Payment::Order.new
+    order.amount_of_money = amount_of_money
+    order.customer = customer
+    payment_product_input = Ingenico::Connect::SDK::Domain::Payment::RedirectPaymentProduct809SpecificInput.new
+    payment_product_input.issuer_id = 'INGBNL2A'
+    payment_method_input = Ingenico::Connect::SDK::Domain::Payment::RedirectPaymentMethodSpecificInput.new
+    payment_method_input.return_url = 'http://example.com'
+    payment_method_input.payment_product_id = 809
+    payment_method_input.payment_product809_specific_input = payment_product_input
+    body = Ingenico::Connect::SDK::Domain::Payment::CreatePaymentRequest.new
+    body.order = order
+    body.redirect_payment_method_specific_input = payment_method_input
+    idempotence_key = SecureRandom.uuid
+    context = Ingenico::Connect::SDK::CallContext.new(idempotence_key)
+
+    Integration.init_client(false) do |client|
+      response = client.merchant(Integration::MERCHANT_ID).payments.create(body, context)
+      payment_id = response.payment.id
+
+      expect(payment_id).to_not be_nil
+      expect(context.idempotence_key).to eq(idempotence_key)
+      expect(context.idempotence_request_timestamp).to be_nil
+
+      response_2 = client.merchant(Integration::MERCHANT_ID).payments.create(body, context)
+      payment_id2 = response_2.payment.id
+
+      expect(payment_id).to eq(payment_id2)
+      expect(context.idempotence_key).to eq(idempotence_key)
+      expect(context.idempotence_request_timestamp).to_not be_nil
+    end
+  end
+end

data/spec/integration/multiline_header_spec.rb

@@ -0,0 +1,30 @@
+require 'spec_helper'
+require 'integration_setup'
+require 'webmock/rspec'
+require 'ingenico/connect/sdk/factory'
+require 'ingenico/connect/sdk/meta_data_provider'
+require 'ingenico/connect/sdk/request_header'
+require 'ingenico/connect/sdk/merchant/products/directory_params'
+
+describe 'multiline headers' do
+
+  before(:context){WebMock.allow_net_connect!}
+  after(:context){WebMock.disable_net_connect!}
+
+  it 'should be accepted by the ingenico platform' do
+    multi_line_header = " some value  \r\n \n with        a liberal amount     of \r\n  spaces    "
+    configuration = Integration.init_communicator_configuration
+    meta_data_provider = Ingenico::Connect::SDK::MetaDataProvider.new('Ingenico', additional_request_headers:
+                                                       [Ingenico::Connect::SDK::RequestHeader.new('X-GCS-MultiLineHeader', multi_line_header)])
+    session = Ingenico::Connect::SDK::Factory.create_session_from_configuration(configuration)
+
+    params = Ingenico::Connect::SDK::Merchant::Products::DirectoryParams.new
+    params.country_code = 'NL'
+    params.currency_code = 'EUR'
+
+    Integration.init_client(false) do |client|
+      response = client.merchant(Integration::MERCHANT_ID).products.directory(809, params)
+      expect(response.entries.length).to be > 0
+    end
+  end
+end

data/spec/integration/payment_product_groups_spec.rb

@@ -0,0 +1,23 @@
+require 'spec_helper'
+require 'yaml'
+require 'integration_setup'
+require 'webmock/rspec'
+require 'ingenico/connect/sdk/merchant/productgroups/get_productgroup_params'
+
+describe 'PaymentProductGroups' do
+
+  before(:context){WebMock.allow_net_connect!}
+  after(:context){WebMock.disable_net_connect!}
+
+  it 'can be accessed' do
+
+    params = Ingenico::Connect::SDK::Merchant::Productgroups::GetProductgroupParams.new
+    params.country_code = 'NL'
+    params.currency_code = 'EUR'
+
+    Integration.init_client(false) do |client|
+      response = client.merchant(Integration::MERCHANT_ID).productgroups.get('cards', params)
+      expect(response.id).to eq('cards')
+    end
+  end
+end

data/spec/integration/payment_products_spec.rb

@@ -0,0 +1,22 @@
+require 'spec_helper'
+require 'integration_setup'
+require 'webmock/rspec'
+require 'ingenico/connect/sdk/merchant/products/directory_params'
+
+describe 'PaymentProducts' do
+
+  before(:context){WebMock.allow_net_connect!}
+  after(:context){WebMock.disable_net_connect!}
+
+  it 'can be accessed' do
+
+    params = Ingenico::Connect::SDK::Merchant::Products::DirectoryParams.new
+    params.country_code = 'NL'
+    params.currency_code = 'EUR'
+
+    Integration.init_client(false) do |client|
+      response = client.merchant(Integration::MERCHANT_ID).products.directory(809, params)
+      expect(response.entries.length).to be > 0
+    end
+  end
+end

data/spec/integration/risk_assessments_spec.rb

@@ -0,0 +1,37 @@
+require 'spec_helper'
+require 'integration_setup'
+require 'webmock/rspec'
+require 'ingenico/connect/sdk/domain/definitions/bank_account_bban'
+require 'ingenico/connect/sdk/domain/definitions/amount_of_money'
+require 'ingenico/connect/sdk/domain/riskassessments/customer_risk_assessment'
+require 'ingenico/connect/sdk/domain/riskassessments/order_risk_assessment'
+require 'ingenico/connect/sdk/domain/riskassessments/risk_assessment_bank_account'
+
+describe 'RiskAssessments' do
+
+  before(:context){WebMock.allow_net_connect!}
+  after(:context){WebMock.disable_net_connect!}
+
+  it 'can let the GlobalCollect platform assess risks' do
+    bank_account_bban = Ingenico::Connect::SDK::Domain::Definitions::BankAccountBban.new
+    bank_account_bban.country_code = 'DE'
+    bank_account_bban.account_number = '0532013000'
+    bank_account_bban.bank_code = '37040044'
+    amount_of_money = Ingenico::Connect::SDK::Domain::Definitions::AmountOfMoney.new
+    amount_of_money.amount = 100
+    amount_of_money.currency_code = 'EUR'
+    customer = Ingenico::Connect::SDK::Domain::Riskassessments::CustomerRiskAssessment.new
+    customer.locale = 'en_GB'
+    order = Ingenico::Connect::SDK::Domain::Riskassessments::OrderRiskAssessment.new
+    order.amount_of_money = amount_of_money
+    order.customer = customer
+    body = Ingenico::Connect::SDK::Domain::Riskassessments::RiskAssessmentBankAccount.new
+    body.order = order
+    body.bank_account_bban = bank_account_bban
+
+    Integration.init_client(false) do |client|
+      response = client.merchant(Integration::MERCHANT_ID).riskassessments.bankaccounts(body)
+      expect(response.results.length).to be > 0
+    end
+  end
+end

data/spec/integration/sdk_proxy_spec.rb

@@ -0,0 +1,89 @@
+require 'spec_helper'
+require 'integration_setup'
+require 'ingenico/connect/sdk/factory'
+require 'ingenico/connect/sdk/communicator_configuration'
+require 'ingenico/connect/sdk/proxy_configuration'
+require 'ingenico/connect/sdk/communication_exception'
+require 'ingenico/connect/sdk/merchant/services/convert_amount_params'
+require 'ingenico/connect/sdk/merchant/services/services_client'
+
+require 'webrick'
+require 'webrick/httpproxy'
+
+describe 'proxies' do
+
+  context 'using proxy server' do
+    proxy_server = nil
+
+    password_filename = 'password_file'
+
+    before :context do
+      WebMock.allow_net_connect!
+
+      # set up a proxy
+      proxy_server = Thread.new do
+        config = { Realm: 'testing' }
+        htpasswd = WEBrick::HTTPAuth::Htpasswd.new(password_filename) # create new Apache password file
+        htpasswd.set_passwd config[:Realm], 'global-collect', 'global-collect' # same as properties.proxy.yml
+        config[:UserDB] = htpasswd
+        basic_auth = WEBrick::HTTPAuth::ProxyBasicAuth.new(config)
+
+        auth_handler = Proc.new do |req, res|
+          basic_auth.authenticate(req, res)
+        end
+
+        proxy = WEBrick::HTTPProxyServer.new(Port: 9999, ProxyVia: false,
+                                             ProxyAuthProc: auth_handler)
+        Signal.trap('INT') do
+            proxy.shutdown
+        end
+
+        proxy.start
+      end
+
+      sleep 1 # wait for the proxy server
+    end
+
+    after :context do
+      Thread.kill(proxy_server)
+      File.delete(password_filename)
+      WebMock.disable_net_connect!
+    end
+
+    # NOTE: if this test is running for a long time with no response
+    # check https://api-sandbox.globalcollect.com coz this is where merchant
+    # connects to.
+    it 'can be connected to' do
+      request = Ingenico::Connect::SDK::Merchant::Services::ConvertAmountParams.new
+      request.amount = 123
+      request.source = 'USD'
+      request.target = 'EUR'
+
+      Integration.init_client(true) do |client|
+        services = client.merchant(Integration::MERCHANT_ID).services
+        services.convert_amount(request)
+
+        expect(services).to be_an_instance_of(Ingenico::Connect::SDK::Merchant::Services::ServicesClient)
+      end
+    end
+
+    # test that connecting to a nonexistent proxy will raise an error
+    it 'should be connected to if possible' do
+      yaml = YAML.load_file(Integration::PROPERTIES_URI_PROXY)
+      config = Ingenico::Connect::SDK::CommunicatorConfiguration.new(properties: yaml, connect_timeout: 0.5, socket_timeout: 0.5,
+                                                  authorization_type: 'v1HMAC',
+                                                  api_key_id: Integration::API_KEY_ID,
+                                                  secret_api_key: Integration::SECRET_API_KEY,
+                                                  proxy_configuration: Ingenico::Connect::SDK::ProxyConfiguration.new(host: 'localhost',
+                                                                                                   port: 65535,
+                                                                                                   username: 'arg',
+                                                                                                   password: 'blarg'))
+      begin
+        client = Ingenico::Connect::SDK::Factory.create_client_from_configuration(config)
+        expect{client.merchant(Integration::MERCHANT_ID).services.testconnection}.to raise_error(Ingenico::Connect::SDK::CommunicationException)
+      ensure
+        client.close unless client.nil?
+      end
+    end
+  end # end of using proxy server
+end