All notable changes to the API.

new Added in_store as a possible payment channel for payments in physical stores.

• POST /v1/sessions-profile
• POST /v1/sessions

new Added option for configurating the payment channel. See configuration.channel. The new option add support for in_app channel with appswitch deeplink URL (Vipps).

• POST /v1/sessions-profile
• POST /v1/sessions

new Add support for optional order.discount_lines when creating a new sessions.

• POST /v1/sessions-profile
• POST /v1/sessions

new Add support for updating a session

• PUT /v1/sessions/{session_id}
• POST /view@{session_id}@session@lock

total_income moved from applicant to top level for instabank.invoice and instabank.installment. The field is required, but there will be a grace period of two months before it is enforced. Deprecated applicant.total_income

• POST /v1/sessions/pay

new Add support for optional metadata when creating a new session.

• POST /v1/sessions-profile
• POST /v1/sessions

new Add support for optional merchant_reference_2 when creating a new session

• POST /v1/sessions-profile
• POST /v1/sessions

new Add support for delayed callback. You can enable the delay callback feature by including delay_callback=<seconds> query parameter in the callback_url

https://example.com/callback?delay_callback=30

new: Add support for overriding Netaxept gateway settings

• PUT /v1/admin/gateways/netaxept/override

new: Add terminal options for Netaxept creditcard payment. Enable use of Netaxept hosted checkout, and provided custom configuration.

new: Add support for Netaxept.

• GET /view/{session_id}/netaxept

new: Add support for overriding PayEx gateway settings

• PUT /v1/admin/gateways/payex/override

new: Include payment token in transaction details

• GET /v1/transactions/{id}?includes=card.payment_token

new Added option for using payment token for payex.creditcard payments to prefill payment details so the customer (payer) do not need to enter all these details for every purchase.

new Added option for generating payment token for payex.creditcard payments, see configuration.payex.creditcard. Use the new option to generate a payment token that can be used in future payments to prefill the details for the creditcard.

new Added instabank.postponement payment type.

new Added swish.swish payment type, direct integration with Swish.

change Add support for ON_HOLD transaction status. The new status is limited to Collector transactions, to signal that the processing of the transaction is not yet completed. The new status will be used in cases where Collector performs aditional controls before approving the payment.

new Add support for setting merchant_reference_2 to an existing transaction and search for transactions by merchant_reference_2.

• PUT /v1/transaction/{transction_id}
• GET /v1/transactions

new Add support for POST callback with the authorized transaction included in the request body. You can enable the POST callback feature by including method=POST query parameter in the callback_url

https://example.com/callback?method=POST

• POST /v1/sessions
• POST /v1/sessions-profile

new Add support for instabank.installment payment

changed: Removed error capture from list of valid error added to the redirect to the url.redirect_url. The error was used for payments with auto-capture enabled, and set in case where the auto capture failed. The merchant can assume the transaction will be captured automatically as soon as possible when creating a session with auto-capture enabled.

• POST /v1/sessions
• POST /v1/sessions-profile

changed: A callback (when url.callback_url is set) will now be sent as soon as possible after the transaction is AUTHORIZED. We will no longer wait until the transaction CAPTURED in case when auto-capture is enabled.

• POST /v1/sessions
• POST /v1/sessions-profile

change: Add support for creating session with Ingenico enabled

• POST /sessions-profile
• POST /sessions
• POST /admin/session/profiles

change: Add support for creating session with Ingenico enabled

• POST /sessions-profile
• POST /sessions
• POST /admin/session/profiles

new Add support for collector.invoice_b2b payment

new Add support for configuring Ingenico gateway

• PUT /admin/gateways/ingenico

new Add support for enabling Dintero-Signature header for all system-to-system request sent from Dintero to the merchant

• POST /v1/admin/signature

fix: Documentation for endpoint GET /v1/admin/api-keys. The resource returns a list of api-keys, not a single api-key.

new Add support for collector.installment payment

new Add support for putting merchant_terms_url in profile and session

• POST /v1/admin/session/profiles
• PUT /v1/admin/session/profiles/{profile_id}
• POST /v1/sessions
• POST /v1/sessions-profile

new Add support for overriding gateway settings

• PUT /v1/admin/gateways/vipps/override
• PUT /v1/admin/gateways/santander/override

new Add support for include_session query parameter

• POST /v1/sessions-profile
• POST /v1/sessions

new Add support for discount calculation on sessions. The discounts will be calculated when customer is identified

Extend the order and transaction items with new properties to support discount calculation of session:

• discount_lines
• gross_amount
• is_change
• eligible_for_discount

Support calculating and updating session with discount from:

• POST /v1/sessions-profile
• POST /v1/sessions

new Add store property to session.order and transaction. Adds support for including details about the sales location in the order

new Add shipping_option from session.order to to transaction

