adyen-ruby-api-library 4.3.0 → 6.0.0

data/lib/adyen/services/payments.rb

@@ -1,12 +1,12 @@
-require_relative 'service'
+require_relative "service"
 
 module Adyen
   class Payments < Service
     attr_accessor :version
-    DEFAULT_VERSION = 50
+    DEFAULT_VERSION = 64
 
     def initialize(client, version = DEFAULT_VERSION)
-      service = 'Payment'
+      service = "Payment"
       method_names = [
         :authorise,
         :authorise3d,
@@ -16,10 +16,19 @@ module Adyen
         :refund,
         :cancel_or_refund,
         :adjust_authorisation,
-        :donate
+        :donate,
+        :get_authentication_result,
+        :technical_cancel,
+        :void_pending_refund,
+        :retrieve_3ds2_result
+      ]
+      with_application_info = [
+        :authorise,
+        :authorise3d,
+        :authorise3ds2
       ]
 
-      super(client, version, service, method_names)
+      super(client, version, service, method_names, with_application_info)
     end
   end
 end

data/lib/adyen/services/payouts.rb

@@ -3,7 +3,7 @@ require_relative 'service'
 module Adyen
   class Payouts < Service
     attr_accessor :version
-    DEFAULT_VERSION = 30
+    DEFAULT_VERSION = 64
 
     def initialize(client, version = DEFAULT_VERSION)
       service = 'Payout'
@@ -12,7 +12,8 @@ module Adyen
         :store_detail_and_submit_third_party,
         :submit_third_party,
         :confirm_third_party,
-        :decline_third_party
+        :decline_third_party,
+        :payout
       ]
 
       super(client, version, service, method_names)

data/lib/adyen/services/recurring.rb

@@ -3,14 +3,15 @@ require_relative 'service'
 module Adyen
   class Recurring < Service
     attr_accessor :version
-    DEFAULT_VERSION = 30
+    DEFAULT_VERSION = 49
 
     def initialize(client, version = DEFAULT_VERSION)
       service = 'Recurring'
       method_names = [
         :list_recurring_details,
         :disable,
-        :store_token
+        :store_token,
+        :schedule_account_updater
       ]
 
       super(client, version, service, method_names)

data/lib/adyen/services/service.rb

@@ -11,7 +11,7 @@ module Adyen
       method_name.to_s.gsub(/_./) { |x| x[1].upcase }
     end
 
-    def initialize(client, version, service, method_names)
+    def initialize(client, version, service, method_names, with_application_info = [])
       @client = client
       @version = version
       @service = service
@@ -20,7 +20,7 @@ module Adyen
       method_names.each do |method_name|
         define_singleton_method method_name do |request, headers = {}|
           action = self.class.action_for_method_name(method_name)
-          @client.call_adyen_api(@service, action, request, headers, @version)
+          @client.call_adyen_api(@service, action, request, headers, @version, with_application_info.include?(method_name))
         end
       end
     end

data/lib/adyen/version.rb

@@ -1,4 +1,4 @@
 module Adyen
   NAME = "adyen-ruby-api-library"
-  VERSION = "4.3.0".freeze
+  VERSION = "6.0.0".freeze
 end

data/lib/adyen-ruby-api-library.rb

@@ -2,7 +2,6 @@ require_relative "adyen/version"
 require_relative "adyen/client"
 require_relative "adyen/errors"
 require_relative "adyen/services/checkout"
-require_relative "adyen/services/checkout_utility"
 require_relative "adyen/services/payments"
 require_relative "adyen/services/payouts"
 require_relative "adyen/services/recurring"
@@ -10,5 +9,7 @@ require_relative "adyen/services/marketpay"
 require_relative "adyen/services/postfmapi"
 require_relative "adyen/services/service"
 require_relative "adyen/services/data_protection"
+require_relative "adyen/services/dispute"
+require_relative "adyen/services/bin_lookup"
 require_relative "adyen/hash_with_accessors"
 require_relative "adyen/utils/hmac_validator"

data/spec/account_spec.rb

