yookassa 0.1.0 → 0.2.0

data/lib/yookassa/entity/card.rb

@@ -1,18 +1,45 @@
 # frozen_string_literal: true
 
+require_relative "./types"
+
 module Yookassa
   module Entity
-    class Card
-      extend  Dry::Initializer
-      extend  Yookassa::Callable
-      include Yookassa::Optional
-
-      option :first6
-      option :last4
-      option :expiry_month
-      option :expiry_year
-      option :card_type, proc(&:to_s)
-      option :source, proc(&:to_s), optional: true
+    class Card < Dry::Struct
+      # first6 [string, optional]
+      # First 6 digits of the card’s number (BIN). For payments with bank cards saved in YooMoney
+      # and other services, the specified BIN might not correspond with the last4, expiry_year, expiry_month values.
+      # For payments with bank cards saved in Apple Pay or Google Pay, the parameter contains Device Account Number.
+      attribute? :first6, Types::String
+
+      # last4 [string, required]
+      # Last 4 digits of the card's number.
+      attribute :last4, Types::String
+
+      # expiry_month [string, required]
+      # Expiration date, month, MM.
+      attribute :expiry_month, Types::Coercible::Integer
+
+      # expiry_year [string, required]
+      # Expiration date, year, YYYY.
+      attribute :expiry_year, Types::Coercible::Integer
+
+      # card_type [string, required]
+      # Type of bank card. Possible values: MasterCard (for Mastercard and Maestro cards), Visa (for Visa and Visa Electron cards),
+      # Mir, UnionPay, JCB, AmericanExpress, DinersClub, and Unknown.
+      attribute :card_type, Types::String.enum("MasterCard", "Visa", "Mir", "UnionPay", "JCB", "AmericanExpress", "DinersClub", "Unknown")
+
+      # issuer_country [string, optional]
+      # Code of the country where the bank card was issued according to ISO-3166 alpha-2. Example: RU.
+      attribute? :issuer_country, Types::String
+
+      # issuer_name [string, optional]
+      # Name of the issuing bank.
+      attribute? :issuer_name, Types::String
+
+      # source [string, optional]
+      # Source of bank card details. Possible values: apple_pay, google_pay.
+      # For payments where the user selects a card saved in Apple Pay or Google Pay.
+      attribute? :source, Types::String.enum("apple_pay", "google_pay")
     end
   end
 end

data/lib/yookassa/entity/confirmation.rb

@@ -1,16 +1,14 @@
 # frozen_string_literal: true
 
+require_relative "./types"
+
 module Yookassa
   module Entity
-    class Confirmation
-      extend  Dry::Initializer
-      extend  Yookassa::Callable
-      include Yookassa::Optional
-
-      option :type, proc(&:to_s), optional: true
-      option :confirmation_url, proc(&:to_s), optional: true
-      option :enforce, optional: true
-      option :return_url, proc(&:to_s), optional: true
+    class Confirmation < Dry::Struct
+      attribute :type, Types::String
+      attribute :confirmation_url, Types::String
+      attribute? :enforce, Types::Bool
+      attribute? :return_url, Types::String
     end
   end
 end

data/lib/yookassa/entity/error.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+require_relative "./types"
+
+module Yookassa
+  module Entity
+    class Error < Dry::Struct
+      attribute :type, Types::String
+      attribute? :id, Types::String
+      attribute? :code, Types::String
+      attribute? :description, Types::String
+      attribute? :parameter, Types::String
+
+      def error?
+        type == "error"
+      end
+    end
+  end
+end

data/lib/yookassa/entity/payment.rb

@@ -1,22 +1,118 @@
 # frozen_string_literal: true
 
-require_relative './amount'
-require_relative './payment_method'
-require_relative './confirmation'
+require_relative "./types"
+require_relative "./amount"
+require_relative "./payment_methods"
+require_relative "./confirmation"
+require_relative "./recipient"
+require_relative "./cancellation_details"
+require_relative "./authorization_details"
+require_relative "./transfer"
 
 module Yookassa
   module Entity
