yoomoney 0.1.0

data/rbi/yoomoney/resources/payments.rbi

@@ -0,0 +1,186 @@
+# typed: strong
+
+module Yoomoney
+  module Resources
+    class Payments
+      # Создание платежа
+      sig do
+        params(
+          amount: Yoomoney::MonetaryAmount::OrHash,
+          idempotence_key: String,
+          airline: Yoomoney::Airline::OrHash,
+          capture: T::Boolean,
+          client_ip: String,
+          confirmation:
+            T.any(
+              Yoomoney::PaymentCreateParams::Confirmation::ConfirmationDataRedirect::OrHash,
+              Yoomoney::PaymentCreateParams::Confirmation::ConfirmationDataExternal::OrHash,
+              Yoomoney::ConfirmationData::OrHash,
+              Yoomoney::PaymentCreateParams::Confirmation::ConfirmationDataEmbedded::OrHash,
+              Yoomoney::PaymentCreateParams::Confirmation::ConfirmationDataMobileApplication::OrHash
+            ),
+          deal: Yoomoney::PaymentDealInfo::OrHash,
+          description: String,
+          merchant_customer_id: String,
+          metadata: T::Hash[Symbol, String],
+          payment_method_data:
+            T.any(
+              Yoomoney::PaymentCreateParams::PaymentMethodData::PaymentMethodDataBankCard::OrHash,
+              Yoomoney::PaymentCreateParams::PaymentMethodData::PaymentMethodDataCash::OrHash,
+              Yoomoney::PaymentCreateParams::PaymentMethodData::PaymentMethodDataSberbank::OrHash,
+              Yoomoney::PaymentMethodData::OrHash,
+              Yoomoney::PaymentCreateParams::PaymentMethodData::PaymentMethodDataMobileBalance::OrHash,
+              Yoomoney::PaymentCreateParams::PaymentMethodData::PaymentMethodDataB2bSberbank::OrHash,
+              Yoomoney::PaymentCreateParams::PaymentMethodData::PaymentMethodDataElectronicCertificate::OrHash
+            ),
+          payment_method_id: String,
+          payment_order: Yoomoney::PaymentCreateParams::PaymentOrder::OrHash,
+          payment_token: String,
+          receipt: Yoomoney::ReceiptData::OrHash,
+          receiver:
+            T.any(
+              Yoomoney::PaymentCreateParams::Receiver::ReceiverMobileBalance::OrHash,
+              Yoomoney::PaymentCreateParams::Receiver::ReceiverDigitalWallet::OrHash,
+              Yoomoney::PaymentCreateParams::Receiver::ReceiverBankAccount::OrHash
+            ),
+          recipient: Yoomoney::Recipient::OrHash,
+          save_payment_method: T::Boolean,
+          statements:
+            T::Array[Yoomoney::PaymentCreateParams::Statement::OrHash],
+          transfers: T::Array[Yoomoney::PaymentCreateParams::Transfer::OrHash],
+          request_options: Yoomoney::RequestOptions::OrHash
+        ).returns(Yoomoney::Payment)
+      end
+      def create(
+        # Body param: Сумма платежа.
+        amount:,
+        # Header param
+        idempotence_key:,
+        # Body param: Данные для продажи авиабилетов.
+        airline: nil,
+        # Body param: Автоматический прием поступившего платежа.
+        capture: nil,
+        # Body param: IPv4 или IPv6-адрес пользователя.
+        client_ip: nil,
+        # Body param: Данные, необходимые для инициирования выбранного сценария
+        # подтверждения платежа пользователем.
+        confirmation: nil,
+        # Body param: Данные о сделке.
+        deal: nil,
+        # Body param: Описание транзакции.
+        description: nil,
+        # Body param: Идентификатор покупателя в вашей системе.
+        merchant_customer_id: nil,
+        # Body param: Любые дополнительные данные, которые нужны вам для работы (например,
+        # номер заказа). Передаются в виде набора пар «ключ-значение» и возвращаются в
+        # ответе от ЮKassa. Ограничения: максимум 16 ключей, имя ключа не больше 32
+        # символов, значение ключа не больше 512 символов, тип данных — строка в формате
+        # UTF-8.
+        metadata: nil,
+        # Body param: Данные для оплаты конкретным способом.
+        payment_method_data: nil,
+        # Body param: Идентификатор сохраненного способа оплаты.
+        payment_method_id: nil,
+        # Body param: Данные платежного поручения.
+        payment_order: nil,
+        # Body param: Одноразовый токен для оплаты банковской картой.
+        payment_token: nil,
+        # Body param: Данные для формирования чека.
+        receipt: nil,
+        # Body param: Получатель перевода.
+        receiver: nil,
+        # Body param: Получатель платежа.
+        recipient: nil,
+        # Body param: Сохранение платежных данных.
+        save_payment_method: nil,
+        # Body param: Данные для отправки справки.
+        statements: nil,
+        # Body param: Данные о распределении денег.
+        transfers: nil,
+        request_options: {}
+      )
+      end
+
+      # Информация о платеже
+      sig do
+        params(
+          payment_id: String,
+          request_options: Yoomoney::RequestOptions::OrHash
+        ).returns(Yoomoney::Payment)
+      end
+      def retrieve(payment_id, request_options: {})
+      end
+
+      # Список платежей
+      sig do
+        params(
+          captured_at: Yoomoney::PaymentListParams::CapturedAt::OrHash,
+          created_at: Yoomoney::PaymentListParams::CreatedAt::OrHash,
+          cursor: String,
+          limit: Integer,
+          payment_method: Yoomoney::PaymentMethodType::OrSymbol,
+          status: Yoomoney::PaymentStatus::OrSymbol,
+          request_options: Yoomoney::RequestOptions::OrHash
+        ).returns(Yoomoney::Models::PaymentListResponse)
+      end
+      def list(
+        captured_at: nil,
+        created_at: nil,
+        cursor: nil,
+        limit: nil,
+        payment_method: nil,
+        status: nil,
+        request_options: {}
+      )
+      end
+
+      # Отмена платежа
+      sig do
+        params(
+          payment_id: String,
+          idempotence_key: String,
+          request_options: Yoomoney::RequestOptions::OrHash
+        ).returns(Yoomoney::Payment)
+      end
+      def cancel(payment_id, idempotence_key:, request_options: {})
+      end
+
+      # Подтверждение платежа
+      sig do
+        params(
+          payment_id: String,
+          idempotence_key: String,
+          airline: Yoomoney::Airline::OrHash,
+          amount: Yoomoney::MonetaryAmount::OrHash,
+          deal: Yoomoney::PaymentDealInfo::OrHash,
+          receipt: Yoomoney::ReceiptData::OrHash,
+          transfers: T::Array[Yoomoney::TransferData::OrHash],
+          request_options: Yoomoney::RequestOptions::OrHash
+        ).returns(Yoomoney::Payment)
+      end
+      def capture(
+        # Path param
+        payment_id,
+        # Header param
+        idempotence_key:,
+        # Body param: Данные для продажи авиабилетов.
+        airline: nil,
+        # Body param: Подтверждаемая сумма платежа.
+        amount: nil,
+        # Body param: Данные о сделке.
+        deal: nil,
+        # Body param: Данные для формирования чека.
+        receipt: nil,
+        # Body param: Данные о распределении денег.
+        transfers: nil,
+        request_options: {}
+      )
+      end
+
+      # @api private
+      sig { params(client: Yoomoney::Client).returns(T.attached_class) }
+      def self.new(client:)
+      end
+    end
+  end
+end