@@ -20,7 +20,10 @@ RSpec.describe Adyen::Payments, service: "marketpay account service" do
     ["upload_document", "pspReference", "9914762681460244"],
     ["get_uploaded_documents", "pspReference", "9914694369860322"],
     ["delete_bank_accounts", "pspReference", "9914694372670551"],
-    ["delete_shareholders", "pspReference", "9914694372990637"]
+    ["delete_shareholders", "pspReference", "9914694372990637"],
+    ["delete_signatories", "pspReference", "9914694372990637"],
+    ["delete_payout_methods", "pspReference", "9914694372990637"],
+    ["check_account_holder", "pspReference", "9914694372990637"],
   ]
 
   generate_tests(client, "Account", test_sets, client.marketpay.account)

data/spec/bin_lookup_spec.rb

@@ -0,0 +1,15 @@
+require "spec_helper"
+
+RSpec.describe Adyen::BinLookup, service: "BIN lookup service" do
+  # client instance to be used in dynamically generated tests
+  client = create_client(:basic)
+
+  # methods / values to test for
+  # format is defined in spec_helper
+  test_sets = [
+    ["get_3ds_availability", "threeDS2supported", false],
+    ["get_cost_estimate", "resultCode", "Success"]
+  ]
+
+  generate_tests(client, "BinLookup", test_sets, client.bin_lookup)
+end

data/spec/checkout_spec.rb

@@ -13,9 +13,79 @@ RSpec.describe Adyen::Checkout, service: "checkout" do
 
   # must be created manually because every field in the response is an array
   it "makes a payment_methods call" do
-    parsed_body = create_test(@shared_values[:client], @shared_values[:service], "payment_methods", @shared_values[:client].checkout)
-    expect(parsed_body["paymentMethods"].class).
-      to be Array
+    request_body = JSON.parse(json_from_file("mocks/requests/Checkout/payment_methods.json"))
+
+    response_body = json_from_file("mocks/responses/Checkout/payment_methods.json")
+
+    url = @shared_values[:client].service_url(@shared_values[:service], "paymentMethods", @shared_values[:client].checkout.version)
+    WebMock.stub_request(:post, url).
+      with(
+        body: request_body,
+        headers: {
+          "x-api-key" => @shared_values[:client].api_key
+        }
+      ).
+      to_return(
+        body: response_body
+      )
+
+    result = @shared_values[:client].checkout.payment_methods(request_body)
+    response_hash = result.response
+
+    expect(result.status).
+      to eq(200)
+    expect(response_hash).
+      to eq(JSON.parse(response_body))
+    expect(response_hash).
+      to be_a Adyen::HashWithAccessors
+    expect(response_hash).
+      to be_a_kind_of Hash
+  end
+
+  it "makes a paymentMethods/balance call" do
+    request_body = JSON.parse(json_from_file("mocks/requests/Checkout/payment_methods_balance.json"))
+    request_body[:applicationInfo] = {}
+    request_body[:applicationInfo][:adyenPaymentSource] = {
+      :name => "adyen-test",
+      :version => "1.0.0",
+    }
+
+    @shared_values[:client].add_application_info(request_body)
+
+    response_body = json_from_file("mocks/responses/Checkout/payment_methods_balance.json")
+
+    url = @shared_values[:client].service_url(@shared_values[:service], "paymentMethods/balance", @shared_values[:client].checkout.version)
+    WebMock.stub_request(:post, url).
+      with(
+        body: request_body,
+        headers: {
+          "x-api-key" => @shared_values[:client].api_key
+        }
+      ).
+      to_return(
+        body: response_body
+      )
+
+    result = @shared_values[:client].checkout.payment_methods.balance(request_body)
+    # result.response is already a Ruby hash (rather than an unparsed JSON string)
+    response_hash = result.response
+
+    expect(request_body[:applicationInfo][:adyenLibrary][:name]).
+      to eq(Adyen::NAME)
+    expect(request_body[:applicationInfo][:adyenLibrary][:version]).
+      to eq(Adyen::VERSION)
+    expect(request_body[:applicationInfo][:adyenPaymentSource][:name]).
+      to eq("adyen-test")
+    expect(result.status).
+      to eq(200)
+    expect(response_hash).
+      to eq(JSON.parse(response_body))
+    expect(response_hash).
+      to be_a Adyen::HashWithAccessors
+    expect(response_hash).
+      to be_a_kind_of Hash
+    expect(response_hash["balance"]).
+      to eq("100")
   end
 
   # must be created manually due to payments/details format
