Så här konfigurerar du din webbplats för att acceptera webhooks från Stripe

Webhooks tillåter Stripe att skicka meddelanden tillbaka till din WordPress-webbplats. Konfigurering av webhooks är nödvändigt för viss funktionalitet i WP Simple Pay, såsom att skicka e-postmeddelanden, att skapa avbetalningsplaner, att låta kunder uppdatera sina prenumerationsbetalningsuppgifter och att använda dess integration med AffiliateWP.

WP Simple Pay försöker skapa webhook-slutpunkter automatiskt. I de flesta fall kommer manuell konfiguration, som visas nedan, inte att vara nödvändig.

Lägg till en slutpunkt i Stripe

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.

Aktivera inte Lyssna på händelser på anslutna konton eftersom detta kommer att bryta WP Simple Pays webhook-funktionalitet.

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:

• payment_intent.processing
• payment_intent.succeeded
• charge.failed
• charge.refunded
• charge.succeeded
• checkout.session.completed
• customer.subscription.deleted
• customer.subscription.updated
• invoice.payment_succeeded
• invoice.upcoming

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 den tillagda slutpunkten som du vill hämta hemligheten för, klicka sedan på knappen Visa .

Kopiera sedan signeringshemligheten från Stripe-instrumentpanelen, gå tillbaka till WP Simple Pay → Inställningar → Stripe → Webhooks i din WordPress-admin, klistra sedan in den i textrutan Slutpunktens hemlighet för det aktuella betalningsläget.

Upprepa i testläge

En webhook-slutpunkt måste också skapas i testläge. Växla omkopplaren Testläge längst upp till höger på Stripe-instrumentpanelen och upprepa stegen ovan.

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 simpay_webhook_subscription_created åtgärden för ytterligare bearbetning efter en lyckad prenumerationsskapande.
• Exponerar simpay_webhook_invoice_payment_succeeded åtgärden för ytterligare bearbetning efter att en faktura har behandlats.

<?php
add_action(
	'simpay_webhook_subscription_created',
	/**
	 * Fires when a subscription is created in Stripe.
	 * 
	 * @param \SimplePay\Vendor\Stripe\Event        $event Stripe webhook event.
	 * @param \SimplePay\Vendor\Stripe\Subscription $subscription Stripe Subscription.
	 */
	function( $event, $subscription ) {
		// Do something.
	},
	10,
	2
);

<?php
add_action(
	'simpay_webhook_invoice_payment_succeeded',
	/**
	 * Fires when a subscription invoice payment has succeeded.
	 * Does not fire for the subscription creation (first) invoice.
	 * 
	 * @param \SimplePay\Vendor\Stripe\Event        $event Stripe webhook event.
	 * @param \SimplePay\Vendor\Stripe\Invoice      $invoice Stripe Invoice object.
	 * @param \SimplePay\Vendor\Stripe\Subscription $subscription Stripe Subscription object.
	 */
	function( $event, $invoice, $subscription ) {
		// Do something.
	},
	10,
	3
);

Lär dig hur du lägger till anpassad kod →

payment_intent.succeeded

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

<?php
add_action(
	'simpay_webhook_payment_intent_succeeded',
	/**
	 * Fires when a one-time payment has succeeded.
	 * 
	 * @param \SimplePay\Vendor\Stripe\Event         $event Stripe webhook event.
	 * @param \SimplePay\Vendor\Stripe\PaymentIntent $paymentintent Stripe PaymentIntent.
	 */
	function( $event, $paymentintent ) {
		// Do something.
	},
	10,
	2
);

Lär dig hur du lägger till anpassad kod →

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 simpay_webhook_checkout_session_completed åtgärden för ytterligare bearbetning vid behov.

charge.succeeded

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

charge.failed

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

Vanliga frågor

Krävs webhooks?

Webhooks krävs inte för att behandla betalningar, och när en webhook misslyckas innebär det inte att en betalning har misslyckats att behandlas. Webhooks används dock för att driva funktioner som bedrägeriupptäckt, e-postkvitton, påminnelser om kommande fakturor och hantering av avbetalningsplaner.

Webhooks krävs för att använda e-postverifiering när bedrägeri upptäcks.