data/rbi/yoomoney/resources/payouts.rbi

@@ -0,0 +1,104 @@
+# typed: strong
+
+module Yoomoney
+  module Resources
+    class Payouts
+      # Создание выплаты
+      sig do
+        params(
+          amount: Yoomoney::MonetaryAmount::OrHash,
+          idempotence_key: String,
+          deal: Yoomoney::PayoutDealInfo::OrHash,
+          description: String,
+          metadata: T::Hash[Symbol, String],
+          payment_method_id: String,
+          payout_destination_data:
+            T.any(
+              Yoomoney::PayoutCreateParams::PayoutDestinationData::PayoutToYooMoneyDestinationData::OrHash,
+              Yoomoney::PayoutCreateParams::PayoutDestinationData::PayoutToBankCardDestinationData::OrHash,
+              Yoomoney::PayoutCreateParams::PayoutDestinationData::PayoutToSbpDestinationData::OrHash
+            ),
+          payout_token: String,
+          personal_data:
+            T::Array[Yoomoney::PayoutCreateParams::PersonalData::OrHash],
+          request_options: Yoomoney::RequestOptions::OrHash
+        ).returns(Yoomoney::Payout)
+      end
+      def create(
+        # Body param: Сумма выплаты.
+        amount:,
+        # Header param
+        idempotence_key:,
+        # Body param: Данные о сделке.
+        deal: nil,
+        # Body param: Описание выплаты.
+        description: nil,
+        # Body param: Любые дополнительные данные, которые нужны вам для работы (например,
+        # номер заказа). Передаются в виде набора пар «ключ-значение» и возвращаются в
+        # ответе от ЮKassa. Ограничения: максимум 16 ключей, имя ключа не больше 32
+        # символов, значение ключа не больше 512 символов, тип данных — строка в формате
+        # UTF-8.
+        metadata: nil,
+        # Body param: Идентификатор сохраненного способа оплаты.
+        payment_method_id: nil,
+        # Body param: Данные для проведения выплаты.
+        payout_destination_data: nil,
+        # Body param: Токен для проведения выплаты.
+        payout_token: nil,
+        # Body param: Персональные данные получателя выплаты.
+        personal_data: nil,
+        request_options: {}
+      )
+      end
+
+      # Информация о выплате
+      sig do
+        params(
+          payout_id: String,
+          request_options: Yoomoney::RequestOptions::OrHash
+        ).returns(Yoomoney::Payout)
+      end
+      def retrieve(payout_id, request_options: {})
+      end
+
+      # Список выплат
+      sig do
+        params(
+          created_at: Yoomoney::PayoutListParams::CreatedAt::OrHash,
+          cursor: String,
+          limit: Integer,
+          payout_destination:
+            Yoomoney::PayoutListParams::PayoutDestination::OrHash,
+          status: Yoomoney::PayoutStatus::OrSymbol,
+          request_options: Yoomoney::RequestOptions::OrHash
+        ).returns(Yoomoney::PayoutsList)
+      end
+      def list(
+        created_at: nil,
+        cursor: nil,
+        limit: nil,
+        payout_destination: nil,
+        status: nil,
+        request_options: {}
+      )
+      end
+
+      # Поиск выплат по метаданным
+      sig do
+        params(
+          created_at: Yoomoney::PayoutSearchParams::CreatedAt::OrHash,
+          cursor: String,
+          limit: Integer,
+          request_options: Yoomoney::RequestOptions::OrHash
+        ).returns(Yoomoney::PayoutsList)
+      end
+      def search(created_at: nil, cursor: nil, limit: nil, request_options: {})
+      end
+
+      # @api private
+      sig { params(client: Yoomoney::Client).returns(T.attached_class) }
+      def self.new(client:)
+      end
+    end
+  end
+end

