pixelpay_sdk 1.0.0.pre.beta.1

data/lib/pixelpay_sdk/responses/PaymentDeclinedResponse.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+require_relative "../base/Response"
+
+# PaymentDeclinedResponse provides a specific structure for a payment declined
+# response coming from a transaction.
+class PaymentDeclinedResponse < Response
+end

data/lib/pixelpay_sdk/responses/PreconditionalResponse.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+require_relative "../base/Response"
+
+# PreconditionalResponse provides a specific structure for a preconditional
+# response coming from a transaction.
+class PreconditionalResponse < Response
+end

data/lib/pixelpay_sdk/responses/SuccessResponse.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+require_relative "../base/Response"
+
+# SuccessResponse provides a specific structure for a success response
+# coming from a transaction.
+class SuccessResponse < Response
+end

data/lib/pixelpay_sdk/responses/TimeoutResponse.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+require_relative "../base/Response"
+
+# TimeoutResponse provides a specific structure for a timeout response
+# coming from a transaction.
+class TimeoutResponse < Response
+end

data/lib/pixelpay_sdk/services/Tokenization.rb

@@ -0,0 +1,65 @@
+# frozen_string_literal: true
+
+require_relative "../base/Helpers"
+require_relative "../base/ServiceBehaviour"
+require_relative "../base/RequestBehaviour"
+require_relative "../models/Settings"
+
+BASE_CARD_PATH = "api/v2/tokenization/card"
+
+# Tokenization provides a specific structure for a tokenization to be performed.
+class Tokenization < ServiceBehaviour
+  # Vault credit/debit card and obtain a token card identifier (T-* format).
+  # Args:
+  #   card (CardTokenization): input card.
+  # Returns:
+  #   Response: processed response.
+  def vault_card(card)
+    Helpers.verify_type(TypeError, CardTokenization, card.instance_of?(CardTokenization))
+
+    post(BASE_CARD_PATH, card)
+  rescue StandardError => e
+    e
+  end
+
+  # Update credit/debit card by token card identifier.
+  # Args:
+  #   token (string): input token.
+  #   card (CardTokenization): input card.
+  # Returns:
+  #   Response: processed response.
+  def update_card(token, card)
+    Helpers.verify_type(TypeError, CardTokenization, card.instance_of?(CardTokenization))
+
+    put("#{BASE_CARD_PATH}/#{token}", card)
+  rescue StandardError => e
+    e
+  end
+
+  # Show credit/debit card metadata by token card identifier.
+  # Args:
+  #   token (string): input token.
+  # Returns:
+  #   Response: processed response.
+  def show_card(token)
+    get("#{BASE_CARD_PATH}/#{token}", RequestBehaviour.new)
+  end
+
+  # Show multiple credit/debit cards metadata by token card identifiers.
+  # Args:
+  #   tokens (array): input token.
+  # Returns:
+  #   Response: processed response.
+  def show_cards(tokens)
+    get("#{BASE_CARD_PATH}/#{tokens.join(":")}", RequestBehaviour.new)
+  end
+
+  # Delete credit/debit card metadata by token card identifier.
+  # Args:
+  #   token (string): input token.
+  # Returns:
+  #   Response: processed response.
+  def delete_card(token)
+    delete("#{BASE_CARD_PATH}/#{token}", RequestBehaviour.new)
+  end
+end

data/lib/pixelpay_sdk/services/Transaction.rb

