dpay 0.1.0

data/lib/dpay/payment/transaction_status.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module DPay
+  module TransactionStatus
+    PAID = "paid"
+    CREATED = "created"
+    PROCESSING = "processing"
+    EXPIRED = "expired"
+    CAPTURED = "captured"
+
+    ALL = [PAID, CREATED, PROCESSING, EXPIRED, CAPTURED].freeze
+
+    def self.valid?(value)
+      ALL.include?(value)
+    end
+
+    def self.assert_valid(value)
+      raise InvalidArgumentError, %(Invalid transaction status "#{value}") unless valid?(value)
+    end
+  end
+end

data/lib/dpay/payment/transaction_type.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+module DPay
+  module TransactionType
+    TRANSFERS = "transfers"
+    DCB_GATEWAY = "dcb_gateway"
+    CARD_AUTH = "card_auth"
+    MB_WAY_DIRECT = "mb_way_direct"
+    BIZUM_DIRECT = "bizum_direct"
+    BLIK_RECURRING = "blik_recurring"
+    CARD_RECURRING = "card_recurring"
+
+    ALL = [TRANSFERS, DCB_GATEWAY, CARD_AUTH, MB_WAY_DIRECT, BIZUM_DIRECT, BLIK_RECURRING, CARD_RECURRING].freeze
+
+    def self.valid?(value)
+      ALL.include?(value)
+    end
+
+    def self.assert_valid(value)
+      raise InvalidArgumentError, %(Invalid transaction type "#{value}") unless valid?(value)
+    end
+  end
+end

data/lib/dpay/payout/payout_details.rb

@@ -0,0 +1,50 @@
+# frozen_string_literal: true
+
+module DPay
+  class PayoutDetails
+    attr_reader :id, :state, :net, :fee, :gross, :creation_date, :nrb, :decline_reason, :decline_status,
+                :receiver, :raw
+
+    def self.from_api(data)
+      new(data)
+    end
+
+    def initialize(data)
+      @raw = data
+      @id = Internal::Coerce.integer(data["id"])
+      @state = Internal::Coerce.optional_integer(data["state"])
+      @net = Internal::Coerce.money(data["net"])
+      @fee = Internal::Coerce.money(data["fee"])
+      @gross = Internal::Coerce.money(data["gross"])
+      @creation_date = data["creation_date"].is_a?(String) ? data["creation_date"] : nil
+      @direct_settlement = Internal::Coerce.integer(data["direct_settlement"]) == 1
+      @nrb = data["nrb"].is_a?(String) ? data["nrb"] : nil
+      @declined = Internal::Coerce.integer(data["declined"]) == 1
+      @decline_reason = data["decline_reason"].is_a?(String) ? data["decline_reason"] : nil
+      @decline_status = data["decline_status"].is_a?(String) ? data["decline_status"] : nil
+      @receiver = data["receiver"].is_a?(Hash) ? PayoutReceiver.from_api(data["receiver"]) : nil
+      freeze
+    end
+
+    def waiting?
+      state = @state
+      !state.nil? && state.zero?
+    end
+
+    def processed?
+      @state == 1
+    end
+
+    def failed?
+      @state == -1
+    end
+
+    def direct_settlement?
+      @direct_settlement
+    end
+
+    def declined?
+      @declined
+    end
+  end
+end

data/lib/dpay/payout/payout_receiver.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+module DPay
+  class PayoutReceiver
+    attr_reader :nrb, :title, :amount, :service, :receiver_name, :receiver_address, :raw
+
+    def self.from_api(data)
+      new(data)
+    end
+
+    def initialize(data)
+      @raw = data
+      @nrb = data["nrb"].is_a?(String) ? data["nrb"] : nil
+      @title = data["title"].is_a?(String) ? data["title"] : nil
+      @amount = Money.try_from_api_number(data["amount"], Currency::PLN)
+      @service = data["service"].is_a?(String) ? data["service"] : nil
+      @receiver_name = data["receiverName"].is_a?(String) ? data["receiverName"] : nil
+      @receiver_address = data["receiverAddress"].is_a?(String) ? data["receiverAddress"] : nil
+      freeze
+    end
+  end
+end

