Breytingaskrá

7. september 2026

Samsetningarafslættir (combo discounts): seljandi getur nú skilgreint í stjórnborðinu að vara fái sjálfvirkan afslátt (prósentu eða fasta upphæð) þegar viðskiptavinur er einnig með aðrar tilteknar vörur — hvort sem þær eru keyptar í sömu pöntun eða eru í öðrum virkum samningi. Afslátturinn er reiknaður sjálfkrafa á hverri innheimtu og fellur niður þegar viðskiptavinurinn hættir með skilyrðisvörurnar.
/api/v2/subscription-offer-quotes/, /api/v2/checkouts/ og checkout-sessions tilboð skila nú combo_discounts listanum með þeim samsetningarafsláttum sem gilda; subtotal_amount, tax_amount, total_amount og recurring_* upphæðir innihalda afsláttinn nú þegar. Tilboðsfyrirspurn (subscription-offer-quotes) tekur nú við valkvæðu customer til að taka tillit til annarra samninga viðskiptavinarins, óháð því hvort afsláttarkóði er sendur.

unit_amount_override (fast einingaverð á lið) er nú stutt í V2 vörubreytingum á virkum samningi: items/update, items/add og proration-preview á /api/v2/subscription-contracts/{id}/. Áður virkaði reiturinn aðeins við stofnun samnings. Í items/update heldur liðurinn núverandi fasta verði ef reitnum er sleppt, en skýrt null fjarlægir það svo liðurinn fer aftur á verð úr vörulista. Hlutfallslínur vegna slíkrar breytingar fá nýja proration_reason gildið unit_amount_changed.
Vörubreytingaslóðirnar (items/add, items/update, items/remove, proration-preview og skyldar aðgerðir) hafna nú óþekktum reitum og reitum sem viðkomandi operation styður ekki með 400 villu, í stað þess að hunsa þá þegjandi. Samþættingar sem sendu aukareiti á þessar slóðir þurfa að fjarlægja þá. items/update tekur nú eingöngu við operation gildinu update_item.
Swagger og skjölun uppfærð til samræmis; sjá Áskriftarsamningar V2.

Nýr endapunktur /api/subscriptions/{subscriptionId}/set_expiry/ sem leyfir að breyta gildistíma áskriftar.

Viðskiptavinir (/api/customers/) taka nú við og skila símanúmeri (phone) þegar þeir eru uppfærðir í gegnum API-ið og Swagger skjöluninni hefur verið uppfært til samræmis.

Nýr endapunktur fyrir færslur (Transactions) svo hægt sé að sækja lista yfir færslur og sía hann.

Hægt að setja id á færsluhirði þegar checkout er stofnað. Áður var eingöngu hægt að sækja ákveðinn færsluhirði með því að setja inn áskriftarleið.
Nú fylgir færsluhirðir með áskriftarleiðum

Nýr endapunktur /api/payments/{uuid}/refund/ sem leyfir að endurgreiða staka greiðslu.

Ný gildi á áskriftum sem gefa til kynna hvort áskrift sé komin í uppsögn, cancelled og cancel_date.
Lagað misræmi í Swagger skjölun miðað við raunveruleg svör frá vefþjónustunni.

Nýr endapunktur /api/webhooks/ sem leyfir að búa til og vinna með vefkróka sem senda tilkynningar um ýmsa atburði sem gerast í Áskeli.

Nýr endapunktur /api/hello/ sem staðfestir að vefþjónustan virkar og er hægt að nota til prófana.
amount og discount virka nú sem valkvæmar breytur þegar áskrift er bætt á viðskiptavin undir /api/customers/{reference}/subscriptions/add/

Skjölun í Swagger lagfærð. Bætt við GET á staka greiðslu á slóðinni https://askell.is/api/payments/{uuid}/.

Nú er hægt að takmarka úttakið sem listi yfir áskriftir skilar með því að setja breytuna ?type=light í URL. Við þetta er minna af upplýsingum um tengdan viðskiptavin og færslusögu sótt og hentar betur til að sækja stóran lista af áskriftum til að vinna með síðar og sækja meiri upplýsingar fyrir einstakar áskriftir ef þarf.

Nýr valmöguleiki þegar listi yfir áskriftir eða viðskiptavini er sóttur. Hægt er að setja breytuna ?page_size=100 í URL til að fá 100 færslur í einu. Við þetta breytist úttakið frá því að vera listi af færslum yfir í að vera listi af færslum í results, fjölda færslna í count og slóðir á næstu og fyrri síðu í next og previous. Hámarks stærð á síðu er 1000 færslur.