PayPal

Vad du behöver

Varför vi ber om varje fält

Client ID

Identifierar din PayPal-app vid API-anrop. Det fungerar endast när det paras med Client secret.

Client secret

Den privata halvan av API-autentisering. Tillsammans med Client ID låter den oss skapa beställningen, så att betalningen körs genom ditt konto.

Webhook ID

Så här bekräftar vi att en webhook genuint är från PayPal: PayPal identifierar varje webhook med ett ID, och vi använder det för att fråga PayPal direkt om ett givet meddelande är äkta. Det hindrar någon från att förfalska en "paid"-händelse.

Success and Cancel URL

Vanliga inställningar: dit köparen landar efter att ha betalat eller backat ur. Inte hemliga.

Sätt upp

1. Öppna PayPal Developer-instrumentpanelen

   Logga in på developer.paypal.com. PayPal ger dig en gratis Sandbox med falska företags- och köparkonton, så att du kan testa utan att flytta riktiga pengar. Den här guiden går igenom Sandbox; Live-flödet är identiskt, bara byt Sandbox / Live-omkopplaren (uppe till vänster) och använd ett PayPal for Business-konto. Från instrumentpanelen öppnar du Apps & Credentials.

   ⤢
2. Skapa en app

   På sidan API Credentials bekräftar du att Sandbox-omkopplaren är vald och klickar sedan på Create App (uppe till höger).

   ⤢
3. Namnge den och välj Merchant

   Ange ett App Name (till exempel "Coin Moebius"), lämna Type på Merchant, välj ditt sandbox-företagskonto och klicka på Create App.

   ⤢
4. Kopiera ditt Client ID och din Client secret

   PayPal öppnar din nya app. Kopiera Client ID och visa och kopiera Secret key. (Du kan också kopiera båda från raden Default Application i listan API Credentials.) Lägg dem åt sidan.

   ⤢

   ⤢

   Client secret är hemlig, behandla den som ett lösenord. Sandbox-appen och live-appen har var sitt par, så blanda inte dem.

5. Lägg till en webhook

   Scrolla ned på appsidan till avsnittet Sandbox Webhooks och klicka på Add Webhook. I fältet Webhook URL klistrar du in din projekts PayPal-webhookadress (nedan). Välj sedan de händelser Coin Moebius lyssnar på och klicka på Spara.

   • Engångsbetalningar: CHECKOUT.ORDER.APPROVED, PAYMENT.CAPTURE.COMPLETED, PAYMENT.CAPTURE.DENIED, PAYMENT.CAPTURE.DECLINED, PAYMENT.CAPTURE.REFUNDED, PAYMENT.CAPTURE.REVERSED, CUSTOMER.DISPUTE.CREATED.
   • Prenumerationer (bara om du säljer dem): BILLING.SUBSCRIPTION.ACTIVATED, BILLING.SUBSCRIPTION.UPDATED, BILLING.SUBSCRIPTION.CANCELLED, BILLING.SUBSCRIPTION.PAYMENT.FAILED, PAYMENT.SALE.COMPLETED. Om du inte fakturerar på återkommande basis hoppar du över dessa.
   • Har du bråttom? Att välja All Events (jokertecknet högst upp) fungerar också, vi ignorerar allt vi inte använder.

   https://api.coinmoebius.com/webhook/paypal/<your project id>

   ⤢

   Ditt projekt-id finns under projektnamnet i Coin Moebius-instrumentpanelen; infoga det i adressen ovan. Det anslutna leverantörskortet (sista steget) visar samma URL som referens.

6. Kopiera Webhook ID

   Din webhook visas nu i listan Sandbox Webhooks. Kopiera det Webhook ID som visas bredvid den. Det är så Coin Moebius ber PayPal bekräfta att varje webhook är äkta. Registrera en separat webhook i sandbox och i live.

   ⤢
7. Tillbaka i Coin Moebius: Lägg till leverantör → PayPal

   Öppna fliken Leverantörer i ditt projekt, klicka på Lägg till leverantör, välj Anslut en tjänst och välj PayPal. Ange din Success URL och Cancel URL. Testar du med sandbox-uppgifter? Använd fliken Test (valfritt) och klistra in ditt Client ID, din Client secret och ditt Webhook ID där och klicka sedan på Spara. Går du direkt till live? Använd Live-fliken. Test-gruppen är allt-eller-inget: alla tre fält, eller inget.

   ⤢
8. Du är ansluten

   PayPal visas nu på fliken Leverantörer med datumet det anslöts (märkt TEST när du använde sandbox-uppgifter). Kortet visar samma webhook-URL som du klistrade in i PayPal, plus Redigera och Koppla från.

   ⤢
9. Testa med en sandbox-köpare

   För att betala genom en testutcheckning behöver du dina sandbox-köparinloggningsuppgifter. I PayPal öppnar du Testing Tools → Sandbox Accounts för att se dina falska Business- och Personal-konton.

   ⤢
10. Hämta köparens inloggningsuppgifter

    Öppna Personal-kontot (köparen) för att se dess Inloggningsinformation: sandbox-URL:en, e-postadressen och lösenordet. Logga in på sandbox.paypal.com med dessa när en testutcheckning ber dig betala. Inga riktiga pengar rör sig.

    ⤢

Efter att du anslutit

Kör en testbetalning innan du går live:

1. Skapa en produkt och ställ in dess Environment till Testing. Det kör produkten på dina sandbox-uppgifter, så att du kan lägga en hel beställning utan att flytta pengar. (Om du hoppade över sandbox-uppsättningen faller en Testing-produkt tillbaka till live, så lägg till den först.)
2. Placera köpknappen på en sida (en lokal HTML-fil fungerar) som pekar mot ditt projekt.
3. Slutför checkouten genom att betala med ditt sandbox-köparkonto.
4. Öppna Transaktioner-fliken. En ny rad dyker upp, märkt Testing. När dess status når succeeded fungerar både dina uppgifter och din webhook från början till slut.

Byt produktens Environment till Live när du är redo för riktiga betalningar.

Felsökning

Börja med Verify. I instrumentpanelen, klicka på Verify (eller Verify test credentials för sandbox) för att kontrollera dina klientuppgifter.

Verify misslyckas.

Kopiera om Client ID och Client secret. Sandbox-appen och live-appen har olika par, så blanda inte dem.

Betalningen slutförs men beställningen förblir väntande.

Webhook ID måste komma från samma app och miljö som dina klientuppgifter. Live-uppgifter behöver live webhook-id. Bekräfta att webhook-URL:en matchar.

Bekräfta det från början till slut.

PayPal Developer Dashboard → Webhooks Simulator: skicka en exempelhändelse till din webhook-URL, och se sedan beställningen uppdateras.

Bra att veta

Rotera hemligheter. Generera en ny client secret när som helst, klistra sedan in den. Hemliga fält förblir tomma vid redigering.

Frågor? Join our Discord