@@ -0,0 +1,108 @@
+# frozen_string_literal: true
+
+require_relative "../base/Helpers"
+require_relative "../base/ServiceBehaviour"
+require_relative "../request/StatusTransaction"
+require_relative "../exceptions/InvalidTransactionTypeException"
+
+# Transaction provides a specific structure for a transaction to be performed.
+class Transaction < ServiceBehaviour
+  # Evaluate if 3DS transactions is enable.
+  # Args:
+  #   transaction (PaymentTransaction) : input.
+  def eval_authentication_transaction(transaction)
+    Helpers.verify_type(TypeError, PaymentTransaction, transaction.is_a?(PaymentTransaction))
+
+    if transaction.authentication_request
+      raise InvalidTransactionTypeException, "This platform does not support 3DS transactions."
+    end
+  rescue StandardError => e
+    e
+  end
+
+  # Send and proccesing SALE transaction.
+  # Args:
+  #   transaction (SaleTransaction): input.
+  # Returns:
+  #   Response: processed response.
+  def do_sale(transaction)
+    Helpers.verify_type(TypeError, SaleTransaction, transaction.instance_of?(SaleTransaction))
+
+    err = eval_authentication_transaction(transaction)
+    raise InvalidTransactionTypeException, err.message if err.instance_of?(InvalidTransactionTypeException)
+
+    post("api/v2/transaction/sale", transaction)
+  rescue StandardError => e
+    e
+  end
+
+  # Send and proccesing AUTH transaction.
+  # Args:
+  #   transaction (AuthTransaction): input.
+  # Returns:
+  #   Response: processed response.
+  def do_auth(transaction)
+    Helpers.verify_type(TypeError, AuthTransaction, transaction.instance_of?(AuthTransaction))
+
+    err = eval_authentication_transaction(transaction)
+    raise InvalidTransactionTypeException, err.message if err.instance_of?(InvalidTransactionTypeException)
+
+    post("api/v2/transaction/auth", transaction)
+  rescue StandardError => e
+    e
+  end
+
+  # Send and proccesing CAPTURE transaction.
+  # Args:
+  #   transaction (CaptureTransaction): input.
+  # Returns:
+  #   Response: processed response.
+  def do_capture(transaction)
+    Helpers.verify_type(TypeError, CaptureTransaction, transaction.instance_of?(CaptureTransaction))
+
+    post("api/v2/transaction/capture", transaction)
+  rescue StandardError => e
+    e
+  end
+
+  # Send and proccesing VOID transaction.
+  # Args:
+  #   transaction (VoidTransaction): input.
+  # Returns:
+  #   Response: processed response.
+  def do_void(transaction)
+    Helpers.verify_type(TypeError, VoidTransaction, transaction.instance_of?(VoidTransaction))
+
+    post("api/v2/transaction/void", transaction)
+  rescue StandardError => e
+    e
+  end
+
+  # Get transaction status
+  # Args:
+  #   transaction (StatusTransaction): input.
+  # Returns:
+  #   Response: processed response.
+  def get_status(transaction)
+    Helpers.verify_type(TypeError, StatusTransaction, transaction.instance_of?(StatusTransaction))
+
+    post("api/v2/transaction/status", transaction)
+  rescue StandardError => e
+    e
+  end
+
+  # Verifies a payment hash and returns true if payment response has not been modified.
+  # Args:
+  #   hash (string): the hash that will be compared with the order hash.
+  #   orderId (string): parameter represents the order hash to look up.
+  #   secret (string): parameter is a key used to verify the payment hash.
+  # Returns:
+  #   bool: true or false.
+  def verify_payment_hash(hash, order_id, secret)
+    values = []
+    values.append(order_id.to_s, settings.auth_key.to_s, secret.to_s)
+    chain = values.join("|")
+
+    hash.to_s.upcase == Helpers.hash("MD5", chain).upcase
+  end
+end

data/lib/pixelpay_sdk/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module PixelpaySdk
+  VERSION = "1.0.0-beta.1"
+end

data/lib/pixelpay_sdk.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+require_relative "pixelpay_sdk/models/Billing"
+require_relative "pixelpay_sdk/models/Card"
+require_relative "pixelpay_sdk/models/Item"
+require_relative "pixelpay_sdk/models/Order"
+require_relative "pixelpay_sdk/models/Settings"
+
+require_relative "pixelpay_sdk/request/AuthTransaction"
+require_relative "pixelpay_sdk/request/CaptureTransaction"
+require_relative "pixelpay_sdk/request/CardTokenization"
+require_relative "pixelpay_sdk/request/PaymentTransaction"
+require_relative "pixelpay_sdk/request/StatusTransaction"
+require_relative "pixelpay_sdk/request/VoidTransaction"
+
+require_relative "pixelpay_sdk/services/Tokenization"
+require_relative "pixelpay_sdk/services/Transaction"
+
+require_relative "pixelpay_sdk/entities/CardResult"
+require_relative "pixelpay_sdk/entities/TransactionResult"

data/pixelpay_sdk.gemspec

@@ -0,0 +1,38 @@
+# frozen_string_literal: true
+
+require_relative "lib/pixelpay_sdk/version"
+
+Gem::Specification.new do |spec|
+  spec.name = "pixelpay_sdk"
+  spec.version = PixelpaySdk::VERSION
+  spec.authors = ["Sonia Villeda", "Oscar Gómez"]
+  spec.email = ["sonia@pixel.hn", "oscar@pixel.hn"]
+
+  spec.summary = "PixelPay SDK toolkit."
+  spec.homepage = "https://pixel.hn"
+  spec.license = "MIT"
+  spec.required_ruby_version = ">= 2.6.0"
+
+  # spec.metadata["allowed_push_host"] = "TODO: Set to your gem server 'https://example.com'"
+
+  spec.metadata["homepage_uri"] = spec.homepage
+  # spec.metadata["source_code_uri"] = "TODO: Put your gem's public repo URL here."
+  # spec.metadata["changelog_uri"] = "TODO: Put your gem's CHANGELOG.md URL here."
+
+  # Specify which files should be added to the gem when it is released.
+  # The `git ls-files -z` loads the files in the RubyGem that have been added into git.
+  spec.files = Dir.chdir(__dir__) do
+    `git ls-files -z`.split("\x0").reject do |f|
+      (File.expand_path(f) == __FILE__) || f.start_with?(*%w[bin/ test/ spec/ features/ .git .circleci appveyor])
+    end
+  end
+  spec.bindir = "exe"
+  spec.executables = spec.files.grep(%r{\Aexe/}) { |f| File.basename(f) }
+  spec.require_paths = ["lib"]
+
+  # Uncomment to register a new dependency of your gem
+  # spec.add_dependency "json", "~> 2.6", ">= 2.6.3"
+
+  # For more information and examples about making a new gem, check out our
+  # guide at: https://bundler.io/guides/creating_gem.html
+end

