Donationsflöden för insamlingssidor.

Insamlingsembeds är fristående donationsflöden för kampanjsidor, redaktionella sidor och säsongsgivande. De är skilda från Checkout: du bäddar in den upplevelse du behöver, och Octany sköter givarflödet bakom den.

§ 01.1 Upplevelser #

§ 01.2 Embed-snutt #

Alla insamlingsupplevelser har samma form: ett container-element och ett loader-skript. Query-parametrarna api, widget och valfria lang styr konfiguration och språk. Kör du WordPress lägger Octanys plugin in snutten åt dig.

1-click Swish

<div class="octany-swish-widget"></div>
<script
  type="module"
  src="https://give.octany.com/swish-v1/loader.js?api=https://app.octany.com/widget/{account}&widget={widget-id}&lang=sv"
></script>

Donation

<div class="octany-donate"></div>
<script
  type="module"
  src="https://give.octany.com/donate-v1/loader.js?api=https://app.octany.com/widget/{account}&widget={widget-id}&lang=sv"
></script>

Greeting

<div class="octany-greeting-widget"></div>
<script
  type="module"
  src="https://give.octany.com/greeting-v1/loader.js?api=https://app.octany.com/widget/{account}&widget={widget-id}&lang=sv"
></script>

§ 01.3 Attribution och referenser #

Donation och 1-click Swish registrerar var gåvan kom ifrån och, om du vill, ditt eget id för givaren. Båda fångas när gåvan skapas och följer sedan med: de syns på resulterande Order, på Subscription för en månadsgåva, och på alla webhooks för de resurserna.

UTM-parametrar

Loadern läser utm_source, utm_medium, utm_campaign, utm_content och utm_term från sidans URL när den startar — du behöver inte skicka med något själv. Länka till din insamlingssida med UTM-parametrar så attribueras gåvan till den trafikkällan. En månadsgåva behåller sin attribution på kommande förnyelseordrar.

Attributionen är first-touch: de värden som fångas först för en gåva ligger kvar, även om givaren ändrar sina uppgifter innan betalningen.

referenceId och referenceName

Lägg till referenceId och referenceName i loader-URL:en för att ta med ditt eget id för givaren in i Octany. De betyder samma sak som på en hostad checkout-URL: referenceId är id:t du matchar mot, referenceName är en läsbar etikett för vyerna i Octany. Båda är begränsade till 255 tecken.

<div class="octany-donate"></div>
<script
  type="module"
  src="https://give.octany.com/donate-v1/loader.js?api=https://app.octany.com/widget/{account}&widget={widget-id}&referenceId=member_42&referenceName=Anna%20Persson"
></script>

De läses från skript-URL:en, inte från sidans URL, så rendera snutten server-side med värdena för den inloggade supportern. En besökare kan alltså inte sätta en egen referens genom att ändra i adressfältet.

För att hitta prenumerationen i efterhand: fråga API:et med samma id, GET /subscriptions?filter[reference_id]=member_42.

§ 01.4 Givaruppgifter och villkor #

Vet din sida redan vem givaren är — en inloggad medlem, en supporter som klickar sig vidare från ditt eget system — så skicka med uppgifterna, då kommer formuläret ifyllt. Givaren kan fortfarande ändra allt.

<div class="octany-donate"
  data-donor-first-name="Anna"
  data-donor-last-name="Persson"
  data-donor-email="anna@example.com"
  data-donor-phone="0701234567"></div>

Samma värden fungerar som ?donor_* i sidans URL, för kampanjlänkar in till en sida du inte renderar per besökare: ?donor_first_name=Anna&donor_email=anna%40example.com. Finns båda vinner attributet — värdet din server renderade slår adressfältet.

Personnummer läses aldrig från URL:en. Query-strängar följer med i referrers, webbhistorik och analysverktyg, så just det värdet måste komma från din server-renderade markup. Okända nycklar ignoreras, och ett eget fält fylls bara i om embedden faktiskt visar det.

Villkor som din sida redan samlat in

Donation har ingen villkorsruta — samtycket ligger i själva gåvan, med villkorstexten under betalknappen. Har ditt eget flöde redan samlat in ett godkännande innan givaren nådde embedden, säg det och namnge villkoren du samlade in:

<div class="octany-donate" data-terms-accepted="member-terms-2026-08"></div>

Embedden utelämnar då sin egen villkorstext, och gåvan sparar det du skickade som samtyckets ursprung, vid sidan av tidpunkt, IP och user agent som redan sparas. Använd en stabil identifierare för den villkorsversion du samlade in, inte bara true — det är den texten posten kommer att säga om ett år.

Det här läses bara från attributet, aldrig från URL:en: det är ursprunget till en samtyckespost, inte en visningsinställning. Det ersätter inte heller Swish-medgivandet för månadsgåvor eller autogiromedgivandet — dem samlar betalleverantören in i flödet. Att dina villkor täcker gåvan är din bedömning att göra.

§ 01.5 Tema #

Temat ställs in per embed i Octany admin, under widgetens utseendeinställningar — färger, radie, skugga, typsnitt och knappstil. Resultatet levereras med embed-konfigurationen, så en ändring av temat slår igenom utan att du rör din sida.

Insamlingsupplevelserna renderas i en shadow root och sätter sina egna CSS-variabler där, så CSS-variabler du deklarerar på sidan läses inte. Styla gärna ytan runt omkring — men själva upplevelsen stylar du i Octany admin.

§ 01.6 Insamling eller Checkout — när väljer du vad? #

• Använd Insamling när själva den publika sidan är donationsupplevelsen.
• Använd Checkout när din app eller sajt behöver en hostad kassa-URL, varukorg eller JS-API.
• Använd Klassisk widget bara om du underhåller en befintlig klassisk integration.