ipagos_ruby_sdk 0.1.0 → 0.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1362f01d2f6e9a8d6a44fb1c2dc216dfa29fe8ae34b433c87c51e6b75823cc54
-  data.tar.gz: df9786fdd0806100f5ad19cc3df593e54a909056d9353cf8df23ac9b25d3b705
+  metadata.gz: cfd271bbab63e86184e5ac653608e8a548f988e626fae9d757bac28a4ae3bb46
+  data.tar.gz: 1707855b60cad9fe8f6125915ccea1249671f4ca495b356dc7fc2dca205319e6
 SHA512:
-  metadata.gz: 512407d5a3b0a67f5d75899d57a8887181b3fd909bf4973ae0f531309032de12d2dd5d046f3c5cfcd7f54b94f80e121d015ed3c5bd5bd42143f6555905cf0fb0
-  data.tar.gz: 3ad4c4111f5f49372857509d3a3a8d838b2bb6b92776c9633983a84bd1b037c2a6d78a53a85f070ab8d00cb5485d2361d024d509f36fd8e99415f995d1fa85c5
+  metadata.gz: 470403a065245ee9f318b539e6863fecc02fa9e2b2c4aae52ffc64f16c349cdd8027a7b2049e0a1db01ee63644f09a4209cbaa46a17b9c246ed2c038df81bae1
+  data.tar.gz: 74b29ec550bbe45c5b1868f0555e16fb7cbe72ec39eb14570f9a5866b4513f1b0a8a23a5c6aa683e390b8b68479e743291bf2c9bfa1f6a158e6a1cb8dcb40d14

data/lib/ipagos_ruby_sdk/client.rb

