docs: add full documentation for all functions in tienda/views.py

Agent-Logs-Url: https://github.com/dsaub/proyecto-final/sessions/49df17c8-213a-4e23-adfe-465a0104f6a3 Co-authored-by: dsaub <54474838+dsaub@users.noreply.github.com>
2026-04-09 10:35:28 +00:00
parent 47ea00c822
commit ed92991872
66 changed files with 2580 additions and 0 deletions
@@ -0,0 +1,34 @@
+# `stripe_config`
+
+**Archivo:** `tienda/views.py`  
+**URL:** `/tienda/stripe-config/`  
+**Tipo:** Vista pública (CSRF exento)  
+**Método HTTP:** `GET`  
+**Decorador:** `@csrf_exempt`
+
+## Descripción
+
+Endpoint de configuración de Stripe que expone la clave pública (`publishable key`) al frontend JavaScript. Es llamado por el cliente antes de iniciar una sesión de Stripe Checkout para obtener la clave necesaria para inicializar `stripe.js`.
+
+## Firma
+
+```python
+def stripe_config(request):
+```
+
+## Parámetros
+
+| Nombre    | Tipo          | Descripción           |
+|-----------|---------------|-----------------------|
+| `request` | `HttpRequest` | Petición HTTP de Django. |
+
+## Respuesta
+
+```json
+{
+  "publicKey": "pk_live_..."
+}
+```
+
+> [!CAUTION]
+> Esta vista está marcada con `@csrf_exempt`. Asegúrate de que solo expone la clave **pública** de Stripe, nunca la clave secreta.