Så här konfigurerar du en avancerad Stripe webhook-installation

Det här dokumentet innehåller avancerade installationsalternativ som inte behövs för de flesta webbplatser.
Se vår dokumentation för standard-webhooks för grundläggande installation.

Webhooks gör det möjligt för Stripe att skicka meddelanden tillbaka till din WordPress-webbplats. Installation av webhooks krävs för viss funktionalitet i WP Simple Pay, såsom att skicka e-postmeddelanden, skapa avbetalningsplaner, tillåta kunder att uppdatera sina prenumerationsbetalningsuppgifter och använda integrationen med AffiliateWP.

Om en webhook missas

En webhook som aldrig kommer fram är inte längre permanent. En gång i timmen kontrollerar WP Simple Pay Stripe efter poster som den kan ha missat och synkroniserar dem: utcheckningar som slutfördes medan kunden aldrig återvände till din webbplats, betalningar som lyckades eller avbröts senare, och återbetalningar eller tvister som tillämpades direkt från Stripe Dashboard. En betalning som tidigare stod som en väntande platshållare löser sig själv.

Du bör fortfarande konfigurera webhooks korrekt, eftersom den timliga kontrollen körs efter händelsen och allt som är beroende av en omedelbar respons (e-postmeddelanden, avbetalningsplaner) behöver live-händelsen. Men du behöver inte jaga ner en enskild tappad händelse manuellt. Du kan bekräfta resultatet på Betalningsformulär > Transaktioner — se Hur man använder transaktionssidan.

Lägga till webhook-slutpunkt

För att lägga till lämpliga webhook-slutpunkter, gå till Utvecklare → Webhooks i din Stripe Dashboard.

Klicka på Lägg till slutpunkt, lägg sedan till URL:en som finns i WP Simple Pay → Inställningar → Stripe → Webhooks.

Du behöver nu lägga till de specifika händelserna att lyssna på genom att klicka på knappen märkt +Välj händelser. Efter att ha gjort det kan du kopiera och klistra in varje händelse som listas nedan i sökrutan för Välj händelser att skicka → Sök händelser .

Efter att ha sökt på varje term, klicka på kryssrutan för att lägga till den och sök efter ytterligare termer. Klicka inte på Lägg till händelser förrän du har markerat alla händelser som listas nedan:

• **laddning.misslyckades**
• avgift.återbetalas
• charge.succeeded
• checkout.session.completed
• invoice.payment_succeeded
• invoice.upcoming
• payment_intent.processing
• payment_intent.succeeded
• customer.subscription.deleted
• customer.subscription.updated
• charge.dispute.created
• charge.dispute.closed

Detaljer om funktionaliteten för var och en av dessa händelser visas längst ner i detta dokument.

När du är klar med att lägga till händelser, klicka på Lägg till slutpunkt för att slutföra processen. Efter att du har lagt till slutpunkten bör du se den nya URL:en listad i webhook-inställningarna.

Konfigurera webhook-signeringshemlighet

Stripe kan signera webhook-händelser som den skickar till dina slutpunkter för ökad säkerhet, och vi rekommenderar starkt att du konfigurerar detta.

För att göra detta, hämta din slutpunkts hemlighet från din instrumentpanels webhook-inställningar. Välj en slutpunkt som du vill hämta hemligheten för, klicka sedan på knappen Visa.

Kopiera sedan signeringshemligheten från Stripe Dashboard, gå tillbaka till fliken Stripe Setup i din WP-admin, klistra sedan in den i textrutan Endpoint Secret för det aktuella betalningsläget.

Dina webhooks är nu installerade och säkra.

För närvarande använder WP Simple Pay följande händelser:

Beskrivningar av händelsetyper

invoice.payment_succeeded

• Används för att öka avbetalningsplaner och skicka e-postmeddelanden för “Betalningsbekräftelse” och “Betalningsmeddelande” e-postmeddelanden för prenumerationer.
• Exponerar åtgärden simpay_webhook_subscription_created för ytterligare bearbetning efter en lyckad prenumeration.

**payment_intent.succeeded
**

• Skickar e-postmeddelandena “Betalningsbekräftelse” och “Betalningsmeddelande” e-postmeddelanden för engångsbetalningar.
• Exponerar åtgärden simpay_webhook_payment_intent_succeeded för ytterligare bearbetning efter lyckad betalning

**charge.succeeded
**

• Skickar e-postmeddelandena “Betalningsbekräftelse” och “Betalningsmeddelande” e-postmeddelanden för engångsbetalningar med ACH Debit.
• Exponerar åtgärden simpay_webhook_charge_succeeded för ytterligare bearbetning efter lyckad betalning

invoice.upcoming

• Skickar e-postpåminnelsen “Kommande faktura” e-postmeddelande för uppdatering av en betalningsmetod. Läs mer

checkout.session.completed

• Används för att ta bort genererade övergivna Stripe Checkout-poster.
• Exponerar åtgärden simpay_webhook_checkout_session_completed för ytterligare bearbetning vid behov.

plan.uppdaterad

• Används för att säkerställa att listan över prenumerationsplaner är uppdaterad när konfigurationsalternativen för prenumerationer ställs in.

**laddning.misslyckades**

• Exponerar åtgärden simpay_webhook_charge_failed för ytterligare bearbetning efter att en debitering misslyckats.

charge.dispute.created

• Markerar den matchande betalningen som omtvistad medan en tvist kvarstår, så den visas under vyn Omtvistade på transaktionssidan. Kräver WP Simple Pay Pro.
• Exponerar åtgärden simpay_webhook_charge_dispute_created för ytterligare bearbetning när en tvist öppnas.

charge.dispute.closed

• Återställer betalningens tidigare status när tvisten avslutas till din fördel, oavsett om den vanns, avslutades som en utredning eller förhindrades av Stripe. En betalning som delvis återbetalades återgår till delvis återbetalad snarare än helt enkelt lyckad. En förlorad tvist förblir omtvistad, eftersom pengarna verkligen har dragits tillbaka. Kräver WP Simple Pay Pro.
• Exponerar åtgärden simpay_webhook_charge_dispute_closed för ytterligare bearbetning när en tvist avslutas.