-    class Payment < Yookassa::Response
-      option :paid
-      option :amount, Entity::Amount
-      option :created_at
-      option :captured_at, proc(&:to_s), optional: true
-      option :expires_at, optional: true
-      option :description, proc(&:to_s), optional: true
-      option :metadata, optional: true
-      option :payment_method, Entity::PaymentMethod, optional: true
-      option :confirmation, Entity::Confirmation, optional: true
-      option :test
+    class Payment < Dry::Struct
+      # id [string, required]
+      # Payment ID in YooMoney.
+      attribute :id, Types::String
+
+      attribute? :idempotency_key, Types::String
+
+      # status [string, required]
+      # Payment status. Possible values: pending, waiting_for_capture, succeeded, and canceled.
+      # More about the life cycle of a payment https://yookassa.ru/en/developers/api#:~:text=life%20cycle%20of%20a%20payment%C2%A0
+      attribute :status, Types::String.enum("pending", "waiting_for_capture", "succeeded", "canceled")
+
+      # amount [object, required]
+      # Payment amount. Sometimes YooMoney's partners charge additional commission from the users that is not included in this amount.
+      attribute :amount, Entity::Amount
+
+      # income_amount [object, optional]
+      # Amount of payment to be received by the store: the amount value minus the YooMoney commission.
+      # If you're a partner  using an OAuth token for request authentication, make a request to the store for a right
+      # to get information about commissions on payments.
+      attribute? :income_amount, Entity::Amount
+
+      # description [string, optional]
+      # Description of the transaction (maximum 128 characters) displayed in your YooMoney Merchant Profile,
+      # and shown to the user during checkout. For example, "Payment for order No. 72 for user@yoomoney.ru".
+      attribute? :description, Types::String.constrained(max_size: 128)
+
+      # recipient [object, required]
+      # Payment recipient.
+      attribute :recipient, Entity::Recipient
+
+      # payment_method [object, optional]
+      # Payment method  used for this payment.
+      attribute? :payment_method, Entity::PaymentMethods
+
+      # captured_at [datetime, optional]
+      # Time of payment capture, based on UTC and specified in the ISO 8601 format. "2018-07-18T10:51:18.139Z"
+      attribute? :captured_at, Types::JSON::DateTime
+
+      # created_at [datetime, required]
+      # Time of order creation, based on UTC and specified in the ISO 8601 format. Example: 2017-11-03T11:52:31.827Z
+      attribute :created_at, Types::JSON::DateTime
+
+      # expires_at [string, optional]
+      # The period during which you can cancel or capture a payment for free. The payment with the waiting_for_capture status
+      # will be automatically canceled at the specified time. Based on UTC and specified in the ISO 8601 format.
+      attribute? :expires_at, Types::JSON::DateTime
+
+      # confirmation [object, optional]
+      # Selected payment confirmation scenario. For payments requiring confirmation from the user.
+      # More about confirmation scenarios https://yookassa.ru/en/developers/api#:~:text=confirmation,from%20the%20user.%20More%20about%20confirmation%20scenarios%C2%A0
+      attribute? :confirmation, Entity::Confirmation
+
+      # test [boolean, required]
+      # The attribute of a test transaction.
+      attribute :test, Types::Bool
+
+      # refunded_amount [object, optional]
+      # The amount refunded to the user. Specified if the payment has successful refunds.
+      attribute? :refunded_amount, Entity::Amount
+
+      # paid [boolean, required]
+      # The attribute of a paid order.
+      attribute :paid, Types::Bool
+
+      # refundable [boolean, required]
+      # Availability of the option to make a refund via API.
+      attribute :refundable, Types::Bool
+
+      # receipt_registration [string, optional]
+      # Delivery status of receipt data to online sales register (pending, succeeded, or canceled). For those who use the solution for 54-FZ .
+      attribute? :receipt_registration, Types::String.enum("pending", "succeeded", "canceled")
+
+      # metadata [object, optional]
+      # Any additional data you might require for processing payments (for example, order number), specified as a “key-value” pair
+      # and returned in response from YooMoney.
+      # Limitations:
+      # - no more than 16 keys,
+      # - no more than 32 characters in the key’s title,
+      # - no more than 512 characters in the key’s value,
+      # - data type is a string in the UTF-8 format.
+      attribute? :metadata, Types::Hash
+
+      # cancellation_details [object, optional]
+      # Commentary to the canceled status: who and why canceled the payment.
+      # More about canceled payments https://yookassa.ru/en/developers/api#:~:text=cancellation_details,about%20canceled%20payments%C2%A0
+      attribute? :cancellation_details, Entity::CancellationDetails
+
+      # authorization_details [object, optional]
+      # Payment authorization details.
+      attribute? :authorization_details, Entity::AuthorizationDetails
+
+      # transfers [array, optional]
+      # Information about money distribution: the amounts of transfers and the stores to be transferred to.
+      # Specified if you use the YooMoney solution for marketplaces https://yookassa.ru/en/developers/special-solutions/checkout-for-platforms/basics
+      attribute? :transfers, Types::Array.of(Entity::Transfer)
+
+      # merchant_customer_id [string, optional]
+      # The identifier of the customer in your system, such as email address or phone number. No more than 200 characters.
+      # Specified if you want to save a bank card and offer it for a recurring payment
+      # in the YooMoney payment widget https://yookassa.ru/en/developers/payment-forms/widget/basics.
+      attribute? :merchant_customer_id, Types::String
     end
   end
 end