data/lib/dpay/payout/payout_service.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+module DPay
+  class PayoutService
+    def initialize(api)
+      @api = api
+    end
+
+    def details(withdraw_id, timestamp = nil)
+      body = { "service" => @api.service }
+      body["timestamp"] = timestamp unless timestamp.nil?
+      body["withdraw_id"] = withdraw_id
+      body["checksum"] = @api.checksum.ordered_body(body.values)
+
+      data = @api.post_json(Internal::BaseUrls::PANEL, "/api/v1/pbl/withdraws/details", body)
+      unless data.is_a?(Hash) && Internal::Coerce.integer(data["id"]).positive?
+        raise ApiServerError.new("API response carries no payout details", 200, nil, {}, Internal::PHP.json_encode(data))
+      end
+
+      PayoutDetails.from_api(data)
+    end
+  end
+end

data/lib/dpay/refund/refund.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+module DPay
+  class Refund
+    attr_reader :message, :raw
+
+    def self.from_api(data)
+      new(data)
+    end
+
+    def initialize(data)
+      @raw = data
+      @accepted = data["status"] == "success" && data["refund"] == true
+      @message = Internal::Coerce.string(data["message"])
+      freeze
+    end
+
+    def accepted?
+      @accepted
+    end
+  end
+end

data/lib/dpay/refund/refund_availability.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+module DPay
+  class RefundAvailability
+    attr_reader :message, :http_status, :raw
+
+    def self.from_api(data, http_status = nil)
+      new(data, http_status)
+    end
+
+    def initialize(data, http_status = nil)
+      @raw = data
+      @available = data["refund"] == true
+      @message = Internal::Coerce.string(data["message"])
+      @http_status = http_status
+      freeze
+    end
+
+    def available?
+      @available
+    end
+  end
+end

data/lib/dpay/refund/refund_service.rb

@@ -0,0 +1,46 @@
+# frozen_string_literal: true
+
+module DPay
+  class RefundService
+    AVAILABILITY_STATUSES = [200, 400, 402, 406, 409, 410, 411].freeze
+
+    def initialize(api)
+      @api = api
+    end
+
+    def create(transaction_id, amount = nil, reason = nil)
+      body = signed_body(transaction_id, amount, reason)
+
+      Refund.from_api(@api.post_json(Internal::BaseUrls::PANEL, "/api/v1/pbl/refund", body))
+    end
+
+    def check_availability(transaction_id, amount = nil, reason = nil)
+      body = signed_body(transaction_id, amount, reason)
+      response = @api.send_raw("POST", Internal::BaseUrls::PANEL, "/api/v1/pbl/check-refund-availability", body)
+      data = response.decode_json
+
+      if data.is_a?(Hash) && data.key?("refund") && availability_outcome?(response.status, data)
+        return RefundAvailability.from_api(data, response.status)
+      end
+
+      raise @api.map_error(response)
+    end
+
+    private
+
+    def availability_outcome?(status, data)
+      return true if AVAILABILITY_STATUSES.include?(status)
+
+      status == 401 && data["message"] != "Unauthorized request"
+    end
+
+    def signed_body(transaction_id, amount, reason)
+      body = { "service" => @api.service, "transaction_id" => transaction_id }
+      body["value"] = amount.to_decimal unless amount.nil?
+      body["reason"] = reason unless reason.nil?
+      body["checksum"] = @api.checksum.ordered_body(body.values)
+
+      body
+    end
+  end
+end

data/lib/dpay/testing/mock_http_client.rb

@@ -0,0 +1,51 @@
+# frozen_string_literal: true
+
+require "json"
+
+module DPay
+  module Testing
+    class MockHttpClient < HTTP::Client
+      attr_reader :queued, :requests
+
+      def initialize
+        super
+        @queued = []
+        @requests = []
+      end
+
+      def queue(response)
+        @queued << response
+        self
+      end
+
+      def queue_json(status, body, headers = {})
+        queue(HTTP::Response.new(status, { "content-type" => "application/json" }.merge(headers),
+                                 Internal::PHP.json_encode(body)))
+      end
+
+      def queue_text(status, body, headers = {})
+        queue(HTTP::Response.new(status, headers, body))
+      end
+
+      def request(api_request)
+        @requests << api_request
+        raise "MockHttpClient queue is empty" if @queued.empty?
+
+        @queued.shift
+      end
+
+      def last_request
+        raise "MockHttpClient recorded no requests" if @requests.empty?
+
+        @requests.last
+      end
+
+      def last_request_body
+        body = last_request.body
+        raise "MockHttpClient last request has no body" if body.nil?
+
+        JSON.parse(body)
+      end
+    end
+  end
+end

data/lib/dpay/testing.rb

@@ -0,0 +1,4 @@
+# frozen_string_literal: true
+
+require_relative "../dpay"
+require_relative "testing/mock_http_client"