data/rbi/yoomoney/resources/personal_data.rbi

@@ -0,0 +1,55 @@
+# typed: strong
+
+module Yoomoney
+  module Resources
+    class PersonalData
+      # Создание персональных данных
+      sig do
+        params(
+          first_name: String,
+          last_name: String,
+          type: Yoomoney::PersonalDataType::OrSymbol,
+          idempotence_key: String,
+          metadata: T::Hash[Symbol, String],
+          middle_name: String,
+          request_options: Yoomoney::RequestOptions::OrHash
+        ).returns(Yoomoney::PersonalDataAPI)
+      end
+      def create(
+        # Body param: Имя.
+        first_name:,
+        # Body param: Фамилия.
+        last_name:,
+        # Body param: Тип персональных данных.
+        type:,
+        # Header param
+        idempotence_key:,
+        # Body param: Любые дополнительные данные, которые нужны вам для работы (например,
+        # номер заказа). Передаются в виде набора пар «ключ-значение» и возвращаются в
+        # ответе от ЮKassa. Ограничения: максимум 16 ключей, имя ключа не больше 32
+        # символов, значение ключа не больше 512 символов, тип данных — строка в формате
+        # UTF-8.
+        metadata: nil,
+        # Body param: Отчество.
+        middle_name: nil,
+        request_options: {}
+      )
+      end
+
+      # Информация о персональных данных
+      sig do
+        params(
+          personal_data_id: String,
+          request_options: Yoomoney::RequestOptions::OrHash
+        ).returns(Yoomoney::PersonalDataAPI)
+      end
+      def retrieve(personal_data_id, request_options: {})
+      end
+
+      # @api private
+      sig { params(client: Yoomoney::Client).returns(T.attached_class) }
+      def self.new(client:)
+      end
+    end
+  end
+end