data/lib/yookassa/entity/payment_methods.rb

@@ -0,0 +1,107 @@
+# frozen_string_literal: true
+
+require_relative "./types"
+require_relative "./card"
+
+module Yookassa
+  module Entity
+    module PaymentMethod
+      class Base < Dry::Struct
+        # id [string, required]
+        # Payment method ID.
+        attribute :id, Types::String
+
+        # saved [boolean, required]
+        # Saving payment methods allows conducting automatic recurring payments .
+        attribute :saved, Types::Bool
+
+        # title [string, optional]
+        # Payment method name.
+        attribute? :title, Types::String
+      end
+
+      class BankCard < Base
+        attribute :type, Types.Value("bank_card")
+
+        # login [string, optional]
+        # User's login in Alfa-Click (linked phone number or the additional login).
+        attribute? :card, Entity::Card
+      end
+
+      class Alfabank < Base
+        attribute :type, Types.Value("alfabank")
+
+        # login [string, optional]
+        # User's login in Alfa-Click (linked phone number or the additional login).
+        attribute? :login, Types::String
+      end
+
+      class YooMoney < Base
+        attribute :type, Types.Value("yoo_money")
+
+        # account_number [string, optional]
+        # The number of the YooMoney wallet used for making the payment.
+        attribute? :account_number, Types::String
+      end
+
+      class Sberbank < Base
+        attribute :type, Types.Value("sberbank")
+
+        # phone [string, optional]
+        # TThe phone number specified during the registration process of the SberBank Online/SberPay account,
+        # specified in the ITU-T E.164 format, for example, 79000000000.
+        attribute? :phone, Types::String
+      end
+
+      class ApplePay < Base
+        attribute :type, Types.Value("apple_pay")
+      end
+
+      class Cash < Base
+        attribute :type, Types.Value("cash")
+      end
+
+      class DirectCarrierBilling < Base
+        attribute :type, Types.Value("mobile_balance")
+      end
+
+      class GooglePay < Base
+        attribute :type, Types.Value("google_pay")
+      end
+
+      class Installments < Base
+        attribute :type, Types.Value("installments")
+      end
+
+      class Qiwi < Base
+        attribute :type, Types.Value("qiwi")
+      end
+
+      class Tinkoff < Base
+        attribute :type, Types.Value("tinkoff_bank")
+      end
+
+      class Wechat < Base
+        attribute :type, Types.Value("wechat")
+      end
+
+      class Webmoney < Base
+        attribute :type, Types.Value("webmoney")
+      end
+    end
+
+    PaymentMethods =  PaymentMethod::BankCard |
+                      PaymentMethod::Alfabank |
+                      PaymentMethod::YooMoney |
+                      PaymentMethod::Sberbank |
+                      PaymentMethod::ApplePay |
+                      PaymentMethod::Cash |
+                      PaymentMethod::DirectCarrierBilling |
+                      PaymentMethod::GooglePay |
+                      PaymentMethod::Installments |
+                      PaymentMethod::Qiwi |
+                      PaymentMethod::Tinkoff |
+                      PaymentMethod::Wechat |
+                      PaymentMethod::Webmoney
+  end
+end