data/lib/dpay/version.rb

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

data/lib/dpay.rb

@@ -0,0 +1,68 @@
+# frozen_string_literal: true
+
+require_relative "dpay/version"
+require_relative "dpay/internal/php"
+require_relative "dpay/internal/coerce"
+require_relative "dpay/internal/checksum_calculator"
+require_relative "dpay/errors"
+require_relative "dpay/http/request"
+require_relative "dpay/http/response"
+require_relative "dpay/http/client"
+require_relative "dpay/http/net_http_client"
+require_relative "dpay/internal/base_urls"
+require_relative "dpay/internal/error_mapper"
+require_relative "dpay/internal/api_requestor"
+require_relative "dpay/config"
+require_relative "dpay/currency"
+require_relative "dpay/money"
+require_relative "dpay/payment/transaction_type"
+require_relative "dpay/payment/transaction_status"
+require_relative "dpay/payment/payout_fee_mode"
+require_relative "dpay/card/redirect_type"
+require_relative "dpay/card/dcc_decision"
+require_relative "dpay/card/card_recurring_operation"
+require_relative "dpay/card/card_recurring_frequency"
+require_relative "dpay/card/card_data"
+require_relative "dpay/card/card_encryptor"
+require_relative "dpay/card/card_recurring_registration"
+require_relative "dpay/card/card_payment_request"
+require_relative "dpay/card/google_pay_request"
+require_relative "dpay/card/apple_pay_request"
+require_relative "dpay/card/dcc_markup"
+require_relative "dpay/card/dcc_offer"
+require_relative "dpay/card/card_payment_result"
+require_relative "dpay/card/card_service"
+require_relative "dpay/blik/blik_alias_type"
+require_relative "dpay/blik/blik_app"
+require_relative "dpay/blik/blik_alias"
+require_relative "dpay/blik/blik_recurring_registration_info"
+require_relative "dpay/blik/blik_recurring_status"
+require_relative "dpay/blik/blik_alias_registration"
+require_relative "dpay/blik/blik_recurring_registration"
+require_relative "dpay/blik/blik_service"
+require_relative "dpay/ipn/ipn_type"
+require_relative "dpay/ipn/ipn_event"
+require_relative "dpay/ipn/ipn_verifier"
+require_relative "dpay/payment/return_urls"
+require_relative "dpay/payment/payer"
+require_relative "dpay/payment/device_info"
+require_relative "dpay/payment/invoice_details"
+require_relative "dpay/payment/payout_position"
+require_relative "dpay/payment/payout_instruction"
+require_relative "dpay/payment/register_payment_request"
+require_relative "dpay/payment/registered_payment"
+require_relative "dpay/payment/transaction_refund"
+require_relative "dpay/payment/transaction"
+require_relative "dpay/payment/payment_service"
+require_relative "dpay/refund/refund"
+require_relative "dpay/refund/refund_availability"
+require_relative "dpay/refund/refund_service"
+require_relative "dpay/bank/bank"
+require_relative "dpay/bank/bank_service"
+require_relative "dpay/payout/payout_receiver"
+require_relative "dpay/payout/payout_details"
+require_relative "dpay/payout/payout_service"
+require_relative "dpay/client"
+
+module DPay
+end

data/sig/dpay/bank/bank.rbs

@@ -0,0 +1,17 @@
+module DPay
+  class Bank
+    attr_reader id: String
+    attr_reader name: String
+    attr_reader image: String?
+    attr_reader on_from: Integer
+    attr_reader on_to: Integer
+    attr_reader iterator: Integer?
+    attr_reader type: String?
+    attr_reader raw: Hash[String, untyped]
+
+    def self.from_api: (Hash[String, untyped] data) -> Bank
+
+    def initialize: (Hash[String, untyped] data) -> void
+    def test?: () -> bool
+  end
+end

data/sig/dpay/bank/bank_service.rbs

@@ -0,0 +1,13 @@
+module DPay
+  class BankService
+    PATH: String
+
+    def initialize: (Internal::ApiRequestor api) -> void
+    def all: () -> Array[Bank]
+    def for_service: (?Integer? timestamp) -> Array[Bank]
+
+    private
+
+    def map_banks: (untyped data) -> Array[Bank]
+  end
+end

data/sig/dpay/blik/blik_alias.rbs