• GET /transactions
• GET /transactions/{id}

changed Minor changes to the shipping_option object(s) in sessions

• POST /v1/sessions
• GET /v1/sessions
• GET /v1/sessions/{session_id}
• GET /view/{session_id}/session

new Add an endpoint for abandon a checkout payment

• POST /view/{session_id}/session/abandon

changed: Express Checkout flow added to sessions

• POST /v1/sessions
• GET /v1/sessions
• GET /v1/sessions/{session_id}
• GET /view/{session_id}/session

new Update a an Express Checkout session order

• PUT /view/{session_id}/session

new: Extend Transaction with optional billing_address field.

new: Extend Transaction Event with correction field to handle correction of status after operations errors

changed: previously required fields are now optional for instabank.finance.

• mortgage_debt
• student_debt
• other_secured_debt

changed: Payments for payment product type instabank.invoice now contain an optional applicant object used for sending more details about the payee. The applicant data will be required for amounts over a limit specified by Instabank.

• POST /v1/sessions/{session_id}/pay

changed: Payment sessions with instabank.invoice now contains an require_applicant boolean flag in the instabank invoice configuration when getting the session.

• GET /v1/sessions/{session_id}

changed: Adds detailed debt array to instabank.finance.

changed: Disabled instabank.invoice for amounts less than 500 NOK

new: Filter transaction list by payment_product_type:

• instabank.finance
• instabank.invoice
• vipps
• payex.creditcard
• payex.swish

new: Filter transactions list by card_brand:

• Visa
• MasterCard

new: Added optional remember_me boolean to POST pay request body when initializing a payment of a session.

• POST /v1/sessions/{session_id}/pay

fix: Transaction.status typo, rename PARTICALLY_CAPTURED_REFUNDED to PARTIALLY_CAPTURED_REFUNDED.

changed: replaced card payment type with payex. The payex payment type adds support for payment product types:

• payex.creditcard
• payex.swish

changed: Add support for optional custom expires_at parameter when creating a new session either directly or from a profile.

• POST /v1/sessions-profile
• POST /v1/sessions

changed: Add support for override of configuration when creating a new session from a profile.

• POST /v1/sessions-profile

new: support cancel of session

• POST /v1/sessions/{session_id}/cancel

changed: In SessionBase, extend order with partial_payment property that can be used in case where the payment is partial and the order.amount is less or equal to the order.items.amount.

• POST /v1/sessions
• POST /v1/sessions-profile

break: Pay with instabank.finance type requires now additional properties to comply with new regulations from Finanstilsynet.

• POST /v1/sessions/{session_id}/pay
• changed*: In SessionMeta events, extend event with details object and enumerate the event names available.
• GET /v1/sessions/{session_id}

changed: Remove instabank.installment and instabank.postponement payment type. The types will no longer be accepted by:

• PUT /v1/admin/checkout
• PUT /v1/admin/gateways/instabank
• POST /v1/admin/session/profiles
• POST /v1/sessions

In SessionMeta renamed field expiry_at to expires_at.

new: PaymentConfiguration extended with optional auto_capture boolean field. If set to true the checkout serivce will automatically capture the payment after the transaction is AUTHORIZED.

new: Add support for checkout with SMS. A SMS with link to the checkout can now be sent when a new session is created. See relevant resources for more information.

• POST /v1/sessions-profile
• POST /v1/sessions

fix: Fix documentation for the response from api-keys endpoints. No gateways property will be included in response to api-keys requests.

doc: Document support for JWT Bearer authentication. Use API client to get an JWT access token.

• Create Client
• Get token

break: Administration of checkout gateways was moved to new endpoints. Gateway configuration will no longer be supported via the PUT /admin/checkout endpoint.

• PUT /admin/checkout
• POST /admin/gateways/{gateway}/status
• PUT /admin/gateways/instabank
• PUT /admin/gateways/vipps

removed:

• POST /admin/gateways/{gateway} (check gateway status)

new: Extend transaction.event with created_by property. Include the user who created the event, i.e. applied an operation to the transaction.

new: Add support for checkout with QR-Code A QR Code can now be generated for a Checkout Session or a Sale Location. See relevant resource for more information.

• POST /v1/locations/{location_id}/qr
• POST /v1/sessions/{session_id}/qr
• POST /v1/locations/{location_id}/checkout/{session_id}
• DELETE /v1/locations/{location_id}/checkout/{session_id}

new: Add support for filter transactions with query parameters. Transactions can now be filtered on: status, payment_product, merchant_reference, session_id, amount and created_at.

• GET /v1/transactions

new: Add support for session.url.callback_url. Get system-to-system notification when session payment is completed.

• POST /v1/sessions-profile
• POST /v1/sessions

A Checkout Session relates to an order in your system. When an order has been placed you create a corresponding Checkout Session to receive payment for that order.