pixelpay_sdk 1.0.2 → 1.0.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: acc458f77dc08528d9e7a2b97dadb9a4ee5d31d2fad16bd614ff4d9cbc489b71
-  data.tar.gz: 7577d6ee6549ee9dcb8fe5eabc513812908446e7cffcbece7e402b4f9db73e08
+  metadata.gz: 594dac058ce11835e6f1999b2214753ac5cb7ff8d47caeb628be1640bba2d749
+  data.tar.gz: cd484011f1f79aad821c0fe61d8dd182bd128d2e78fd3dbed3641ef53e9d19d9
 SHA512:
-  metadata.gz: f4fc2e5dda0a61e715ab3e1d430bbb094577100dced9f58c093f55c6493c7cce74ec5fc938d2bbe65cdd17702f86fb6c2a7bc79397ae4bd814f2f2641773149b
-  data.tar.gz: c054076b82f7385fac19b58e17fd2f3736fa0772739c4b99760ec9e1e24e3035c517a5b036656dea58158e23fbed7c32e6a7763790aa53e3bf8b0d3e30da467a
+  metadata.gz: 5b9e99e31e44d377952e0fd2d83de94ec2a4c9dde06054d209b66542db75b13575d2a8a10241e70037cbede8dd2c97f2b8d9c42059ece7532fb193c4062ff345
+  data.tar.gz: 5f18ccc435f62eb9a65506d8605b45f8895a3d3df4c662117c5f31a1d365f8dca7f966afe426d34386587dd19c699243a288d862b72868a1cea5da78278df0ce

data/CHANGELOG.md

