Changelog
All notable changes to the current API will be documented in this file. To learn about API versioning, see Common topics: API Lifecycle.
Version 2 compared to version 1โ
- The information in the
/ledgertransactions
endpoint has been split into different endpoints to list changes to balance (funds
) and per-transaction fees charged by Vipps MobilePay AS (fees
). This split is primarily done to make it more natural in the API to provide fee specifications also for merchants that receive gross settlements. - Instead of query parameters to
/ledgertransactions
implying different modes of using the endpoint, we provide different endpoints for different ways of fetching/synchronizing the data. - In total,
GET:/ledgertransactions
is replaced by the following:GET:/ledgers/{ledgerId}/funds/feed
GET:/ledgers/{ledgerId}/funds/dates/{ledgerDate}
GET:/ledgers/{ledgerId}/fees/feed
GET:/ledgers/{ledgerId}/fees/dates/{ledgerDate}
- While all the above endpoints are very similar to the old
/ledgertransactions
endpoint, there are some cosmetic changes:transactionId
has been renamedpspReference
to be consistent with the ePayment API.orderId
has been renamedreference
to be consistent with the ePayment API.ledgerAmount
is simplyamount
transactionType
has been renamed toentryType
- The
payout
type has been renamed toscheduled-for-payout
. Please consult the full list of entry types in the reference.
- The
- The
grossAmount
andfee
columns are removed from this endpoint and replaced with:- Detailed information about fees available on the
/fees
endpoint; both for cases where fees are retained ("net settlements") and not ("gross settlements") - For net settlements, an adjustment of the ledger balance is included as a sum row.
There is typically once such row per day, although details of this will vary according to when
Vipps MobilePay legally collects the fees (
entryType
offees-retained
).
- Detailed information about fees available on the
- The
inPayout
argument to/ledgertransactions
has no equivalent in the new API. We recommend to instead fetch data per date.- We may add the feature back if there is enough popular demand for it,
in that case as a separate
payouts
path alongsidefeed
anddates
.
- We may add the feature back if there is enough popular demand for it,
in that case as a separate
- The
sincePayout
argument to/ledgertransactions
has been removed and appears to be unused.
Historyโ
- September 2023: Launched final non-Beta version of the Report API, which is named
report/v2
. Version 1 is deprecated. - November 2022: Launched Beta of Report API,
report/v1
.