data/sig/pixelpay_sdk.rbs

@@ -0,0 +1,4 @@
+module PixelpaySdk
+  VERSION: String
+  # See the writing guide of rbs: https://github.com/ruby/rbs#guides
+end

metadata

@@ -0,0 +1,97 @@
+--- !ruby/object:Gem::Specification
+name: pixelpay_sdk
+version: !ruby/object:Gem::Version
+  version: 1.0.0.pre.beta.1
+platform: ruby
+authors:
+- Sonia Villeda
+- Oscar Gómez
+autorequire: 
+bindir: exe
+cert_chain: []
+date: 2023-05-18 00:00:00.000000000 Z
+dependencies: []
+description: 
+email:
+- sonia@pixel.hn
+- oscar@pixel.hn
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".rubocop.yml"
+- CHANGELOG.md
+- CONTRIBUTING.md
+- Gemfile
+- Gemfile.lock
+- LICENSE.txt
+- README.md
+- Rakefile
+- bitbucket-pipelines.yml
+- lib/pixelpay_sdk.rb
+- lib/pixelpay_sdk/assets/countries.json
+- lib/pixelpay_sdk/assets/formats.json
+- lib/pixelpay_sdk/assets/states.json
+- lib/pixelpay_sdk/base/Helpers.rb
+- lib/pixelpay_sdk/base/RequestBehaviour.rb
+- lib/pixelpay_sdk/base/Response.rb
+- lib/pixelpay_sdk/base/ServiceBehaviour.rb
+- lib/pixelpay_sdk/entities/CardResult.rb
+- lib/pixelpay_sdk/entities/TransactionResult.rb
+- lib/pixelpay_sdk/exceptions/InvalidCredentialsException.rb
+- lib/pixelpay_sdk/exceptions/InvalidTransactionTypeException.rb
+- lib/pixelpay_sdk/models/Billing.rb
+- lib/pixelpay_sdk/models/Card.rb
+- lib/pixelpay_sdk/models/Item.rb
+- lib/pixelpay_sdk/models/Order.rb
+- lib/pixelpay_sdk/models/Settings.rb
+- lib/pixelpay_sdk/request/AuthTransaction.rb
+- lib/pixelpay_sdk/request/CaptureTransaction.rb
+- lib/pixelpay_sdk/request/CardTokenization.rb
+- lib/pixelpay_sdk/request/PaymentTransaction.rb
+- lib/pixelpay_sdk/request/SaleTransaction.rb
+- lib/pixelpay_sdk/request/StatusTransaction.rb
+- lib/pixelpay_sdk/request/VoidTransaction.rb
+- lib/pixelpay_sdk/resources/Environment.rb
+- lib/pixelpay_sdk/resources/Locations.rb
+- lib/pixelpay_sdk/responses/ErrorResponse.rb
+- lib/pixelpay_sdk/responses/FailureResponse.rb
+- lib/pixelpay_sdk/responses/InputErrorResponse.rb
+- lib/pixelpay_sdk/responses/NetworkFailureResponse.rb
+- lib/pixelpay_sdk/responses/NoAccessResponse.rb
+- lib/pixelpay_sdk/responses/NotFoundResponse.rb
+- lib/pixelpay_sdk/responses/PayloadResponse.rb
+- lib/pixelpay_sdk/responses/PaymentDeclinedResponse.rb
+- lib/pixelpay_sdk/responses/PreconditionalResponse.rb
+- lib/pixelpay_sdk/responses/SuccessResponse.rb
+- lib/pixelpay_sdk/responses/TimeoutResponse.rb
+- lib/pixelpay_sdk/services/Tokenization.rb
+- lib/pixelpay_sdk/services/Transaction.rb
+- lib/pixelpay_sdk/version.rb
+- pixelpay_sdk.gemspec
+- sig/pixelpay_sdk.rbs
+homepage: https://pixel.hn
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://pixel.hn
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.6.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">"
+    - !ruby/object:Gem::Version
+      version: 1.3.1
+requirements: []
+rubygems_version: 3.1.6
+signing_key: 
+specification_version: 4
+summary: PixelPay SDK toolkit.
+test_files: []