Även om du inte använder dessa funktioner för närvarande rekommenderas det starkt att du ser till att du har konfigurerat webhook-slutpunkten korrekt för att undvika förvirring om du bestämmer dig för att aktivera dessa funktioner i framtiden, eller om WP Simple Pay kräver dessa funktioner för framtida funktioner.

Varför ser jag "WP Simple Pay kanske inte fungerar korrekt."

WP Simple Pay försöker varna dig för möjlig felkonfiguration eller fel i webhook-slutpunkten för att undvika avbrott i funktioner som använder webhook-funktionalitet (e-postmeddelanden, avbetalningsplaner, etc.). Om WP Simple Pay inte kan verifiera en förväntad webhook-händelse kommer du att se en meddelandebubbla i plugininställningarna och felmeddelandet "WP Simple Pay kanske inte fungerar korrekt."

Hur åtgärdar jag en felkonfigurerad webhook-slutpunkt?

För att åtgärda en möjlig felkonfiguration av webhook-slutpunkten, besök Utvecklare → Webhooks i ditt Stripe-instrumentpanel (om du är i testläge, visa dina testläge-slutpunkter).

Under Hostade slutpunkter bör du se en post som innehåller WP Simple Pay webhook-händelsemottagare: wp-json/wpsp/v1/webhook-receiver. Om du inte ser denna slutpunkt, vänligen slutför konfigurationsstegen som beskrivs i början av den här artikeln.

Klicka på WP Simple Pay slutpunkts-URL för att visa slutpunktens konfiguration. Här hittar du en lista över webhook-händelser som har skickats till slutpunkten.

Klicka på fliken Misslyckade för att lista alla händelser som har misslyckats.

Om du har misslyckade webhook-händelser, kommer att välja en av posterna att avslöja svaret som mottagits från slutpunkts-URL:en. Detta svar innehåller ofta information om varför slutpunkten misslyckades med att bearbeta händelsen i avsnittet Svar.

Kunde inte ansluta till fjärrvärd

Stripe kunde inte kommunicera med din server. Kontrollera att din webbserver svarar på förfrågningar, och specifikt kan svara på alla Stripes fullständigt kvalificerade domännamn och IP-adresser.

Inga signaturer hittades som matchade den förväntade signaturen för nyttolasten

Stripe kunde inte verifiera webhook-händelsedata med hjälp av signeringshemligheterna som anges i WP Simple Pay → Inställningar → Stripe → Webhooks. Medan du visar din webhook-slutpunkt, klicka på Visa under Signeringshemlighet och uppdatera dina signeringshemlighetsinställningar i WP Simple Pay för varje betalningsläge.

404 FEL <!DOCTYPE html>

Webhook-slutpunktens URL är felaktig och pekar på en 404-sida som inte hittades. Besök WP Simple Pay → Inställningar → Stripe → Webhooks för att hitta rätt värde för din webhook-slutpunkts-URL och uppdatera slutpunkten i Stripe.

Jag har verifierat mina slutpunktsinställningar, varför ser jag fortfarande ett fel?

WP Simple Pay är avsiktligt överkänsligt för möjliga felkonfigurationer för att säkerställa att ett verkligt fel inte går obemärkt förbi. Det är dock fortfarande möjligt att få falska positiva notiser om en felkonfigurerad webhook-händelse. Detta kan inträffa om det finns en längre fördröjning än genomsnittet i att Stripe skickar händelsedata, eller i vissa fall av Stripe Checkout där betalningssidan utanför webbplatsen överges.

Om du har verifierat att det inte finns några misslyckade webhook-slutpunktshändelser vid din slutpunkt då kan du inaktivera konfigurationsnotisen genom att följa stegen nedan.

Kan jag inaktivera webhook-konfigurationsnotiser?

Som nämnts tidigare rekommenderas det starkt att korrekt konfigurera och hålla din webhook-slutpunkt aktiverad. Men på egen risk, om du inte vill bli varnad om några potentiella felkonfigurationer eller felaktigt mottagna händelser kan du permanent avvisa notisen i WP Simple Pay → Inställningar → Stripe → Webhooks genom att klicka på Visa inte igen.