data/rbi/yoomoney/resources/receipts.rbi

@@ -0,0 +1,102 @@
+# typed: strong
+
+module Yoomoney
+  module Resources
+    class Receipts
+      # Создание чека
+      sig do
+        params(
+          customer: Yoomoney::ReceiptDataCustomer::OrHash,
+          items: T::Array[Yoomoney::ReceiptCreateParams::Item::OrHash],
+          send_: T::Boolean,
+          settlements: T::Array[Yoomoney::Settlement::OrHash],
+          type: Yoomoney::ReceiptType::OrSymbol,
+          idempotence_key: String,
+          additional_user_props:
+            Yoomoney::ReceiptCreateParams::AdditionalUserProps::OrHash,
+          internet: T::Boolean,
+          on_behalf_of: String,
+          payment_id: String,
+          receipt_industry_details: T::Array[Yoomoney::IndustryDetails::OrHash],
+          receipt_operational_details: Yoomoney::OperationalDetails::OrHash,
+          refund_id: String,
+          tax_system_code: Integer,
+          timezone: String,
+          request_options: Yoomoney::RequestOptions::OrHash
+        ).returns(Yoomoney::Receipt)
+      end
+      def create(
+        # Body param: Данные покупателя.
+        customer:,
+        # Body param: Позиции чека.
+        items:,
+        # Body param: Признак отправки чека пользователю.
+        send_:,
+        # Body param: Данные расчетов.
+        settlements:,
+        # Body param: Тип чека.
+        type:,
+        # Header param
+        idempotence_key:,
+        # Body param: Дополнительный реквизит пользователя.
+        additional_user_props: nil,
+        # Body param: Флаг расчета в интернете.
+        internet: nil,
+        # Body param: Идентификатор магазина.
+        on_behalf_of: nil,
+        # Body param: Идентификатор платежа.
+        payment_id: nil,
+        # Body param: Отраслевой реквизит чека.
+        receipt_industry_details: nil,
+        # Body param: Операционный реквизит чека.
+        receipt_operational_details: nil,
+        # Body param: Идентификатор возврата.
+        refund_id: nil,
+        # Body param: Код системы налогообложения.
+        tax_system_code: nil,
+        # Body param: Часовой пояс.
+        timezone: nil,
+        request_options: {}
+      )
+      end
+
+      # Информация о чеке
+      sig do
+        params(
+          receipt_id: String,
+          request_options: Yoomoney::RequestOptions::OrHash
+        ).returns(Yoomoney::Receipt)
+      end
+      def retrieve(receipt_id, request_options: {})
+      end
+
+      # Список чеков
+      sig do
+        params(
+          created_at: Yoomoney::ReceiptListParams::CreatedAt::OrHash,
+          cursor: String,
+          limit: Integer,
+          payment_id: String,
+          refund_id: String,
+          status: Yoomoney::ReceiptRegistrationStatus::OrSymbol,
+          request_options: Yoomoney::RequestOptions::OrHash
+        ).returns(Yoomoney::Models::ReceiptListResponse)
+      end
+      def list(
+        created_at: nil,
+        cursor: nil,
+        limit: nil,
+        payment_id: nil,
+        refund_id: nil,
+        status: nil,
+        request_options: {}
+      )
+      end
+
+      # @api private
+      sig { params(client: Yoomoney::Client).returns(T.attached_class) }
+      def self.new(client:)
+      end
+    end
+  end
+end

