---
title: Webhooks
description: Få ett meddelande till ditt eget system när en kund betalar eller får en återbetalning, till exempel för att synka betalningar med din bokföring.
order: 8
keywords:
  - webhook
  - webhooks
  - API
  - integration
  - Zapier
  - Make
  - bokföring
  - synka betalningar
lastUpdated: 2026-11-16
---

# 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](https://www.standardwebhooks.com). 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.
