Referenca App Manifest
Referenca App Manifest
Fajl stripe-app.json je konfiguracioni fajl vaše Stripe App. Definiše identitet aplikacije, dozvole, UI viewporte, webhook endpointe i bezbednosne politike.
Potpuna šema
{ "id": "com.your-company.app-name", "version": "1.0.0", "name": "Naziv 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 polja
Polja identiteta
| Polje | Tip | Obavezno | Opis |
|---|---|---|---|
id | string | Da | Jedinstveni identifikator u obliku com.company.app. Ne može se menjati posle objavljivanja |
version | string | Da | Semantička verzija (npr. 1.0.0). Svako otpremanje zahteva novu verziju |
name | string | Da | Prikazno ime vaše aplikacije (maks. 50 znakova) |
icon | string | Da | Relativna putanja do 512×512 px PNG ikone |
Polje dozvola
Svaki element dozvole zahteva svrhu za pregled:
"permissions": [ { "permission": "customer_read", "purpose": "Display customer data in sync panel" }, { "permission": "payment_intents_read", "purpose": "Show payment history for campaign targeting" }]Pogledajte Referencu dozvola za potpunu listu.
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 | Preusmerava na spoljni URL posle instalacije |
view | Otvara određeni viewport vaše aplikacije |
Kompletan primer za Tajo Brevo integraciju
{ "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" }}Sledeći koraci
- Referenca dozvola, Odaberite prave dozvole
- Referenca viewport-a, Dostupna mesta u Dashboard-u
- Akcije posle instalacije, Konfigurišite tok onboardinga