Referenca App Manifest
Referenca App Manifest
Datoteka stripe-app.json je konfiguracijska datoteka vašo Stripe App. Definira identiteto aplikacije, dovoljenja, viewporte UI, webhook endpoints in varnostne politike.
Popolna shema
{ "id": "com.your-company.app-name", "version": "1.0.0", "name": "Ime vaše aplikacije", "icon": "./assets/icon.png", "permissions": [], "app_backend": { "webhooks": [] }, "ui_extension": { "views": [], "actions": [], "content_security_policy": {} }, "post_install_action": { "type": "external", "url": "https://your-app.com/stripe/onboarding" }}Referenca polj
Polja identitete
| Polje | Tip | Zahtevano | Opis |
|---|---|---|---|
id | string | Da | Edinstveni identifikator v obliki com.company.app. Ni mogoče spremeniti po objavi |
version | string | Da | Semantična verzija (npr. 1.0.0). Vsaka naložitev zahteva novo verzijo |
name | string | Da | Prikazno ime vaše aplikacije (max 50 znakov) |
icon | string | Da | Relativna pot do ikone PNG 512×512 px |
Polje dovoljenj
Vsak element dovoljenja zahteva namen za pregled:
"permissions": [ { "permission": "customer_read", "purpose": "Display customer data in sync panel" }, { "permission": "payment_intents_read", "purpose": "Show payment history for campaign targeting" }]Oglejte Referenco dovoljenj za popoln seznam.
Konfiguracija app_backend
"app_backend": { "webhooks": [ { "endpoint_uri": "https://api.tajo.io/stripe/webhooks", "filter_types": [ "customer.created", "customer.updated", "payment_intent.succeeded", "subscription.created" ] } ]}Konfiguracija ui_extension
"ui_extension": { "views": [ { "viewport": "stripe.dashboard.customer.detail", "component": "CustomerBrevoView" }, { "viewport": "stripe.dashboard.payment.detail", "component": "PaymentTrackingView" } ], "actions": [ { "id": "sync-to-brevo", "title": "Sync to Brevo", "description": "Sync this customer to Brevo CRM" } ], "content_security_policy": { "connect-src": [ "https://api.tajo.io", "https://api.brevo.com" ], "image-src": ["https://assets.tajo.io"], "purpose": "Connect to Tajo and Brevo APIs for data sync" }}Konfiguracija post_install_action
"post_install_action": { "type": "external", "url": "https://app.tajo.io/stripe/connect"}| Tip | Opis |
|---|---|
external | Preusmeri na zunanji URL po namestitvi |
view | Odpre določen viewport vaše aplikacije |
Celoten primer za integracijo Tajo Brevo
{ "id": "com.tajo.brevo-integration", "version": "1.0.0", "name": "Tajo Brevo Integration", "icon": "./assets/icon.png", "permissions": [ { "permission": "customer_read", "purpose": "Sync customer profiles to Brevo contacts" }, { "permission": "payment_intents_read", "purpose": "Track payment events for Brevo automation triggers" }, { "permission": "subscriptions_read", "purpose": "Sync subscription data for lifecycle campaigns" } ], "app_backend": { "webhooks": [ { "endpoint_uri": "https://api.tajo.io/stripe/webhooks", "filter_types": [ "customer.created", "customer.updated", "payment_intent.succeeded", "payment_intent.payment_failed", "customer.subscription.created", "customer.subscription.deleted", "charge.refunded" ] } ] }, "ui_extension": { "views": [ { "viewport": "stripe.dashboard.customer.detail", "component": "CustomerBrevoSync" } ], "actions": [], "content_security_policy": { "connect-src": ["https://api.tajo.io"], "purpose": "Connect to Tajo API for Brevo synchronization" } }, "post_install_action": { "type": "external", "url": "https://app.tajo.io/stripe/onboarding" }}Naslednji koraki
- Referenca dovoljenj, Izberite prava dovoljenja
- Referenca viewportov, Razpoložljiva mesta v Dashboardu
- Dejanja po namestitvi, Konfigurirajte tok vklopitve