data/lib/yookassa/entity/recipient.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+require_relative "./types"
+
+module Yookassa
+  module Entity
+    class Recipient < Dry::Struct
+      attribute :account_id, Types::String
+      attribute :gateway_id, Types::String
+    end
+  end
+end

data/lib/yookassa/entity/refund.rb

@@ -1,15 +1,19 @@
 # frozen_string_literal: true
 
-require_relative './amount'
+require_relative "./types"
+require_relative "./amount"
 
 module Yookassa
   module Entity
-    class Refund < Yookassa::Response
-      option :payment_id
-      option :created_at, proc(&:to_s)
-      option :amount, Entity::Amount
-      option :receipt_registration, proc(&:to_s), optional: true
-      option :description, proc(&:to_s), optional: true
+    class Refund < Dry::Struct
+      attribute :id, Types::String
+      attribute? :idempotency_key, Types::String
+      attribute :status, Types::String
+      attribute :payment_id, Types::String
+      attribute :created_at, Types::String
+      attribute :amount, Entity::Amount
+      attribute? :receipt_registration, Types::String
+      attribute :description, Types::String
     end
   end
 end

data/lib/yookassa/entity/transfer.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+require_relative "./types"
+require_relative "./amount"
+
+module Yookassa
+  module Entity
+    class Transfer < Dry::Struct
+      # account_id [string, required]
+      # ID of the store in favor of which you're accepting the receipt. Provided by YooMoney, displayed in the Sellers section
+      # of your Merchant Profile (shopId column).
+      attribute :account_id, Types::String
+
+      # amount [object, required]
+      # Amount to be transferred to the store.
+      attribute :amount, Entity::Amount
+
+      # status [string, required]
+      # Status of the money distribution between stores. Possible values: pending, waiting_for_capture, succeeded, canceled.
+      attribute :status, Types::String.enum("pending", "waiting_for_capture", "succeeded", "canceled")
+
+      # platform_fee_amount [object, optional]
+      # Commission for sold products or services charged in your favor.
+      attribute? :platform_fee_amount, Entity::Amount
+
+      # metadata [object, optional]
+      # Any additional data you might require for processing payments (for example, order number), specified as a “key-value” pair
+      # and returned in response from YooMoney. Limitations: no more than 16 keys, no more than 32 characters in the key’s title,
+      # no more than 512 characters in the key’s value, data type is a string in the UTF-8 format.
+      attribute? :metadata, Types::Hash
+    end
+  end
+end

data/lib/yookassa/entity/types.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+module Yookassa
+  module Entity
+    module Types
+      include Dry.Types()
+    end
+  end
+end