@@ -0,0 +1,181 @@
+# frozen_string_literal: true
+
+require "faraday"
+require "json"
+require "base64"
+require "openssl"
+require "time"
+require "uri"
+
+module IpagosRubySdk
+  class Client
+    SANDBOX_URL = "https://apitest.cybersource.com"
+    PRODUCTION_URL = "https://api.cybersource.com"
+
+    attr_reader :config
+
+    def initialize(config)
+      @config = config
+      @base_url = config.environment == :production ? PRODUCTION_URL : SANDBOX_URL
+      
+      @conn = Faraday.new(url: @base_url) do |f|
+        f.headers["Content-Type"] = "application/json"
+        f.headers["v-c-merchant-id"] = config.merchant_id
+        f.adapter Faraday.default_adapter
+      end
+    end
+
+    def create_session(origin)
+      path = "/microform/v2/sessions"
+      payload = {
+        targetOrigins: [origin.chomp("/")],
+        allowedCardNetworks: ["VISA", "MASTERCARD", "AMEX"],
+        allowedPaymentTypes: ["CARD"],
+        clientVersion: "v2"
+      }
+      send_request(:post, path, payload)
+    end
+
+    def create_payment(amount:, bill_to:, token: nil, card_data: nil, reference: nil, line_items: nil)
+      path = "/pts/v2/payments"
+      
+      items = if line_items.nil? || line_items.empty?
+                [{
+                  unitPrice: amount.total,
+                  quantity: 1,
+                  productName: "Servicio General",
+                  productSku: "GEN-001"
+                }]
+              else
+                line_items.map(&:to_h)
+              end
+
+      payload = {
+        clientReferenceInformation: { code: reference || "ORD-#{Time.now.to_i}" },
+        processingInformation: { capture: true },
+        orderInformation: {
+          amountDetails: amount.to_h,
+          billTo: bill_to.to_h,
+          lineItems: items
+        }
+      }
+
+      if token
+        payload[:tokenInformation] = { transientTokenJwt: token }
+      elsif card_data
+        payload[:paymentInformation] = {
+          card: {
+            number: card_data[:number],
+            expirationMonth: card_data[:expiration_month],
+            expirationYear: card_data[:expiration_year],
+            cvv: card_data[:cvv]
+          }
+        }
+      else
+        raise ArgumentError, "Se requiere un 'token' o 'card_data' para procesar el pago"
+      end
+
+      send_request(:post, path, payload)
+    end
+
+    def void_payment(id)
+      path = "/pts/v2/payments/#{id}/voids"
+      payload = { clientReferenceInformation: { code: "void_#{Time.now.to_i}" } }
+      send_request(:post, path, payload)
+    end
+
+    # Reembolsar un pago (Refund) - Versión Corregida para CyberSource
+    def refund_payment(id, amount)
+      path = "/pts/v2/payments/#{id}/refunds"
+      
+      payload = {
+        clientReferenceInformation: { code: "refund_#{Time.now.to_i}" },
+        orderInformation: {
+          amountDetails: {
+            totalAmount: amount.total,
+            currency: amount.currency
+          }
+        }
+      }
+      send_request(:post, path, payload)
+    end
+
+    def get_payment(id)
+      send_request(:get, "/pts/v2/payments/#{id}")
+    end
+
+    def get_payment_status(id)
+      get_payment(id)
+    end
+
+    private
+
+    def send_request(method, path, payload = nil)
+      headers = generate_auth_headers(method, path, payload)
+      body = (payload && method != :get) ? payload.to_json : nil
+      response = @conn.run_request(method, path, body, headers)
+      handle_response(response)
+    rescue JSON::ParserError
+      ::IpagosRubySdk::Response.error("Respuesta de API inválida (JSON Malformed)", 500)
+    rescue StandardError => e
+      ::IpagosRubySdk::Response.new(success: false, error_message: "Excepción de Red: #{e.message}", status_code: 500)
+    end
+
+    def generate_auth_headers(method, path, payload)
+      date = Time.now.httpdate
+      digest = ""
+
+      if payload && method != :get
+        json_body = payload.to_json
+        hash = OpenSSL::Digest::SHA256.digest(json_body)
+        digest = "SHA-256=#{Base64.strict_encode64(hash)}"
+      end
+
+      signature_headers = [
+        "(request-target): #{method.to_s.downcase} #{path}",
+        "host: #{URI.parse(@base_url).host}",
+        "date: #{date}"
+      ]
+      signature_headers << "digest: #{digest}" unless digest.empty?
+      signature_headers << "v-c-merchant-id: #{@config.merchant_id}"
+
+      sig_string = signature_headers.join("\n")
+      decoded_secret = Base64.decode64(@config.secret_key)
+      hmac = OpenSSL::HMAC.digest("sha256", decoded_secret, sig_string)
+      
+      header_list = "(request-target) host date#{' digest' unless digest.empty?} v-c-merchant-id"
+      
+      headers = {
+        "Date" => date,
+        "Signature" => "keyid=\"#{@config.key_id}\", algorithm=\"HmacSHA256\", headers=\"#{header_list}\", signature=\"#{Base64.strict_encode64(hmac)}\"",
+        "v-c-merchant-id" => @config.merchant_id
+      }
+      headers["Digest"] = digest unless digest.empty?
+      headers
+    end
+
+    def handle_response(response)
+      success = response.status.between?(200, 299)
+      raw_body = response.body.to_s.strip
+      
+      data = begin
+        if raw_body.start_with?("{", "[")
+          JSON.parse(raw_body)
+        elsif raw_body.start_with?("eyJ")
+          { "token" => raw_body }
+        else
+          { "raw_response" => raw_body }
+        end
+      rescue JSON::ParserError
+        { "raw_response" => raw_body }
+      end
+
+      ::IpagosRubySdk::Response.new(
+        success: success,
+        data: data,
+        error_message: success ? nil : "Error #{response.status}: #{data['message'] || 'Respuesta inválida'}",
+        status_code: response.status
+      )
+    end
+  end
+end

data/lib/ipagos_ruby_sdk/environment.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+module IpagosRubySdk
+  module Environment
+    SANDBOX = :sandbox
+    PRODUCTION = :production
+  end
+end

data/lib/ipagos_ruby_sdk/models/amount_details.rb

@@ -0,0 +1,5 @@
+module IpagosRubySdk
+  class AmountDetails < BaseModel
+    attr_accessor :total, :currency
+  end
+end

data/lib/ipagos_ruby_sdk/models/base_model.rb