@@ -103,6 +173,206 @@ RSpec.describe Adyen::Checkout, service: "checkout" do
       to eq("Authorised")
   end
 
+  # must be created manually due to paymentsLinks format
+  it "makes a paymentLinks call" do
+    request_body = JSON.parse(json_from_file("mocks/requests/Checkout/payment_links.json"))
+    request_body[:applicationInfo] = {}
+    request_body[:applicationInfo][:adyenPaymentSource] = {
+      :name => "adyen-test",
+      :version => "1.0.0",
+    }
+
+    @shared_values[:client].add_application_info(request_body)
+
+    response_body = json_from_file("mocks/responses/Checkout/payment_links.json")
+
+    url = @shared_values[:client].service_url(@shared_values[:service], "paymentLinks", @shared_values[:client].checkout.version)
+    WebMock.stub_request(:post, url).
+      with(
+        body: request_body,
+        headers: {
+          "x-api-key" => @shared_values[:client].api_key
+        }
+      ).
+      to_return(
+        body: response_body
+      )
+
+    result = @shared_values[:client].checkout.payment_links(request_body)
+    response_hash = result.response
+
+    expect(result.status).
+      to eq(200)
+    expect(response_hash).
+      to eq(JSON.parse(response_body))
+    expect(response_hash).
+      to be_a Adyen::HashWithAccessors
+    expect(response_hash).
+      to be_a_kind_of Hash
+  end
+
+  # must be created manually due to paymentsLinks/{linkId} format
+  it "makes a get paymentLinks/{linkId} call" do
+    response_body = json_from_file("mocks/responses/Checkout/get-payment-link.json")
+
+    url = @shared_values[:client].service_url(@shared_values[:service], "paymentLinks/1", @shared_values[:client].checkout.version)
+    WebMock.stub_request(:get, url).
+      with(
+        headers: {
+          "x-api-key" => @shared_values[:client].api_key
+        }
+      ).
+      to_return(
+        body: response_body
+      )
+
+    result = @shared_values[:client].checkout.payment_links.get("1")
+    response_hash = result.response
+
+    expect(result.status).
+      to eq(200)
+    expect(response_hash).
+      to eq(JSON.parse(response_body))
+    expect(response_hash).
+      to be_a Adyen::HashWithAccessors
+    expect(response_hash).
+      to be_a_kind_of Hash
+    expect(response_hash["status"]).
+      to eq("active")
+    expect(response_hash.id).
+      to eq("MockId")
+  end
+
+  # must be created manually due to paymentsLinks/{linkId} format
+  it "makes a patch paymentLinks/{linkId} call" do
+    request_body = {
+      :status => "expired",
+    }
+
+    @shared_values[:client].add_application_info(request_body)
+    response_body = json_from_file("mocks/responses/Checkout/update-payment-link.json")
+
+    url = @shared_values[:client].service_url(@shared_values[:service], "paymentLinks/1", @shared_values[:client].checkout.version)
+    WebMock.stub_request(:patch, url).
+      with(
+        body: request_body,
+        headers: {
+          "x-api-key" => @shared_values[:client].api_key
+        }
+      ).
+      to_return(
+        body: response_body
+      )
+
+    result = @shared_values[:client].checkout.payment_links.update("1", request_body)
+    response_hash = result.response
+
+    expect(result.status).
+      to eq(200)
+    expect(response_hash).
+      to eq(JSON.parse(response_body))
+    expect(response_hash).
+      to be_a Adyen::HashWithAccessors
+    expect(response_hash).
+      to be_a_kind_of Hash
+    expect(response_hash["status"]).
+      to eq("expired")
+    expect(response_hash.id).
+      to eq("MockId")
+  end
+
+  it "makes an orders call" do
+    request_body = JSON.parse(json_from_file("mocks/requests/Checkout/orders.json"))
+
+    response_body = json_from_file("mocks/responses/Checkout/orders.json")
+
+    url = @shared_values[:client].service_url(@shared_values[:service], "orders", @shared_values[:client].checkout.version)
+    WebMock.stub_request(:post, url).
+      with(
+        body: request_body,
+        headers: {
+          "x-api-key" => @shared_values[:client].api_key
+        }
+      ).
+      to_return(
+        body: response_body
+      )
+
+    result = @shared_values[:client].checkout.orders(request_body)
+    response_hash = result.response
+
+    expect(result.status).
+      to eq(200)
+    expect(response_hash).
+      to eq(JSON.parse(response_body))
+    expect(response_hash).
+      to be_a Adyen::HashWithAccessors
+    expect(response_hash).
+      to be_a_kind_of Hash
+    expect(response_hash["remainingAmount"]["value"]).
+      to eq(100)
+  end
+
+  it "makes an orders/cancel call" do
+    request_body = JSON.parse(json_from_file("mocks/requests/Checkout/orders_cancel.json"))
+
+    response_body = json_from_file("mocks/responses/Checkout/orders_cancel.json")
+
+    url = @shared_values[:client].service_url(@shared_values[:service], "orders/cancel", @shared_values[:client].checkout.version)
+    WebMock.stub_request(:post, url).
+      with(
+        body: request_body,
+        headers: {
+          "x-api-key" => @shared_values[:client].api_key
+        }
+      ).
+      to_return(
+        body: response_body
+      )
+
+    result = @shared_values[:client].checkout.orders.cancel(request_body)
+    response_hash = result.response
+
+    expect(result.status).
+      to eq(200)
+    expect(response_hash).
+      to eq(JSON.parse(response_body))
+    expect(response_hash).
+      to be_a Adyen::HashWithAccessors
+    expect(response_hash).
+      to be_a_kind_of Hash
+    expect(response_hash["resultCode"]).
+      to eq("cancelled")
+  end
+
+  it "makes a sessions call" do
+    request_body = JSON.parse(json_from_file("mocks/requests/Checkout/sessions.json"))
+
+    response_body = json_from_file("mocks/responses/Checkout/sessions-success.json")
+
+    url = @shared_values[:client].service_url(@shared_values[:service], "sessions", @shared_values[:client].checkout.version)
+    WebMock.stub_request(:post, url).
+      with(
+        body: request_body,
+        headers: {
+          "x-api-key" => @shared_values[:client].api_key
+        }
+      )
+      .to_return(body: response_body, status: 201)
+
+    result = @shared_values[:client].checkout.sessions(request_body)
+    response_hash = result.response
+
+    expect(result.status).
+      to eq(201)
+    expect(response_hash).
+      to eq(JSON.parse(response_body))
+    expect(response_hash).
+      to be_a Adyen::HashWithAccessors
+    expect(response_hash).
+      to be_a_kind_of Hash
+  end
+
   # create client for automated tests
   client = create_client(:api_key)
 
