node-behind-api-client 2.0.48

package/docs/behind-api-client/payments/payture/README.rukitchen.md

@@ -0,0 +1,396 @@
+# Recipe Access Purchase - Quick Start Guide
+
+## Workflow Overview
+
+This guide describes the complete workflow for purchasing access to a recipe page.
+
+---
+
+## Workflow Steps
+
+### Step 1: User Clicks "Купить доступ к рецепту"
+
+When the user clicks the purchase button, collect the following data:
+
+**Required Data:**
+- `user_id` - Current user's UUID
+- `subscription_id` - Fixed value: `"a295e987-28c6-4b79-b1f7-5245d95b91d6"`
+- `pageId` - The recipe page ID (e.g., `"ck4jrtawdA3Ed4"`)
+- `redirect_url` - Where to return after payment: `https://shop.ru-kitchen.ru/bills/{bill_id}`
+
+**Example Data:**
+```javascript
+const userId = getCurrentUserId(); // Get from your auth system
+const subscriptionId = "a295e987-28c6-4b79-b1f7-5245d95b91d6";
+const pageId = "ck4jrtawdA3Ed4";
+const originalPageUrl = "https://ru-kitchen.ru/old/baking/ck4jrtawdA3Ed4-fokachcha";
+```
+
+### Step 2: Create Payment Bill
+
+Call the `billCreateUnauthorised` function with the collected data:
+
+```javascript
+async function purchaseRecipeAccess(userId, pageId, originalPageUrl) {
+    try {
+        const subscriptionId = "a295e987-28c6-4b79-b1f7-5245d95b91d6";
+        
+        const result = await behindAPI.easyjob.V20.payments.payture.billCreateUnauthorised(
+            subscriptionId,
+            userId,
+            `https://shop.ru-kitchen.ru/bills/`, // Will append bill_id automatically
+            {
+                pageId: pageId,
+                redirectUrl: originalPageUrl
+            }
+        );
+        
+        if (result.success) {
+            const billId = result.data.bill_id;
+            const paymentUrl = result.data.bill.payUrl;
+            
+            console.log(`Bill created: ${billId}`);
+            console.log(`Redirecting to payment terminal: ${paymentUrl}`);
+            
+            // Redirect user to payment terminal
+            window.location.href = paymentUrl;
+            
+            return { success: true, billId, paymentUrl };
+        } else {
+            console.error("Failed to create bill:", result.message);
+            alert("Не удалось создать платеж. Попробуйте снова.");
+            return { success: false, error: result.message };
+        }
+        
+    } catch (error) {
+        console.error("Error:", error);
+        alert("Произошла ошибка. Попробуйте снова.");
+        return { success: false, error: error.message };
+    }
+}
+
+// Usage
+const userId = "user-uuid-here";
+const pageId = "ck4jrtawdA3Ed4";
+const originalPageUrl = "https://ru-kitchen.ru/old/baking/ck4jrtawdA3Ed4-fokachcha";
+
+purchaseRecipeAccess(userId, pageId, originalPageUrl);
+```
+
+### Step 3: User Completes Payment
+
+The user is redirected to the Payture payment terminal (payUrl) where they complete the payment.
+
+### Step 4: Return to Confirmation Page
+
+After successful payment, Payture redirects the user to:
+```
+https://shop.ru-kitchen.ru/bills/4c0275df-6c8d-4f1a-b25b-b2db4b831707
+```
+
+### Step 5: Check Payment Status
+
+On the confirmation page, check the payment status:
+
+```javascript
+async function checkPaymentStatus() {
+    try {
+        // Extract bill_id from URL
+        const urlPath = window.location.pathname;
+        const billId = urlPath.split('/bills/')[1];
+        
+        if (!billId) {
+            console.error("Bill ID not found in URL");
+            return;
+        }
+        
+        console.log(`Checking status for bill: ${billId}`);
+        
+        // Check payment status
+        const statusResult = await behindAPI.easyjob.V20.payments.payture.billStatus(billId);
+        
+        if (!statusResult.success) {
+            displayError("Не удалось проверить статус платежа");
+            return;
+        }
+        
+        const status = statusResult.data.status;
+        console.log(`Payment status: ${status}`);
+        
+        if (status === "PAID" || status === "DONE") {
+            // Payment successful
+            displaySuccess("Оплата прошла успешно! Доступ к рецепту открыт.");
+            
+            // Redirect back to recipe page after 3 seconds
+            setTimeout(() => {
+                const redirectUrl = getRedirectUrlFromBill();
+                if (redirectUrl) {
+                    window.location.href = redirectUrl;
+                }
+            }, 3000);
+            
+        } else if (status === "PENDING") {
+            // Payment still processing
+            displayPending("Платеж обрабатывается. Пожалуйста, подождите...");
+            
+            // Retry after 3 seconds
+            setTimeout(checkPaymentStatus, 3000);
+            
+        } else if (status === "AMOUNT_MISMATCH") {
+            displayError("Ошибка оплаты. Свяжитесь с поддержкой.");
+        } else {
+            displayError("Неизвестный статус платежа.");
+        }
+        
+    } catch (error) {
+        console.error("Error checking payment status:", error);
+        displayError("Произошла ошибка при проверке статуса платежа");
+    }
+}
+
+// Display functions
+function displaySuccess(message) {
+    document.getElementById('status-message').textContent = message;
+    document.getElementById('status-container').className = 'success';
+}
+
+function displayPending(message) {
+    document.getElementById('status-message').textContent = message;
+    document.getElementById('status-container').className = 'pending';
+}
+
+function displayError(message) {
+    document.getElementById('status-message').textContent = message;
+    document.getElementById('status-container').className = 'error';
+}
+
+function getRedirectUrlFromBill() {
+    // Get from extended data or use default
+    return "https://ru-kitchen.ru/old/baking/ck4jrtawdA3Ed4-fokachcha";
+}
+
+// Run status check when page loads
+window.addEventListener('load', checkPaymentStatus);
+```
+
+---
+
+## Complete Implementation Example
+
+### Purchase Button Handler
+
+```javascript
+// On recipe page: https://ru-kitchen.ru/old/baking/ck4jrtawdA3Ed4-fokachcha
+document.getElementById('buy-access-button').addEventListener('click', async function(e) {
+    e.preventDefault();
+    
+    // Get current user ID (from your auth system)
+    const userId = window.currentUser?.id || getUserIdFromSession();
+    
+    if (!userId) {
+        alert("Пожалуйста, войдите в систему");
+        return;
+    }
+    
+    // Extract page ID from current URL or data attribute
+    const pageId = this.dataset.pageId || "ck4jrtawdA3Ed4";
+    const currentPageUrl = window.location.href;
+    
+    // Fixed subscription ID for recipe access
+    const subscriptionId = "a295e987-28c6-4b79-b1f7-5245d95b91d6";
+    
+    // Show loading state
+    this.disabled = true;
+    this.textContent = "Создание платежа...";
+    
+    try {
+        const result = await behindAPI.easyjob.V20.payments.payture.billCreateUnauthorised(
+            subscriptionId,
+            userId,
+            `https://shop.ru-kitchen.ru/bills/`,
+            {
+                pageId: pageId,
+                redirectUrl: currentPageUrl
+            }
+        );
+        
+        if (result.success) {
+            // Redirect to payment terminal
+            window.location.href = result.data.bill.payUrl;
+        } else {
+            alert("Ошибка создания платежа: " + result.message);
+            this.disabled = false;
+            this.textContent = "Купить доступ к рецепту";
+        }
+    } catch (error) {
+        console.error("Purchase error:", error);
+        alert("Произошла ошибка. Попробуйте снова.");
+        this.disabled = false;
+        this.textContent = "Купить доступ к рецепту";
+    }
+});
+```
+
+### Confirmation Page (https://shop.ru-kitchen.ru/bills/[bill_id])
+
+```html
+<!DOCTYPE html>
+<html lang="ru">
+<head>
+    <meta charset="UTF-8">
+    <title>Подтверждение оплаты</title>
+    <style>
+        .status-container {
+            padding: 20px;
+            margin: 20px;
+            border-radius: 8px;
+            text-align: center;
+        }
+        .success { background: #d4edda; color: #155724; }
+        .pending { background: #fff3cd; color: #856404; }
+        .error { background: #f8d7da; color: #721c24; }
+        .loader { 
+            border: 4px solid #f3f3f3;
+            border-top: 4px solid #3498db;
+            border-radius: 50%;
+            width: 40px;
+            height: 40px;
+            animation: spin 1s linear infinite;
+            margin: 20px auto;
+        }
+        @keyframes spin {
+            0% { transform: rotate(0deg); }
+            100% { transform: rotate(360deg); }
+        }
+    </style>
+</head>
+<body>
+    <div id="status-container" class="status-container pending">
+        <div class="loader"></div>
+        <h2>Проверка статуса платежа...</h2>
+        <p id="status-message">Пожалуйста, подождите</p>
+    </div>
+
+    <script>
+        async function checkPaymentStatus() {
+            try {
+                // Get bill_id from URL
+                const billId = window.location.pathname.split('/bills/')[1];
+                
+                if (!billId) {
+                    document.getElementById('status-message').textContent = 
+                        "Ошибка: ID платежа не найден";
+                    return;
+                }
+                
+                // Check status
+                const result = await behindAPI.easyjob.V20.payments.payture.billStatus(billId);
+                
+                if (!result.success) {
+                    throw new Error(result.message);
+                }
+                
+                const status = result.data.status;
+                const container = document.getElementById('status-container');
+                const message = document.getElementById('status-message');
+                
+                if (status === "PAID" || status === "DONE") {
+                    container.className = 'status-container success';
+                    document.querySelector('.loader').style.display = 'none';
+                    document.querySelector('h2').textContent = 'Оплата успешна!';
+                    message.textContent = 'Доступ к рецепту открыт. Перенаправление...';
+                    
+                    // Redirect back to recipe page
+                    setTimeout(() => {
+                        // Get redirect URL from extended data or use default
+                        const redirectUrl = "https://ru-kitchen.ru/old/baking/ck4jrtawdA3Ed4-fokachcha";
+                        window.location.href = redirectUrl;
+                    }, 3000);
+                    
+                } else if (status === "PENDING") {
+                    message.textContent = 'Платеж обрабатывается...';
+                    // Retry after 3 seconds
+                    setTimeout(checkPaymentStatus, 3000);
+                    
+                } else if (status === "AMOUNT_MISMATCH") {
+                    container.className = 'status-container error';
+                    document.querySelector('.loader').style.display = 'none';
+                    document.querySelector('h2').textContent = 'Ошибка оплаты';
+                    message.textContent = 'Несоответствие суммы. Свяжитесь с поддержкой.';
+                    
+                } else {
+                    container.className = 'status-container error';
+                    document.querySelector('.loader').style.display = 'none';
+                    document.querySelector('h2').textContent = 'Ошибка';
+                    message.textContent = 'Неизвестный статус платежа: ' + status;
+                }
+                
+            } catch (error) {
+                console.error('Error:', error);
+                const container = document.getElementById('status-container');
+                container.className = 'status-container error';
+                document.querySelector('.loader').style.display = 'none';
+                document.querySelector('h2').textContent = 'Ошибка';
+                document.getElementById('status-message').textContent = 
+                    'Не удалось проверить статус платежа: ' + error.message;
+            }
+        }
+        
+        // Start checking when page loads
+        window.addEventListener('load', checkPaymentStatus);
+    </script>
+</body>
+</html>
+```
+
+---
+
+## Data Flow Summary
+
+```
+1. User on recipe page: https://ru-kitchen.ru/old/baking/ck4jrtawdA3Ed4-fokachcha
+   ↓
+2. Clicks "Купить доступ к рецепту"
+   ↓
+3. Call billCreateUnauthorised with:
+   - subscription_id: "a295e987-28c6-4b79-b1f7-5245d95b91d6"
+   - user_id: <current user>
+   - redirect_url: "https://shop.ru-kitchen.ru/bills/"
+   - extended: { 
+       pageId: "ck4jrtawdA3Ed4",
+       redirectUrl: "https://ru-kitchen.ru/old/baking/ck4jrtawdA3Ed4-fokachcha"
+     }
+   ↓
+4. Receive: { bill_id: "4c0275df-6c8d-4f1a-b25b-b2db4b831707", payUrl: "..." }
+   ↓
+5. Redirect to: payUrl (Payture payment terminal)
+   ↓
+6. User completes payment
+   ↓
+7. Payture redirects to: https://shop.ru-kitchen.ru/bills/4c0275df-6c8d-4f1a-b25b-b2db4b831707
+   ↓
+8. Call billStatus("4c0275df-6c8d-4f1a-b25b-b2db4b831707")
+   ↓
+9. If status is "PAID" or "DONE":
+   - Show success message
+   - Redirect back to: https://ru-kitchen.ru/old/baking/ck4jrtawdA3Ed4-fokachcha
+   - User now has access to the recipe
+```
+
+---
+
+## Important Notes
+
+1. **Fixed Subscription ID**: Always use `"a295e987-28c6-4b79-b1f7-5245d95b91d6"` for recipe access purchases
+
+2. **Redirect URL Format**: The `redirect_url` parameter should be `https://shop.ru-kitchen.ru/bills/` - the bill_id will be appended automatically
+
+3. **Extended Data**: Store both `pageId` and `redirectUrl` in the extended object:
+    - `pageId`: Used to grant access to the specific recipe page
+    - `redirectUrl`: Used to redirect user back after successful payment
+
+4. **Status Polling**: On the confirmation page, poll the status every 3 seconds if it's still PENDING
+
+5. **Error Handling**: Always handle errors gracefully and show user-friendly messages in Russian
+
+6. **Page Access**: After successful payment, the system automatically grants the user access to the page specified in `extended.pageId`