@@ -0,0 +1,24 @@
+
+# frozen_string_literal: true
+
+module IpagosRubySdk
+  class BaseModel
+    def initialize(attributes = {})
+      attributes.each do |key, value|
+        send("#{key}=", value) if respond_to?("#{key}=")
+      end
+    end
+
+    # Este método equivale a tu toArray() de PHP
+    def to_h
+      instance_variables.each_with_object({}) do |var, hash|
+        value = instance_variable_get(var)
+        # Limpiamos el '@' del nombre de la variable
+        key = var.to_s.delete("@")
+        
+        # Si el valor es otro modelo, lo convertimos recursivamente
+        hash[key] = value.respond_to?(:to_h) ? value.to_h : value
+      end
+    end
+  end
+end

data/lib/ipagos_ruby_sdk/models/bill_to.rb

@@ -0,0 +1,7 @@
+module IpagosRubySdk
+  class BillTo < BaseModel
+    attr_accessor :first_name, :last_name, :address1, :address2, 
+                  :locality, :administrative_area, :postal_code, 
+                  :country, :district, :email, :phone_number
+  end
+end

data/lib/ipagos_ruby_sdk/models/line_item.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module IpagosRubySdk
+  class LineItem < BaseModel
+    attr_accessor :unit_price, :quantity, :product_name, :product_sku
+
+    def to_h
+      {
+        unitPrice: unit_price,
+        quantity: quantity,
+        productName: product_name,
+        productSku: product_sku
+      }.compact
+    end
+  end
+end

data/lib/ipagos_ruby_sdk/types.rb

@@ -0,0 +1,55 @@
+# frozen_string_literal: true
+
+module IpagosRubySdk
+  # Configuración (Equivale a IpagosConfig.php)
+  # Usamos una estructura con bloque para incluir la validación de presencia
+  Configuration = Struct.new(
+    :environment,
+    :merchant_id,
+    :key_id,
+    :secret_key,
+    keyword_init: true
+  ) do
+    def initialize(*)
+      super
+      raise ArgumentError, "merchant_id es requerido" if merchant_id.nil?
+      raise ArgumentError, "key_id es requerido" if key_id.nil?
+      raise ArgumentError, "secret_key es requerido" if secret_key.nil?
+    end
+  end
+
+  # Respuesta (Equivale a IpagosResponse.php)
+  class Response
+    attr_reader :success, :data, :error_message, :status_code
+
+    def initialize(success:, data: nil, error_message: nil, status_code: 200)
+      @success = success
+      @data = data
+      @error_message = error_message
+      @status_code = status_code
+      # Hacemos el objeto inmutable
+      freeze
+    end
+
+    def success?
+      @success
+    end
+
+    # Obtiene valores del payload soportando Strings o Símbolos
+    def get(key, default = nil)
+      return default unless @data.is_a?(Hash)
+      
+      @data[key.to_s] || @data[key.to_sym] || default
+    end
+
+    # Factory para respuestas exitosas
+    def self.success(data = nil, status_code = 200)
+      new(success: true, data: data, status_code: status_code)
+    end
+
+    # Factory para respuestas de error
+    def self.error(message, status_code = 400)
+      new(success: false, error_message: message, status_code: status_code)
+    end
+  end
+end

data/lib/ipagos_ruby_sdk/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module IpagosRubySdk
-  VERSION = "0.1.0"
+  VERSION = "0.1.1"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: ipagos_ruby_sdk
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.1.1
 platform: ruby
 authors:
 - Integraciones iPagos
@@ -81,6 +81,13 @@ files:
 - README.md
 - Rakefile
 - lib/ipagos_ruby_sdk.rb
+- lib/ipagos_ruby_sdk/client.rb
+- lib/ipagos_ruby_sdk/environment.rb
+- lib/ipagos_ruby_sdk/models/amount_details.rb
+- lib/ipagos_ruby_sdk/models/base_model.rb
+- lib/ipagos_ruby_sdk/models/bill_to.rb
+- lib/ipagos_ruby_sdk/models/line_item.rb
+- lib/ipagos_ruby_sdk/types.rb
 - lib/ipagos_ruby_sdk/version.rb
 - sig/ipagos_ruby_sdk.rbs
 homepage: https://gitlab.com/ipagos/ipagos-ruby-sdk