@@ -110,8 +380,8 @@ RSpec.describe Adyen::Checkout, service: "checkout" do
   # format is defined in spec_helper
   test_sets = [
     ["payment_session", "publicKeyToken", "8115054323780109"],
-    ["payment_links", "url", "https://checkoutshopper-test.adyen.com"],
-    ["payments", "resultCode", "Authorised"]
+    ["payments", "resultCode", "Authorised"],
+    ["origin_keys", "originKeys", { "https://adyen.com" => "mocked_origin_key" }]
   ]
 
   generate_tests(client, "Checkout", test_sets, client.checkout)

data/spec/dispute_spec.rb

@@ -0,0 +1,17 @@
+require "spec_helper"
+
+RSpec.describe Adyen::Dispute, service: "dispute service" do
+  # client instance to be used in dynamically generated tests
+  client = create_client(:basic)
+
+  # methods / values to test for
+  # format is defined in spec_helper
+  test_sets = [
+    ["retrieve_applicable_defense_reasons", "disputeServiceResult", { "success" => true }],
+    ["supply_defense_document", "disputeServiceResult", { "success" => true }],
+    ["delete_dispute_defense_document", "disputeServiceResult", { "success" => true }],
+    ["defend_dispute", "disputeServiceResult", { "success" => true }],
+  ]
+
+  generate_tests(client, "DisputeService", test_sets, client.dispute)
+end

