refactoring

Author: batazor

payments/README.md

@@ -13,6 +13,13 @@ We use Makefile for build and deploy.
 $> make help # show help message with all commands and targets
 ```
 
+### Payment Providers
+
+The service supports multiple payment providers. Configuration details are available in each provider's documentation:
+
+- **[Stripe Provider](./internal/adapter/stripe/README.md)** - Default provider for international payments
+- **[Tinkoff Provider](./internal/adapter/tinkoff/README.md)** - Provider for Russian payments with TLS client certificate authentication
+
 ### ADR
 
 - [ADR-0001](./docs/ADR/decisions/0001-init.md) - Init project

payments/internal/adapter/stripe/README.md

@@ -0,0 +1,36 @@
+# Stripe Payment Provider
+
+This package provides integration with Stripe payment processing service.
+
+## Configuration
+
+### Environment Variables
+
+| Variable | Description | Required |
+|----------|-------------|----------|
+| `STRIPE_API_KEY` | Stripe API key (starts with `sk_`) | Yes |
+
+### Example Configuration
+
+```bash
+export STRIPE_API_KEY=sk_test_...
+```
+
+### API Key Types
+
+- **Test keys**: Start with `sk_test_` - use for development and testing
+- **Live keys**: Start with `sk_live_` - use for production
+
+## Usage
+
+The Stripe provider is automatically selected when:
+- `PAYMENT_PROVIDER` is set to `stripe`
+- `PAYMENT_PROVIDER` is not set (default behavior)
+
+## Error Handling
+
+- `ErrMissingAPIKey`: Returned when `STRIPE_API_KEY` environment variable is not set
+
+## Implementation Details
+
+The provider uses the official Stripe Go SDK (v82) and automatically configures the client with the provided API key.

payments/internal/adapter/tinkoff/README.md

@@ -0,0 +1,66 @@
+# Tinkoff Payment Provider
+
+This package provides integration with Tinkoff Bank payment processing service.
+
+## Configuration
+
+### Environment Variables
+
+| Variable | Description | Required |
+|----------|-------------|----------|
+| `TINKOFF_API_KEY` | Tinkoff API key for authentication | Yes |
+| `TINKOFF_CERT_FILE` | Path to client certificate file (.pem) | Yes |
+| `TINKOFF_KEY_FILE` | Path to client private key file (.key) | Yes |
+| `TINKOFF_BASE_URL` | Base URL for Tinkoff API | No (defaults to https://secured-openapi.tbank.ru) |
+
+### Example Configuration
+
+```bash
+export TINKOFF_API_KEY=your_tinkoff_api_key
+export TINKOFF_CERT_FILE=/path/to/your/cert.pem
+export TINKOFF_KEY_FILE=/path/to/your/key.key
+export TINKOFF_BASE_URL=https://secured-openapi.tbank.ru
+```
+
+## Setup
+
+To use Tinkoff as a payment provider, you need to:
+
+1. Obtain client certificates from Tinkoff
+2. Set up the required environment variables
+3. Configure the payment details (currently hardcoded for demo purposes)
+
+## Usage
+
+The Tinkoff provider is selected when `PAYMENT_PROVIDER` is set to `tinkoff`:
+
+```bash
+export PAYMENT_PROVIDER=tinkoff
+```
+
+## Error Handling
+
+- `ErrMissingAPIKey`: Returned when `TINKOFF_API_KEY` environment variable is not set
+- `ErrMissingCertFile`: Returned when `TINKOFF_CERT_FILE` environment variable is not set
+- `ErrMissingKeyFile`: Returned when `TINKOFF_KEY_FILE` environment variable is not set
+
+## Production Configuration
+
+The following fields in the Tinkoff payment request are currently hardcoded and should be configured for production:
+
+- `From.AccountNumber` - Your Tinkoff account number
+- `To.Name` - Recipient name
+- `To.INN` - Recipient INN
+- `To.KPP` - Recipient KPP
+- `To.BIK` - Bank BIK
+- `To.BankName` - Bank name
+- `To.CorrAccountNumber` - Correspondent account number
+- `To.AccountNumber` - Recipient account number
+- `Tax.KBK` - Budget classification code
+- `Tax.OKTMO` - OKTMO code
+
+These should be moved to configuration files or environment variables for production use.
+
+## Implementation Details
+
+The provider uses mutual TLS authentication with client certificates and makes HTTP requests to the Tinkoff API endpoints.

payments/internal/adapter/tinkoff/docs/Kreya-win.7z

@@ -0,0 +1,22 @@
+# Квалифицированный инвестор
+
+Согласно законодательству Российской Федерации, физическое лицо должно иметь статус квалифицированного инвестора для доступа к операциям с определённым перечнем ценных бумаг. Например, для торгов ценными бумагами на иностранных биржах и активами на внебиржевом рынке — сплитированными и целыми лотами евробондов российских и зарубежных компаний, структурными нотами и многим другим.
+
+Неквалифицированные инвесторы не могут торгововать ценными бумагами, которых нет на Бирже СПБ и ММВБ.
+
+## Требования к квалифицированным инвесторам
+
+Чтобы получить статус квалифицированного инвестора, нужно выполнить одно из условий: 
+
+* владеть активами на сумму от 6 млн рублей;
+* иметь опыт работы на финансовом рынке; 
+* иметь профильное образование; 
+* иметь оборот по сделкам от 6 млн рублей.
+
+## Смотрите также
+
+* [Подробнее про статус квалифицированного инвестора](https://www.tbank.ru/invest/help/educate/qualification/)
+
+* [Как получить статус квалифицированного инвестора](https://www.tbank.ru/invest/help/educate/qualification/about/how-get/)
+
+* [Как получить статус квалифицированного инвестора по опыту работы](https://www.tbank.ru/invest/help/educate/qualification/about/terms/)