data/rbi/yoomoney/resources/refunds.rbi

@@ -0,0 +1,86 @@
+# typed: strong
+
+module Yoomoney
+  module Resources
+    class Refunds
+      # Создание возврата
+      sig do
+        params(
+          amount: Yoomoney::MonetaryAmount::OrHash,
+          payment_id: String,
+          idempotence_key: String,
+          deal: Yoomoney::RefundCreateParams::Deal::OrHash,
+          description: String,
+          metadata: T::Hash[Symbol, String],
+          receipt: Yoomoney::ReceiptData::OrHash,
+          refund_method_data:
+            Yoomoney::RefundCreateParams::RefundMethodData::OrHash,
+          sources: T::Array[Yoomoney::RefundSourcesData::OrHash],
+          request_options: Yoomoney::RequestOptions::OrHash
+        ).returns(Yoomoney::Refund)
+      end
+      def create(
+        # Body param: Сумма возврата.
+        amount:,
+        # Body param: Идентификатор платежа для возврата.
+        payment_id:,
+        # Header param
+        idempotence_key:,
+        # Body param: Данные о сделке.
+        deal: nil,
+        # Body param: Описание возврата.
+        description: nil,
+        # Body param: Любые дополнительные данные, которые нужны вам для работы (например,
+        # номер заказа). Передаются в виде набора пар «ключ-значение» и возвращаются в
+        # ответе от ЮKassa. Ограничения: максимум 16 ключей, имя ключа не больше 32
+        # символов, значение ключа не больше 512 символов, тип данных — строка в формате
+        # UTF-8.
+        metadata: nil,
+        # Body param: Данные для формирования чека.
+        receipt: nil,
+        # Body param: Данные о способе возврата.
+        refund_method_data: nil,
+        # Body param: Источники для возврата.
+        sources: nil,
+        request_options: {}
+      )
+      end
+
+      # Информация о возврате
+      sig do
+        params(
+          refund_id: String,
+          request_options: Yoomoney::RequestOptions::OrHash
+        ).returns(Yoomoney::Refund)
+      end
+      def retrieve(refund_id, request_options: {})
+      end
+
+      # Список возвратов
+      sig do
+        params(
+          created_at: Yoomoney::RefundListParams::CreatedAt::OrHash,
+          cursor: String,
+          limit: Integer,
+          payment_id: String,
+          status: Yoomoney::RefundStatus::OrSymbol,
+          request_options: Yoomoney::RequestOptions::OrHash
+        ).returns(Yoomoney::Models::RefundListResponse)
+      end
+      def list(
+        created_at: nil,
+        cursor: nil,
+        limit: nil,
+        payment_id: nil,
+        status: nil,
+        request_options: {}
+      )
+      end
+
+      # @api private
+      sig { params(client: Yoomoney::Client).returns(T.attached_class) }
+      def self.new(client:)
+      end
+    end
+  end
+end