@@ -5,6 +5,16 @@ El formato se basa en [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 y este proyecto se adhiere a [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 Tipos de cambios: `Added`, `Changed`, `Deprecated`, `Removed`, `Fixed`, `Security`.
 
+## [v1.0.4] - 2025-12-23
+- Se agregó headers a settings
+
+## [v1.0.3] - 2025-06-04
+### Added
+- Se agrego la configuración de router a las transacciones con `RouterManager`
+- Campo source para `PaymentTransaction`
+### Fixed
+- Dato de tarjeta actualizado para testing
+
 ## [v1.0.2] - 2024-02-27
 ### Fixed
 - Se arreglan códigos de estados en Nicaragua, Reino Unido, Estados Unidos, Guatemala, Panamá, Perú y Portugal

data/CONTRIBUTING.md

@@ -21,4 +21,31 @@ rake test TEST=test/requests/test_sale_transaction.rb
 Ejecutar unit test en particular:
 ```bash
 rake test TEST=test/models/test_billing.rb TESTOPTS="--name=test_empty_billing"
-```
+```
+
+Otra opción para ejecutar test en particular:
+```bash
+ruby test/services/test_transaction.rb -n test_success_sale_transaction
+```
+
+
+## Preparación de entorno
+
+El sistema macOS ya trae una versión de **Ruby** instalada, pero es posible que no sea completamente compatible con el **SDK**. Por ello, es mejor instalar otra versión.
+
+1. Instalar Ruby Version Manager para gestionar versiones de Ruby: [RVM](https://rvm.io/).
+2. Instalar la versión de ruby: ```rvm install 2.7.6 --with-openssl-dir=$(brew --prefix openssl@1.1) ```
+3. Correr ```gem install bundler```
+
+**Nota**: ```openssl@1.1``` ya deberia estar en homebrew. Revisar con ```brew list```. Si no está, instalarlo antes de ejecutar el paso 2.
+
+**Opción alternativa**
+Es posible que no se permita instalar ```openssl@1.1``` ya que fue deshabilitado por homebrew. En ese caso se puede utilizar otro manejador de versiones de **Ruby** como [rbenv](https://github.com/rbenv/rbenv).
+
+Pasos de instalación:
+
+1. brew install rbenv
+2. rbenv install 2.7.6
+3. rbenv global 2.7.6 (Configura la versión de Ruby por defecto de la computadora)
+
+**Nota** Si se intento la instalación previa de RVM y no se puedo debido al elemento de **openssl@1.1**, comentar en archivo de variables de entorno .zshrc los elementos de RVM.

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    pixelpay_sdk (1.0.2)
+    pixelpay_sdk (1.0.4)
 
 GEM
   remote: https://rubygems.org/
@@ -43,6 +43,7 @@ GEM
 
 PLATFORMS
   arm64-darwin-22
+  arm64-darwin-23
   ruby
   x64-mingw32
 
@@ -55,4 +56,4 @@ DEPENDENCIES
   simplecov
 
 BUNDLED WITH
-   2.4.12
+   2.4.22

data/README.md

@@ -5,12 +5,12 @@
 Para obtener la versión del SDK de PixelPay con Ruby puedes utilizar este comando para instalar directamente:
 
 ``` bash
-gem install pixelpay_sdk-1.0.2
+gem install pixelpay_sdk-1.0.4
 ```
 
 O puedes colocar en el archivo Gemfile la siguiente línea:
 ``` bash
-gem 'pixelpay_sdk', '~> 1.0.2'
+gem 'pixelpay_sdk', '~> 1.0.4'
 ```
 
 Y luego ejecutar:

data/lib/pixelpay_sdk/base/Response.rb

@@ -64,7 +64,7 @@ class Response
   # Returns:
   #   Any: data or nil.
   def get_data(key)
-    return nil if @data.nil? && @data.key?(key.to_s)
+    return nil if @data.nil? || !@data.key?(key.to_s)
 
     @data[key.to_s]
   end

data/lib/pixelpay_sdk/base/ServiceBehaviour.rb

@@ -136,6 +136,12 @@ class ServiceBehaviour
 
     request["x-auth-user"] = @settings.auth_user if @settings.auth_user != ""
 
+    if @settings.headers
+      @settings.headers.each do |key, value|
+        request[key] = value
+      end
+    end
+
     request
   rescue StandardError => e
     exception_response(e)

data/lib/pixelpay_sdk/entities/TransactionResult.rb

@@ -103,9 +103,11 @@ class TransactionResult
   def self.from_response(response)
     entity = TransactionResult.new
 
-    entity.instance_variables.each do |var_name|
-      if response.data.key?(var_name.to_s.delete("@"))
-        entity.instance_variable_set(var_name, response.data[var_name.to_s.delete("@")])
+    if response.respond_to?(:data) && response.data.is_a?(Hash)
+      entity.instance_variables.each do |var_name|
+        if response.data.key?(var_name.to_s.delete("@"))
+          entity.instance_variable_set(var_name, response.data[var_name.to_s.delete("@")])
+        end
       end
     end
 

data/lib/pixelpay_sdk/exceptions/RunningTransactionException.rb

@@ -0,0 +1,2 @@
+class RunningTransactionException < StandardError
+end

data/lib/pixelpay_sdk/libraries/RouterManager.rb

@@ -0,0 +1,52 @@
+require "json"
+require "base64"
+
+require_relative "../services/Transaction"
+require_relative "../request/PaymentTransaction"
+require_relative "../request/SaleTransaction"
+require_relative "../models/Settings"
+
+class RouterManager
+    attr_accessor :transaction, :identifier
+
+    def initialize(request)
+        # Payment transaction
+        @transaction = request
+
+        #Payment transaction source
+        @transaction.source = 'router'
+
+        # PixelPay transaction authentication identifier
+        @identifier = nil
+    end
+
+    # Initialize manager
+    def init_manager(payload)
+        service = Transaction.new(parse_payload(payload))
+
+        if @transaction.is_a?(SaleTransaction)
+            return service.do_sale(@transaction);
+        else
+            return service.do_auth(@transaction)
+        end
+    end
+
+    # Parse the payload string to Object Settings
+    def parse_payload(payload)
+        decoded_payload = Base64.decode64(payload)
+        obj_payload = JSON.parse(decoded_payload)
+
+        settings = Settings.new
+
+        settings.setup_environment(obj_payload["env"])
+        settings.setup_credentials(obj_payload["auth_key"], obj_payload["auth_hash"])
+        settings.setup_endpoint(obj_payload["endpoint"]);
+        settings.setup_language(@transaction.lang);
+
+        if obj_payload["auth_user"] 
+            settings.setup_platform_user(obj_payload["auth_user"])
+        end
+
+        return settings
+    end
+end

data/lib/pixelpay_sdk/models/Settings.rb

@@ -4,7 +4,7 @@ require_relative "../base/Helpers"
 require_relative "../resources/Environment"
 # Settings represents the settings information for a request.
 class Settings
-  attr_accessor :auth_key, :auth_hash, :auth_user, :endpoint, :environment, :lang
+  attr_accessor :auth_key, :auth_hash, :auth_user, :endpoint, :environment, :lang, :headers
 
   # Initialize model
   def initialize
@@ -25,6 +25,10 @@ class Settings
 
     # Settings response messages language
     @lang = nil
+
+    # Request headers
+    @headers = nil
+
   end
 
   # Setup API endpoint URL.
@@ -75,7 +79,7 @@ class Settings
 
   # Setup defaults to Sandbox credentials.
   def setup_sandbox
-    @endpoint = "https://pixel-pay.com"
+    @endpoint = "https://pixelpay.dev"
     @auth_key = "1234567890"
     @auth_hash = Helpers.hash("MD5", "@s4ndb0x-abcd-1234-n1l4-p1x3l")
     @environment = Environment::SANDBOX
@@ -91,4 +95,15 @@ class Settings
 
     self
   end
+
+  # Setup request headers
+  # Args:
+  #   headers (Hash): request headers to be used.
+  # Returns:
+  # Settings: self
+  def setup_headers(headers)
+    @headers = headers
+
+    self
+  end
 end

data/lib/pixelpay_sdk/request/PaymentTransaction.rb

@@ -9,7 +9,7 @@ class PaymentTransaction < RequestBehaviour
                 :billing_country, :billing_state, :billing_city, :billing_zip, :billing_phone, :customer_name,
                 :customer_email, :order_id, :order_currency, :order_amount, :order_tax_amount, :order_shipping_amount,
                 :order_content, :order_extras, :order_note, :order_callback, :authentication_request,
-                :authentication_identifier
+                :authentication_identifier, :source
 
   # Initialize request.
   def initialize
@@ -89,6 +89,9 @@ class PaymentTransaction < RequestBehaviour
 
     # Authentication transaction identifier
     @authentication_identifier = nil
+
+    # Internal processing flow of the transaction (e.g. router, proxy, etc)
+    @source = nil
   end
 
   # Associate and mapping Card model properties to transaction.

data/lib/pixelpay_sdk/services/Transaction.rb

@@ -6,7 +6,9 @@ require_relative "../request/StatusTransaction"
 require_relative "../request/AuthTransaction"
 require_relative "../request/CaptureTransaction"
 require_relative "../request/VoidTransaction"
+require_relative "../libraries/RouterManager"
 require_relative "../exceptions/InvalidTransactionTypeException"
+require_relative "../exceptions/RunningTransactionException"
 
 # Transaction provides a specific structure for a transaction to be performed.
 class Transaction < ServiceBehaviour
@@ -34,7 +36,15 @@ class Transaction < ServiceBehaviour
     err = eval_authentication_transaction(transaction)
     raise InvalidTransactionTypeException, err.message if err.instance_of?(InvalidTransactionTypeException)
 
-    post("api/v2/transaction/sale", transaction)
+    response = post("api/v2/transaction/sale", transaction)
+
+    if response.instance_of?(PayloadResponse)
+      if response.data["transaction_type"] == "router"
+        return RouterManager.new(transaction).init_manager(response.data["payload"])
+      end
+    end
+
+    return response
   rescue StandardError => e
     e
   end
@@ -50,7 +60,15 @@ class Transaction < ServiceBehaviour
     err = eval_authentication_transaction(transaction)
     raise InvalidTransactionTypeException, err.message if err.instance_of?(InvalidTransactionTypeException)
 
-    post("api/v2/transaction/auth", transaction)
+    response = post("api/v2/transaction/auth", transaction)
+
+    if response.instance_of?(PayloadResponse)
+      if response.data["transaction_type"] == "router"
+        return RouterManager.new(transaction).init_manager(response.data["payload"])
+      end
+    end
+
+    return response
   rescue StandardError => e
     e
   end

data/lib/pixelpay_sdk/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module PixelpaySdk
-  VERSION = "1.0.2"
+  VERSION = "1.0.4"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: pixelpay_sdk
 version: !ruby/object:Gem::Version
-  version: 1.0.2
+  version: 1.0.4
 platform: ruby
 authors:
 - Sonia Villeda
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2024-03-05 00:00:00.000000000 Z
+date: 2026-01-05 00:00:00.000000000 Z
 dependencies: []
 description: 
 email:
@@ -40,6 +40,8 @@ files:
 - lib/pixelpay_sdk/entities/TransactionResult.rb
 - lib/pixelpay_sdk/exceptions/InvalidCredentialsException.rb
 - lib/pixelpay_sdk/exceptions/InvalidTransactionTypeException.rb
+- lib/pixelpay_sdk/exceptions/RunningTransactionException.rb
+- lib/pixelpay_sdk/libraries/RouterManager.rb
 - lib/pixelpay_sdk/models/Billing.rb
 - lib/pixelpay_sdk/models/Card.rb
 - lib/pixelpay_sdk/models/Item.rb