@@ -0,0 +1,17 @@
+module DPay
+  class BlikAlias
+    ACTIVE: String
+
+    attr_reader alias_value: String
+    attr_reader alias_type: String
+    attr_reader status: String?
+    attr_reader expiration_date: String?
+    attr_reader apps: Array[BlikApp]
+    attr_reader raw: Hash[String, untyped]
+
+    def self.from_api: (Hash[String, untyped] data) -> BlikAlias
+
+    def initialize: (Hash[String, untyped] data) -> void
+    def active?: () -> bool
+  end
+end

data/sig/dpay/blik/blik_alias_registration.rbs

@@ -0,0 +1,6 @@
+module DPay
+  class BlikAliasRegistration
+    def initialize: (String label, ?String type) -> void
+    def to_h: () -> Hash[String, untyped]
+  end
+end

data/sig/dpay/blik/blik_alias_type.rbs

@@ -0,0 +1,11 @@
+module DPay
+  module BlikAliasType
+    UID: String
+    PAYID: String
+
+    ALL: Array[String]
+
+    def self.valid?: (untyped value) -> bool
+    def self.assert_valid: (untyped value) -> void
+  end
+end

data/sig/dpay/blik/blik_app.rbs

@@ -0,0 +1,10 @@
+module DPay
+  class BlikApp
+    attr_reader key: String?
+    attr_reader label: String?
+
+    def self.from_api: (Hash[String, untyped] data) -> BlikApp
+
+    def initialize: (Hash[String, untyped] data) -> void
+  end
+end

data/sig/dpay/blik/blik_recurring_registration.rbs

@@ -0,0 +1,24 @@
+module DPay
+  class BlikRecurringRegistration
+    MODELS: Array[String]
+    FREQUENCY: Regexp
+    DATE: Regexp
+
+    @optional: Hash[String, untyped]
+
+    def self.create: (String label, String model, String frequency) -> BlikRecurringRegistration
+
+    def initialize: (String label, String model, String frequency) -> void
+    def with_value: (Money value) -> self
+    def with_limit_amt: (Integer limit_amt) -> self
+    def with_tot_limit_amt: (Integer tot_limit_amt) -> self
+    def with_limit_amt_fixed: (bool fixed) -> self
+    def with_expiration_date: (String expiration_date) -> self
+    def with_init_date: (String init_date) -> self
+    def to_h: () -> Hash[String, untyped]
+
+    private
+
+    def assert_date: (untyped date) -> String
+  end
+end

data/sig/dpay/blik/blik_recurring_registration_info.rbs

@@ -0,0 +1,17 @@
+module DPay
+  class BlikRecurringRegistrationInfo
+    attr_reader model: String?
+    attr_reader frequency: String?
+    attr_reader limit_amt: Integer?
+    attr_reader tot_limit_amt: Integer?
+    attr_reader limit_amt_fixed: bool?
+    attr_reader init_date: String?
+    attr_reader label: String?
+    attr_reader registered_at: String?
+    attr_reader raw: Hash[String, untyped]
+
+    def self.from_api: (Hash[String, untyped] data) -> BlikRecurringRegistrationInfo
+
+    def initialize: (Hash[String, untyped] data) -> void
+  end
+end

data/sig/dpay/blik/blik_recurring_status.rbs

@@ -0,0 +1,17 @@
+module DPay
+  class BlikRecurringStatus
+    ACTIVE: String
+
+    attr_reader alias_value: String
+    attr_reader alias_type: String
+    attr_reader status: String?
+    attr_reader expiration_date: String?
+    attr_reader registration: BlikRecurringRegistrationInfo?
+    attr_reader raw: Hash[String, untyped]
+
+    def self.from_api: (Hash[String, untyped] data) -> BlikRecurringStatus
+
+    def initialize: (Hash[String, untyped] data) -> void
+    def active?: () -> bool
+  end
+end

data/sig/dpay/blik/blik_service.rbs

@@ -0,0 +1,13 @@
+module DPay
+  class BlikService
+    def initialize: (Internal::ApiRequestor api) -> void
+    def alias: (String alias_value, ?String alias_type) -> BlikAlias
+    def unregister_alias: (String alias_value, ?String alias_type, ?String? reason) -> nil
+    def recurring_status: (String alias_value) -> BlikRecurringStatus
+
+    private
+
+    def alias_body: (String alias_value, String alias_type, ?String? reason) -> Hash[String, untyped]
+    def payload: (Hash[String, untyped] data) -> Hash[String, untyped]
+  end
+end

data/sig/dpay/card/apple_pay_request.rbs