data/spec/fund_spec.rb

@@ -12,7 +12,8 @@ RSpec.describe Adyen::Payments, service: "marketpay fund service" do
     ["account_holder_transaction_list", "pspReference", "9914721175530029"],
     ["refund_not_paid_out_transfers", "pspReference", "9915090894215323"],
     ["setup_beneficiary", "pspReference", "9914860354282596"],
-    ["transfer_funds", "pspReference", "9915090893984580"]
+    ["transfer_funds", "pspReference", "9915090893984580"],
+    ["refund_funds_transfer", "pspReference", "9915090893984580"]
   ]
 
   generate_tests(client, "Fund", test_sets, client.marketpay.fund)

data/spec/mocks/requests/Account/check_account_holder.json

@@ -0,0 +1,5 @@
+{
+  "accountHolderCode": "CODE_OF_ACCOUNT_HOLDER",
+  "accountStateType": "Payout",
+  "tier": "2"
+}

data/spec/mocks/requests/Account/delete_payout_methods.json

@@ -0,0 +1,6 @@
+{
+    "accountHolderCode": "CODE_OF_ACCOUNT_HOLDER",
+    "payoutMethodCodes": [
+        "mock_code"
+    ]
+}

data/spec/mocks/requests/Account/delete_signatories.json

@@ -0,0 +1,6 @@
+{
+  "accountHolderCode": "CODE_OF_ACCOUNT_HOLDER",
+  "signatoryCodes": [
+    "9188218c-576e-4cbe-8e86-72722f453920"
+  ]
+}

data/spec/mocks/requests/BinLookup/get_3ds_availability.json

@@ -0,0 +1,4 @@
+{
+  "merchantAccount": "TestMerchant",
+  "cardNumber": "4111111111111111"
+}

data/spec/mocks/requests/BinLookup/get_cost_estimate.json

@@ -0,0 +1,8 @@
+{
+  "amount": {
+    "currency": "EUR",
+    "value": 1000
+  },
+  "cardNumber": "5101180000000007",
+  "merchantAccount": "TestMerchant"
+}

data/spec/mocks/requests/Checkout/orders.json

@@ -0,0 +1,6 @@
+{
+    "amount": {
+        "currency":"USD",
+        "value": "1000"
+    }
+}

data/spec/mocks/requests/Checkout/orders_cancel.json

@@ -0,0 +1,7 @@
+{
+    "merchantAccount": "MERCHANT_ACCOUNT",
+    "order": {
+        "orderData": "mocked_order_data",
+        "pspReference": "mocked_psp_ref"
+    }
+}

data/spec/mocks/requests/Checkout/origin_keys.json

@@ -0,0 +1,3 @@
+{
+    "originDomains": "https://adyen.com"
+}

data/spec/mocks/requests/Checkout/payment_methods_balance.json

@@ -0,0 +1,9 @@
+
+{
+  "paymentMethod": {
+    "type": "givex",
+    "number": "4126491073027401",
+    "cvc": "737"
+  },
+  "merchantAccount": "YOUR_MERCHANT_ACCOUNT"
+}

data/spec/mocks/requests/Checkout/sessions.json

@@ -0,0 +1,10 @@
+{
+  "merchantAccount": "YourMerchantAccount",
+  "amount": {
+    "value": 100,
+    "currency": "EUR"
+  },
+  "returnUrl": "https://your-company.com/checkout?shopperOrder=12xy..",
+  "reference": "YOUR_PAYMENT_REFERENCE",
+  "countryCode": "NL"
+}

