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.premiumsinteger

Premiums for policies created in the period.

totals.refundsinteger

Premiums refunded for cancellations in the period (negative).

totals.commissioninteger

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

totals.store_creditinteger

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

totals.netinteger

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

settlementenum

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

List statements

GETpartner-api.getphew.com/v1/statementssettlements: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

GETpartner-api.getphew.com/v1/statements/{id}/linessettlements: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.