Settlements

Phew issues a settlement statement for each merchant at the start of every month, covering the previous calendar month. Partners also get a statement for their own commission. A settlement.statement.created event is sent when a statement is ready.

The statement object

The figures below are illustrative. Commission rates are set in your merchant or partner agreement.

{
  "id": "stm_01JDC8M0P2R4T6V8X0Z2B4D6F8",
  "object": "settlement_statement",
  "merchant": "mer_01JD7Z4K2Q8V6N3R5T7W9Y1A3C",
  "period": { "from": "2026-10-01", "to": "2026-10-31" },
  "currency": "NOK",
  "totals": {
    "premiums": 4182300,
    "refunds": -239200,
    "commission": 788620,
    "store_credit": 64900,
    "net": -3089580
  },
  "settlement": "merchant_pays",
  "due_date": "2026-11-20",
  "lines_url": "https://partner-api.getphew.com/v1/statements/stm_01JDC8.../lines",
  "created_at": "2026-11-01T06:00:00Z"
}

totals.premiums integer

Premiums for policies created in the period.

totals.refunds integer

Premiums refunded for cancellations in the period (negative).

totals.commission integer

Commission earned on the period’s premiums net of refunds.

totals.store_credit integer

Store credit you issued for resolved claims, which Phew reimburses.

totals.net integer

The amount to settle. Negative means the merchant pays Phew; positive means Phew pays the merchant.

settlement enum

merchant_pays, phew_pays or split_at_payment (premiums were already routed to Phew, so only commission and store credit are settled).

List statements

GET partner-api.getphew.com/v1/statements settlements:read

Filter with merchant and period (YYYY-MM); paginate with limit and starting_after. Merchants using the Checkout API can call the same endpoint on api.getphew.com for their own statements.

Statement lines

GET partner-api.getphew.com/v1/statements/{id}/lines settlements:read

One line per premium, refund and store credit, with the policy ID, your order reference and, for split settlement, the payment reference. Add Accept: text/csv to download the lines as CSV for your finance system.