data/spec/mocks/requests/DisputeService/defend_dispute.json

@@ -0,0 +1,5 @@
+{
+  "disputePspReference": "9913486733050065",
+  "defenseReasonCode": "SupplyDefenseMaterial",
+  "merchantAccountCode": "YOUR_MERCHANT_ACCOUNT"
+}

data/spec/mocks/requests/DisputeService/delete_dispute_defense_document.json

@@ -0,0 +1,5 @@
+{
+  "disputePspReference": "9913486733050065",
+  "merchantAccountCode": "YOUR_MERCHANT_ACCOUNT",
+  "defenseDocumentType": "MerchandiseDescription"
+}

data/spec/mocks/requests/DisputeService/retrieve_applicable_defense_reasons.json

@@ -0,0 +1,4 @@
+{
+  "merchantAccount": "YOUR_MERCHANT_ACCOUNT",
+  "disputePspReference": "9913486733050065"
+}

data/spec/mocks/requests/DisputeService/supply_defense_document.json

@@ -0,0 +1,11 @@
+{
+  "defenseDocuments": [
+    {
+      "content": "JVBERi0xLjMKJcTl8uXrp...",
+      "contentType": "application/pdf",
+      "defenseDocumentTypeCode": "MerchandiseDescription"
+    }
+  ],
+  "disputePspReference": "9913486733050065",
+  "merchantAccountCode": "YOUR_MERCHANT_ACCOUNT"
+}

data/spec/mocks/requests/Fund/refund_funds_transfer.json

@@ -0,0 +1,7 @@
+{
+  "originalReference": "190324759",
+  "amount": {
+    "currency": "EUR",
+    "value": 2000
+  }
+}

data/spec/mocks/requests/Payment/get_authentication_result.json

@@ -0,0 +1,4 @@
+{
+    "merchantAccount": "MERCHANT_ACCOUNT",
+    "pspReference": "9914694372990637"
+}

data/spec/mocks/requests/Payment/retrieve_3ds2_result.json

@@ -0,0 +1,4 @@
+{
+    "merchantAccount": "MERCHANT_ACCOUNT",
+    "pspReference": "9914694372990637"
+}

data/spec/mocks/requests/Payment/technical_cancel.json

@@ -0,0 +1,4 @@
+{
+    "merchantAccount": "MERCHANT_ACCOUNT",
+    "originalReference": "9914694372990637"
+}

data/spec/mocks/requests/Payment/void_pending_refund.json

@@ -0,0 +1,4 @@
+{
+    "merchantAccount": "MERCHANT_ACCOUNT",
+    "originalReference": "9914694372990637"
+}

data/spec/mocks/requests/Payout/payout.json

@@ -0,0 +1,8 @@
+{
+    "amount": {
+        "currency": "USD",
+        "value": 1000
+    },
+    "merchantAccount": "MERCHANT_ACCOUNT",
+    "reference": "9876543210"
+}

data/spec/mocks/requests/Recurring/schedule_account_updater.json

@@ -0,0 +1,12 @@
+{
+  "card": {
+    "number": "4111111111111111",
+    "expiryMonth": "8",
+    "expiryYear": "2018",
+    "cvc": "737",
+    "holderName": "John Smith"
+  },
+  "reference": "Merchant Reference",
+  "merchantAccount": "TestMerchant",
+  "shopperReference": "shopperReference"
+}

data/spec/mocks/responses/Account/check_account_holder.json

@@ -0,0 +1,3 @@
+{
+  "pspReference":"9914694372990637"
+}

data/spec/mocks/responses/Account/delete_payout_methods.json

@@ -0,0 +1,3 @@
+{
+    "pspReference": "9914694372990637"
+}

data/spec/mocks/responses/Account/delete_signatories.json

@@ -0,0 +1,3 @@
+{
+  "pspReference":"9914694372990637"
+}