data/rbi/yoomoney/resources/sbp_banks.rbi

@@ -0,0 +1,21 @@
+# typed: strong
+
+module Yoomoney
+  module Resources
+    class SbpBanks
+      # Список участников СБП
+      sig do
+        params(request_options: Yoomoney::RequestOptions::OrHash).returns(
+          Yoomoney::Models::SbpBankListResponse
+        )
+      end
+      def list(request_options: {})
+      end
+
+      # @api private
+      sig { params(client: Yoomoney::Client).returns(T.attached_class) }
+      def self.new(client:)
+      end
+    end
+  end
+end

data/rbi/yoomoney/resources/webhooks.rbi

@@ -0,0 +1,51 @@
+# typed: strong
+
+module Yoomoney
+  module Resources
+    class Webhooks
+      # Создание webhook
+      sig do
+        params(
+          event: Yoomoney::NotificationEventType::OrSymbol,
+          url: String,
+          idempotence_key: String,
+          request_options: Yoomoney::RequestOptions::OrHash
+        ).returns(Yoomoney::Webhook)
+      end
+      def create(
+        # Body param: Событие, о котором нужно уведомить.
+        event:,
+        # Body param: URL для уведомлений.
+        url:,
+        # Header param
+        idempotence_key:,
+        request_options: {}
+      )
+      end
+
+      # Список webhook
+      sig do
+        params(request_options: Yoomoney::RequestOptions::OrHash).returns(
+          Yoomoney::Models::WebhookListResponse
+        )
+      end
+      def list(request_options: {})
+      end
+
+      # Удаление webhook
+      sig do
+        params(
+          webhook_id: String,
+          request_options: Yoomoney::RequestOptions::OrHash
+        ).returns(T.anything)
+      end
+      def delete(webhook_id, request_options: {})
+      end
+
+      # @api private
+      sig { params(client: Yoomoney::Client).returns(T.attached_class) }
+      def self.new(client:)
+      end
+    end
+  end
+end

data/rbi/yoomoney/version.rbi

@@ -0,0 +1,5 @@
+# typed: strong
+
+module Yoomoney
+  VERSION = T.let(T.unsafe(nil), String)
+end

data/sig/yoomoney/client.rbs

@@ -0,0 +1,47 @@
+module Yoomoney
+  class Client < Yoomoney::Internal::Transport::BaseClient
+    DEFAULT_MAX_RETRIES: 2
+
+    DEFAULT_TIMEOUT_IN_SECONDS: Float
+
+    DEFAULT_INITIAL_RETRY_DELAY: Float
+
+    DEFAULT_MAX_RETRY_DELAY: Float
+
+    attr_reader username: String?
+
+    attr_reader password: String?
+
+    attr_reader payments: Yoomoney::Resources::Payments
+
+    attr_reader payment_methods: Yoomoney::Resources::PaymentMethods
+
+    attr_reader invoices: Yoomoney::Resources::Invoices
+
+    attr_reader refunds: Yoomoney::Resources::Refunds
+
+    attr_reader receipts: Yoomoney::Resources::Receipts
+
+    attr_reader deals: Yoomoney::Resources::Deals
+
+    attr_reader payouts: Yoomoney::Resources::Payouts
+
+    attr_reader sbp_banks: Yoomoney::Resources::SbpBanks
+
+    attr_reader personal_data: Yoomoney::Resources::PersonalData
+
+    attr_reader webhooks: Yoomoney::Resources::Webhooks
+
+    attr_reader me: Yoomoney::Resources::Me
+
+    def initialize: (
+      ?username: String?,
+      ?password: String?,
+      ?base_url: String?,
+      ?max_retries: Integer,
+      ?timeout: Float,
+      ?initial_retry_delay: Float,
+      ?max_retry_delay: Float
+    ) -> void
+  end
+end