data/lib/yookassa/payments.rb

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+require_relative "./entity/payment"
+
+module Yookassa
+  class Payments
+    def initialize(api)
+      @api = api
+    end
+
+    def find(payment_id:)
+      data = api.get("payments/#{payment_id}")
+      Entity::Payment.new(**data)
+    end
+
+    def create(payment:, idempotency_key: SecureRandom.hex(10))
+      data = api.post("payments", payload: payment, idempotency_key: idempotency_key)
+      Entity::Payment.new(**data.merge(idempotency_key: idempotency_key))
+    end
+
+    def capture(payment_id:, idempotency_key: SecureRandom.hex(10))
+      data = api.post("payments/#{payment_id}/capture", idempotency_key: idempotency_key)
+      Entity::Payment.new(**data.merge(idempotency_key: idempotency_key))
+    end
+
+    def cancel(payment_id:, idempotency_key: SecureRandom.hex(10))
+      data = api.post("payments/#{payment_id}/cancel", idempotency_key: idempotency_key)
+      Entity::Payment.new(**data.merge(idempotency_key: idempotency_key))
+    end
+
+    private
+
+    attr_reader :api
+  end
+end

data/lib/yookassa/refunds.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+require_relative "./entity/refund"
+
+module Yookassa
+  class Refunds
+    def initialize(api)
+      @api = api
+    end
+
+    def find(payment_id:)
+      data = api.get("refunds/#{payment_id}")
+      Entity::Refund.new(**data)
+    end
+
+    def create(payload:, idempotency_key: SecureRandom.hex(10))
+      data = api.post("refunds", payload: payload, idempotency_key: idempotency_key)
+      Entity::Refund.new(**data.merge(idempotency_key: idempotency_key))
+    end
+
+    private
+
+    attr_reader :api
+  end
+end

data/lib/yookassa/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Yookassa
-  VERSION = '0.1.0'
+  VERSION = "0.2.0"
 end

data/lib/yookassa.rb

@@ -1,13 +1,31 @@
 # frozen_string_literal: true
 
-require 'evil/client'
-
-require 'yookassa/version'
-require 'yookassa/payment'
-require 'yookassa/refund'
-require 'yookassa/response'
-require 'yookassa/callable'
-require 'yookassa/optional'
-require 'yookassa/entity/payment'
-require 'yookassa/entity/refund'
-require 'yookassa/error'
+require "dry-struct"
+require "forwardable"
+require "yookassa/version"
+require "yookassa/config"
+require "yookassa/client"
+
+module Yookassa
+  ConfigError = Class.new(StandardError)
+
+  class << self
+    extend Forwardable
+
+    def configure
+      yield(config)
+    end
+
+    def config
+      @config ||= Config.new
+    end
+
+    def client
+      raise ConfigError, "Specify `shop_id` and `api_key` settins in a `.configure` block" if @config.nil?
+
+      @client ||= Client.new(shop_id: @config.shop_id, api_key: @config.api_key)
+    end
+
+    def_delegators :client, :payments, :refunds
+  end
+end

data/spec/fixtures/refund.json

@@ -1,8 +1,8 @@
 {
   "amount": {
-      "value": "8.00",
-      "currency": "RUB"
-},
-"payment_id": "40484c25-1095-4d36-8b17-92672d1e127d",
+    "value": "8.00",
+    "currency": "RUB"
+  },
+  "payment_id": "40484c25-1095-4d36-8b17-92672d1e127d",
   "description": "test refund, idem-key 40484c25-1095-4d36-8b17-92672d1e127d"
 }

data/spec/spec_helper.rb

@@ -1,21 +1,16 @@
 # frozen_string_literal: true
 
 begin
-  require 'pry'
+  require "pry"
 rescue LoadError
   nil
 end
 
-require 'yookassa'
-require 'webmock/rspec'
+require "yookassa"
+require "webmock/rspec"
 
 RSpec.configure do |config|
   config.order = :random
   config.filter_run focus: true
   config.run_all_when_everything_filtered = true
-
-  config.around(:each) do |example|
-    stub_request(:any, //)
-    example.run
-  end
 end

data/spec/yookassa/config_spec.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+RSpec.describe Yookassa::Config do
+  subject { described_class.new }
+  it { is_expected.to respond_to(:shop_id) }
+  it { is_expected.to respond_to(:api_key) }
+end