@@ -0,0 +1,13 @@
+module DPay
+  class ApplePayRequest
+    INIT: String
+    PAY: String
+
+    def self.init: (DeviceInfo device_info) -> ApplePayRequest
+    def self.pay: (String token, DeviceInfo device_info) -> ApplePayRequest
+
+    def initialize: (String x_pay_type, String? token, DeviceInfo device_info) -> void
+    def with_channel_id: (Integer channel_id) -> self
+    def to_body: () -> Hash[String, untyped]
+  end
+end

data/sig/dpay/card/card_data.rbs

@@ -0,0 +1,15 @@
+module DPay
+  class CardData
+    PAN: Regexp
+    CVV: Regexp
+    EXPIRY: Regexp
+
+    attr_reader pan: String
+    attr_reader cvv: String
+    attr_reader expiry: String
+
+    def initialize: (String pan, String cvv, String expiry) -> void
+    def inspect: () -> String
+    def to_s: () -> String
+  end
+end

data/sig/dpay/card/card_encryptor.rbs

@@ -0,0 +1,9 @@
+module DPay
+  class CardEncryptor
+    def encrypt: (CardData card, String transaction_id, String public_key_pem, ?timestamp: Integer) -> String
+
+    private
+
+    def load_key: (String public_key_pem) -> OpenSSL::PKey::RSA
+  end
+end

data/sig/dpay/card/card_payment_request.rbs

@@ -0,0 +1,17 @@
+module DPay
+  class CardPaymentRequest
+    @leading: Hash[String, untyped]
+    @trailing: Hash[String, untyped]
+
+    def self.create: (DeviceInfo device_info) -> CardPaymentRequest
+
+    def initialize: (DeviceInfo device_info) -> void
+    def with_email: (String email) -> self
+    def with_channel_id: (Integer channel_id) -> self
+    def with_card_holder: (String first_name, String last_name) -> self
+    def with_encrypted_card_data: (String encrypted_card_data) -> self
+    def with_three_ds_confirmed: (bool confirmed) -> self
+    def with_dcc_decision: (String decision) -> self
+    def to_body: () -> Hash[String, untyped]
+  end
+end

data/sig/dpay/card/card_payment_result.rbs

@@ -0,0 +1,22 @@
+module DPay
+  class CardPaymentResult
+    attr_reader redirect_type: String?
+    attr_reader redirect_text: String?
+    attr_reader dcc_offer: DccOffer?
+    attr_reader raw: Hash[String, untyped]
+
+    def self.from_api: (Hash[String, untyped] data) -> CardPaymentResult
+
+    def initialize: (Hash[String, untyped] data) -> void
+    def success?: () -> bool
+    def three_ds_form?: () -> bool
+    def requires_redirect?: () -> bool
+    def dcc_offer?: () -> bool
+    def three_ds_form_html: () -> String?
+    def redirect_url: () -> String?
+
+    private
+
+    def decode: () -> String?
+  end
+end

data/sig/dpay/card/card_recurring_frequency.rbs

@@ -0,0 +1,16 @@
+module DPay
+  module CardRecurringFrequency
+    DAILY: String
+    WEEKLY: String
+    BIWEEKLY: String
+    MONTHLY: String
+    QUARTERLY: String
+    SEMIANNUAL: String
+    ANNUAL: String
+
+    ALL: Array[String]
+
+    def self.valid?: (untyped value) -> bool
+    def self.assert_valid: (untyped value) -> void
+  end
+end

data/sig/dpay/card/card_recurring_operation.rbs

@@ -0,0 +1,12 @@
+module DPay
+  module CardRecurringOperation
+    ADD_CARD: String
+    COF_INITIAL: String
+    CHARGE: String
+
+    ALL: Array[String]
+
+    def self.valid?: (untyped value) -> bool
+    def self.assert_valid: (untyped value) -> void
+  end
+end

data/sig/dpay/card/card_recurring_registration.rbs

@@ -0,0 +1,22 @@
+module DPay
+  class CardRecurringRegistration
+    DATE: Regexp
+
+    @optional: Hash[String, untyped]
+
+    def self.create: (String label) -> CardRecurringRegistration
+
+    def initialize: (String label) -> void
+    def with_frequency: (String frequency) -> self
+    def with_limit_amt: (Money limit_amt) -> self
+    def with_tot_limit_amt: (Money tot_limit_amt) -> self
+    def with_limit_amt_fixed: (bool fixed) -> self
+    def with_expiration_date: (String expiration_date) -> self
+    def with_init_date: (String init_date) -> self
+    def to_h: () -> Hash[String, untyped]
+
+    private
+
+    def assert_date: (untyped date) -> String
+  end
+end