Skip to content

Webhooks ​

En webhook skickar ett meddelande till ditt eget system när en kund betalar eller får en återbetalning. Du kan använda den för att synka betalningar med din bokföring, ett kalkylark, Zapier, Make eller din egen kod.

Kom igång ​

Webhooks går inte att slå på i appen ännu. Kontakta support för att ställa in, ändra eller ta bort dem. Berätta:

  • Vilken URL webhooks ska skickas till. Den måste börja med https://
  • Vilka händelser du vill ha: payment.succeeded, payment.refunded eller båda

Du får en hemlig nyckel som börjar med whsec_. Använd den för att kontrollera att webhooks kommer från Peach. Dela inte nyckeln med någon.

Händelser ​

  • payment.succeeded: en kund betalade med kort, Swish, Klarna eller en annan betalmetod. Det gäller även medlemskap, också varje förnyelse.
  • payment.refunded: en kund fick en återbetalning, hela eller en del av beloppet.

Bokningar som inte betalas med en betalmetod skickar ingen webhook. Till exempel en bokning med klippkort, ett medlemskap eller en gratis bokning.

Exempel ​

json
{
  "id": "Xb2kP9_Jq81sLm_succeeded",
  "type": "payment.succeeded",
  "version": 1,
  "created": "2026-11-16T09:12:44.512Z",
  "data": {
    "id": "Xb2kP9",
    "created": "2026-11-16T09:12:41.000Z",
    "currency": "SEK",
    "amount": "250.00",
    "refundedAmount": "0.00",
    "refunded": false,
    "lineItems": [
      {
        "id": "li_7Hq2",
        "type": "activity",
        "itemId": "c8Kd2",
        "description": "Morgonyoga",
        "quantity": 1,
        "amount": "250.00",
        "refundedAmount": "0.00",
        "refunded": false,
        "taxRateId": "tax_SE_6"
      }
    ],
    "customer": {
      "id": "u_29Fk",
      "name": "Alex Andersson",
      "email": "alex@example.com",
      "phoneNumber": null
    }
  }
}

Fält ​

  • id: webhookens id. Det är samma om vi skickar samma webhook igen.
  • type: payment.succeeded eller payment.refunded.
  • version: webhookens format. Det ändras bara om vi tar bort eller byter namn på ett fält.
  • created: när händelsen inträffade.
  • data.created: när kunden betalade.
  • amount och refundedAmount: text med punkt och utan tusentalsavgränsare, till exempel "1000000.00". refundedAmount är det totala beloppet som har återbetalats hittills.
  • refunded: true när betalningen, eller raden, är helt återbetald.
  • currency: till exempel SEK eller EUR.
  • lineItems[].type: activity, product, loyaltyCard (klippkort), membership (medlemskap) eller paymentRequest (betalningsförfrågan).
  • lineItems[].itemId: id för aktiviteten, produkten, klippkortet eller medlemskapet. För en aktivitet är sidan https://peach.nu/activities/{itemId}.
  • lineItems[].taxRateId: momssatsen, till exempel tax_SE_25 för 25 % moms.
  • customer: null om betalningen inte har en kund med namn och e-post, till exempel en betalning med Tap to Pay.

Vi kan lägga till nya fält, händelser och radtyper utan en ny version. Låt ditt system ignorera det som det inte känner till.

Kontrollera signaturen ​

Varje webhook har rubrikerna webhook-id, webhook-timestamp och webhook-signature. De följer formatet Standard Webhooks. Använd ett bibliotek för ditt språk för att kontrollera signaturen med din nyckel, till exempel standardwebhooks.

Svar och nya försök ​

  • Svara med en statuskod 200–299 inom 15 sekunder.
  • Om ditt system inte svarar försöker vi igen 7 gånger under ungefär 2 timmar.
  • Ditt system kan få samma webhook mer än en gång. Använd id för att hitta dubbletter.
  • Webhooks kan komma i en annan ordning än händelserna inträffade. Varje webhook innehåller hela betalningen, så du kan spara den senaste versionen.

Bra att veta ​

  • En delvis återbetalning skickar också payment.refunded. refundedAmount visar det totala beloppet som har återbetalats.
  • Kalkylark med svenska inställningar kan läsa "250.00" som text. Ändra decimaltecknet vid importen om du behöver det.