Schemas

Download schema

Operation

string · enum

Enum values:

AUTHENTICATE

CANCEL

CAPTURE

CREATE

CREDIT

IMPORT

INITIATE

REJECT

A transaction has a list of operations performed on a transaction. These operations can have one of the values in this enum.

Example: CREATE

PaymentType

string · enum

Enum values:

AMEX

BANKAXEPT

COLLECTOR

GIFTCARD

MASTERCARD

PAYPAL

VIPPS

VISA

The actual type of payment.

Example: VISA

FixedPricing

Fixed pricing charges a set amount each interval.

agreementType

string · enum · required

The pricing model type.

Enum values:

FIXED

VARIABLE

FLEXIBLE

amount

integer · required

The fixed amount to charge per interval, in minor units, e.g: øre.

currency

string · minLength: 3 · maxLength: 3 · required

ISO 4217 currency code.

AgreementInterval · required

Defines the billing interval for a payment agreement.

PageOfCredit

Page displays a subset of a list of entities

CreditResponse[] · readOnly · required

Items on a specific page

Example: [{"active":true,"orderId":"ABCD1234","creditId":1,"currency":"NOK","orderVersion":1,"settlementId":1245,"customerNumber":"123456789","organisationId":1,"totalCreditAmount":"450.00","creditTransactions":[{"rrn":"000123456123","amount":"450.00","status":"CREATED","currency":"NOK","createdAt":"2025-01-12T16:08:03Z","paymentId":1,"updatedAt":"2025-01-12T16:13:13Z","creditedAt":"2025-01-12T16:13:13Z","newGiftCardId":"0068a450-066f-442d-8117-1543fe2b1e0e","transactionData":{"extraData":"any extra data you want to add"},"reimbursementMethod":"VISA","paymentTransactionId":10,"reimbursementTypeGroup":"PAYMENTCARD"}]}]

totalItems

integer · int64 · readOnly · required

Total number of items

Example: 72

totalPages

integer · int64 · readOnly · required

Total number of pages available to browse

Example: 9

PaymentError

path

string · required

The url path that was accessed when the error happenened.

Example: /v1/payments/1/transactions/1/capture

error

string · required

The error that occurred.

Example: Internal Server Error

status

integer · int32 · required

The http status of the response.

Example: 500

message

string · required

A message detailing the error.

Example: An internal error occurred in the PSP. message='Unable to sale', errorCode='91', errorSource='Issuer', errorText='Refused by issuer'

exception

string · required

What exception caused the error.

Example: org.entur.payment.faulthandling.exceptions.psp.InternalPSPFailureException

timestamp

string · date-time · required

When the error occurred

Example: 2025-01-12T16:13:13Z

errorReason

string

In some cases, the client is required to act upon getting a PaymentError. When action is required from the client, this field will be populated. Valid values: SOFT_DECLINE, REFUSED_BY_ISSUER, RESOURCE_BUSY.

Example: SOFT_DECLINE

ScaExemption

string

The type of SCA (secure customer authentication) Exemption for a transaction. Defaults to NO_EXEMPTION. Other available values are: LOW_VALUE.

Example: NO_EXEMPTION

CreditRequest

Information used to create a Credit.

orderId

string · required

ID of the order this credit belongs to.

Example: HE8NDS7XY

orderVersion

integer · int32 · required

Version of the order this credit belongs to.

Example: 1

totalCreditAmount

string · maxLength: 19 · pattern: ^[1-9][0-9]{0,17}\.[… · required

Amount to credit, represented in the standard currency. Maximum (totalDigits: 18, fractionDigits: 5) according to ISO 20022. The integer and fractional digits are separated by a dot.

Example: 450.00

CreditTransactionRequest[] · required

List of individual transactions to credit.

currency

string · pattern: [A-Z]{3}

The currency used for this credit. Default value is 'NOK'

Example: NOK

Default: NOK

settlementId

integer · int64

Supplied to the client by an external system for handling settlements. For Internal Entur Clients this is Entur’s Electronic Journal.

Example: 1873

customerNumber

string

Customer who owns this credit. This value is only considered for privileged client (internal and partner tenants.

Example: 123456789

ErrorResponse

Information about an error that occurred.

code

string

The error code. Used in combination with the error source to find more information about the error.

Example: 25

source

string

Where the error originates from.

Example: Netaxept

message

string

A description of the error that occurred.

Example: Transaction not found.

PageOfPayment

Page displays a subset of a list of entities

PaymentResponse[] · readOnly · required

Items on a specific page

totalItems

integer · int64 · readOnly · required

Total number of items

Example: 72

totalPages

integer · int64 · readOnly · required

Total number of pages available to browse

Example: 9

CreditResponse

Information about credits performed on an order.

orderId

string · required

ID of the order this payment belongs to.

Example: HE8NDS7XY

creditId

integer · int64 · required

Identification of this credit resource.

Example: 1

orderVersion

integer · int32 · required

Version of the order this credit belongs to.

Example: 1

totalCreditAmount

string · required

Total amount to credit, represented in the standard currency. Maximum (totalDigits: 18, fractionDigits: 5) according to ISO 20022. The integer and fractional digits are separated by a dot.

Example: 450.00

CreditTransactionResponse[] · required

List of individual transactions to credit.

Example: [{"rrn":"000123456123","amount":"450.00","status":"CREATED","currency":"NOK","createdAt":"2025-01-12T16:08:03Z","paymentId":1,"updatedAt":"2025-01-12T16:13:13Z","creditedAt":"2025-01-12T16:13:13Z","newGiftCardId":"0068a450-066f-442d-8117-1543fe2b1e0e","transactionData":{"extraData":"any extra data you want to add"},"reimbursementMethod":"VISA","paymentTransactionId":10,"reimbursementTypeGroup":"PAYMENTCARD"}]

active

boolean

If active is false, credit is considered uneditable. The only way to change this property is through an internal Admin endpoint or the mergePatch endpoint. Editable: true

Example: false

currency

string

The currency used for this credit.

Example: NOK

settlementId

integer · int64

Supplied to the client by an external system for handling settlements. For Internal Entur Clients this is Entur’s Electronic Journal.

customerNumber

string

ID of the customer who owns this credit.

Example: 123456789

organisationId

integer · int64

ID of the organisation who created this credit.

Example: 1

InvoiceRequest

Information used to customize an invoice.

invoiceId

integer · int64

Id of Invoice. Only set in request for PUT

Example: 1

redirectUrl

string · pattern: ^(https?://).{0,1024…

Location to be redirected to from the payment terminal. Required for Collector

Example: https://www.entur.org

languageCode

string

Language code to override terminal language and invoice if possible. Overrides customer preferences. ISO 639-3 format.

Example: NOB

Default: NOB

externalInvoiceNumber

string

An external invoice number that is generated outside the sales system. This number is the invoice number on the written invoice, and must be sent to Xledger

Example: 21000557302577563

customerIdentificationNumber

string

Customer identification number to identify customer information on electronic banking transactions. Used for penalty fare invoices in Xledger. Has absolutely nothing to do with Entur customers.

Example: 12345678

PaymentRequest

Information used to create a Payment.

orderId

string · required

Id of the order this payment belongs to.

Example: HE8NDS7XY

totalAmount

string · maxLength: 19 · pattern: ^[1-9][0-9]{0,17}\.[… · required

Amount to pay, represented in the standard currency. Maximum (totalDigits: 18, fractionDigits: 5) according to ISO 20022. The integer and fractional digits are separated by a dot.

Example: 450.00

orderVersion

integer · int32 · required

Version of the order this payment belongs to.

Example: 1

currency

string · pattern: [A-Z]{3}

3-letter ISO 4217 currency code. Default is NOK.

Example: NOK

Default: NOK

TransactionRequest

Information used to create a transaction.

Example: {"amount":"450.00","currency":"NOK","isImport":false,"paymentType":"VISA","scaExemption":"LOW_VALUE","with3DSecure":true,"paymentTypeGroup":"PAYMENTCARD","recurringPaymentId":1}

settlementId

integer · int64

Supplied to the client by an external system for handling settlements. For Internal Entur Clients this is Entur’s Electronic Journal.

Example: 18234

customerNumber

string

Customer who owns this payment. This value is only considered for privileged client (internal and partner tenants.

Example: 123456789

PaymentTypeFee

Fee related to a payment method.

name

string · pattern: [A-Z]{3}:[^:]+:[^:]+ · required

Name of the fee in NeTEX format identifying a fee.

Example: ENT:PaymentTypeFee:Collector

amount

string · maxLength: 19 · pattern: ^[1-9][0-9]{0,17}\.[… · required

Total amount including taxes

Example: 100.00

currency

string · required

The currency in 3-letter ISO-4217 standard codes

Example: NOK

Default: NOK

taxAmount

string · required

The total amount of taxes this fee consists of

Example: 25.00

reason

string

The reason for the fee, if applicable.

Example: Walley Invoice

taxCode

string

The tax code for the tax rate, if applicable

Example: 3

taxRate

string

The tax rate of this fee, if applicable

Example: 25.00

WalletProvider

string · enum

Enum values:

APPLE_PAY

GOOGLE_PAY

Examples of providers are ApplePay and GooglePay. Both of these are supported.

Example: APPLE_PAY

AppClaimRequest

Information used to create a payment claim in a mobile app where end-user can accept payment.

description

string

Customize the text to be presented to the end-user in the payment app. This often involves some kind of product information.

Example: Train ticket(s) from entur.org

phoneNumber

string · pattern: ^([0-9]{8}|\+?[0-9]{…

Phone number where the claim should be presented. Accepted formats: 8-digit Norwegian number (country code 47 is added automatically if not provided), MSISDN (digits only, country code included, 10–15 digits), or E.164 (leading +, 10–15 digits). Supported country codes: Norway (47), Denmark (45), Sweden (46), Finland (358).

Example: 4791234567

redirectUrl

string · minLength: 1

Location to be redirected to from the 3rd party landing page/app.

Example: https://www.entur.org or my-app://my-url

FlexiblePricing

Flexible pricing with no fixed interval or amount.

agreementType

string · enum · required

The pricing model type.

Enum values:

FIXED

VARIABLE

FLEXIBLE

currency

string · minLength: 3 · maxLength: 3 · required

ISO 4217 currency code.

GiftCardRequest

Information used to create a payment claim with a gift card.

giftCardCode

string · required

The code identifying a gift card.

Example: 1927bd54-4cc4

InvoiceResponse

Information about the invoice payment

invoiceId

integer · int64 · required

ID of the invoice connected to the payment. Used to lookup invoice in the invoice api

Example: 1

paymentId

integer · int64 · required

ID of the payment the transaction belongs to. Used with the transactionId to later capture transaction.

Example: 1

transactionId

integer · int64 · required

ID of the transaction this terminal belongs to. Used with the paymentId to later capture transaction.

Example: 1

expiryDate

string · date-time

If paymentType is COLLECTOR_B2B: Expiry date for when invoice is no longer payable

Example: 2025-09-30T22:00:00Z

publicToken

string

If paymentType is COLLECTOR_B2B: Token used in creation of payment iframe

Example: public-SE-0a94436dba53edc468584935e7da524eb8d5d8feab85ed03

terminalUri

string

If paymentType is COLLECTOR: Location of the payment terminal, else null

Example: https://epayment.nets.eu/Terminal/default.aspx?merchantId=1234567&transactionId=77770fb3a53347777071cd6f4a3e7777

PaymentResponse

Information about an order's payment.

orderId

string · required

Id of the order this payment belongs to.

Example: HE8NDS7XY

currency

string · required

3-letter ISO 4217 currency code. Default is NOK.

Example: NOK

Default: NOK

createdAt

string · date-time · required

Timestamp for when payment was created.

Example: 2025-01-12T16:13:13Z

paymentId

integer · int64 · required

Id of payment

Example: 123

totalAmount

string · required

Amount to pay, represented in the standard currency. Maximum (totalDigits: 18, fractionDigits: 5) according to ISO 20022. The integer and fractional digits are separated by a dot. Editable: true

Example: 450.00

orderVersion

integer · int32 · required

Version of the order this payment belongs to.

Example: 1

organisationId

integer · int64 · required

Id of the organisation who created this payment.

Example: 1

active

boolean

This is to block any transactions after the corresponding order version is reset. Clients importing transactions need to either cancel or credit each transaction externally, and the credit the transaction directly using the transaction's credit endpoint. To continue using the same order id, the payment has to be reactivated with the correct total amount before any new actions can be made to this payment. Editable: true

Example: false

updatedAt

string · date-time

Timestamp for when payment was last updated.

Example: 2025-01-12T16:13:13Z

settlementId

integer · int64

Supplied to the client by an external system for handling settlements. For Internal Entur Clients this is Entur’s Electronic Journal.

Example: 18234

customerNumber

string

ID of the customer who owns this payment.

Example: 123456789

TransactionResponse[]

List of all transactions belonging to this payment.

Example: [{"rrn":"000123456123","amount":"450.00","status":"CREATED","summary":{"capturedAmount":"450.00","creditedAmount":"450.00","remainingAmountToCredit":"0.00","remainingAmountToCapture":"0.00"},"currency":"NOK","createdAt":"2025-01-12T16:08:03Z","updatedAt":"2025-01-12T16:13:13Z","cardNumber":"0004","paymentType":"VISA","operationLog":[{"pos":"18930345","error":{"code":"25","source":"Netaxept","message":"Transaction not found."},"amount":"450.00","operation":"CREATE","timestamp":"2025-08-24T14:15:22Z","distributionChannelId":"ENT:DistributionChannel:Test"}],"transactionId":10,"paymentTypeFee":{"name":"ENT:PaymentTypeFee:Collector","amount":"450.00","reason":"Walley Invoice","taxCode":"3","taxRate":"25.00","currency":"NOK","taxAmount":"25.00"},"transactionData":{"extraData":"any extra data you want to add"},"paymentTypeGroup":"PAYMENTCARD","recurringPaymentId":1}]

RecurringStatus

string · enum

Enum values:

ACTIVE

CANCELLED

CREATED

DEFAULTED

EXPIRED

Status of this recurring payment

Example: ACTIVE

TerminalRequest

Information used to customize the payment terminal.

redirectUrl

string · pattern: ^(https?://).{0,1024… · required

Location to be redirected to from the payment terminal.

Example: https://www.entur.org

autoSale

boolean

If this flag is set to true, the capture call after a customer returns from the terminal is not needed. The processing starts automatically. This is only compatible with payments done with payment cards.

Default: false

singlePage

boolean

If this flag is set to true, we will attempt to generate a single-page terminal. If false, multi-page terminal might be used.

Example: false

Default: false

callbackUrl

string

Location where notification of payment completion will be sent. If this is not provided, then the client will have to check for completion manually by getting the transaction and checking its status. The callback will be repeated until the server receives an HTTP 202 response.

Example: https://entur.org

countryCode

TerminalCountryCode · enum

ISO 3166-1 Alpha 2 country code used for certain terminals (PayPal, Collector). Used to decide which country store the customer wants to use. Default is 'NO'

Enum values:

Example: NO

Default: NO

storePayment

boolean

Should the card be stored for recurring payments. If customer is not logged in, the value of this will be disregarded.

Example: false

Default: false

customerNumber

string

Customer number used with recurring payment creation. This field is optional and will only be considered for certain privileged clients.

Example: 123456789

transactionType

TransactionType · enum

Set the type of transaction. Only set this field to MIT_UCOF if you want to create a Merchant Initiated Transaction (MIT) which refers to a card payment started by a merchant without the customer being actively involved. If this value is not set, a payment terminal will be created as normal.

Enum values:

MIT_UCOF

Example: MIT_UCOF

terminalLanguage

TerminalLanguage · enum

Language used in the payment terminal. Default is 'no_NO'.

Enum values:

da_DK

de_DE

en_GB

es_ES

et_EE

fi_FI

fr_FR

it_IT

Example: no_NO

TransactionType

string · enum

Enum values:

MIT_UCOF

Example: MIT_UCOF

ValidationError

An error that is returned when the input from the client was not validated. It's an extension of the PaymentError

path

string · required

The url path that was accessed when the error happenened.

Example: /v1/payments/1/transactions/1/capture

error

string · required

The error that occurred.

Example: Internal Server Error

status

integer · int32 · required

The http status of the response.

Example: 500

message

string · required

A message detailing the error.

Example: An internal error occurred in the PSP. message='Unable to sale', errorCode='91', errorSource='Issuer', errorText='Refused by issuer'

exception

string · required

What exception caused the error.

Example: org.entur.payment.faulthandling.exceptions.psp.InternalPSPFailureException

timestamp

string · date-time · required

When the error occurred

Example: 2025-01-12T16:13:13Z

errorReason

string

Example: SOFT_DECLINE

errors

string[]

VariablePricing

Variable pricing charges a varying amount each interval and requires a suggested maximum amount.

agreementType

string · enum · required

The pricing model type.

Enum values:

FIXED

VARIABLE

FLEXIBLE

amount

integer · required

The amount to charge per interval, in minor units, e.g: øre.

currency

string · minLength: 3 · maxLength: 3 · required

ISO 4217 currency code.

AgreementInterval · required

Defines the billing interval for a payment agreement.

suggestedMaxAmount

integer · required

A suggested maximum amount per charge, in minor units.

AgreementPricing

Base pricing model for a payment agreement.

agreementType

string · enum · required

The pricing model type.

Enum values:

FIXED

VARIABLE

FLEXIBLE

AppClaimResponse

Information about how to access mobile app "terminal".

paymentId

integer · int64 · required

ID of the payment the transaction belongs to. Used with the transactionId to later capture transaction.

Example: 1

appClaimUrl

string · required

Location of the payment terminal.

Example: https://landing.vipps.no/?token=eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1Ni

transactionId

integer · int64 · required

ID of the transaction this terminal belongs to. Used with the transactionId to later capture transaction.

Example: 10

AuthorizeRequest

Information used to update a transaction and payment with correct amount and authorize the new amount to Nets.

totalAmount

string · required

Amount to pay, represented in the standard currency. Maximum (totalDigits: 18, fractionDigits: 5) according to ISO 20022. The integer and fractional digits are separated by a dot.

Example: 450.00

CreditMergePatch

Request body used to update a credit. The properties described here are the only properties that can be updated on a credit.

totalCreditAmount

string · required

Amount to credit, represented in the standard currency. Maximum (totalDigits: 18, fractionDigits: 5) according to ISO 20022. The integer and fractional digits are separated by a dot.

Example: 450.00

active

boolean

Active is used during activation of credit

Example: true

CreditTransactionRequest[]

List of individual transactions to credit.

Example: [{"amount":"450.00","currency":"NOK","paymentTransactionId":1,"reimbursementTypeGroup":"PAYMENTCARD"}]

PaymentTypeGroup

string · enum

Enum values:

AGENT

CASH

ECARD

GIFTCARD

INVOICE

MOBILE

PAYMENTCARD

PAYPAL

A PaymentTypeGroup used to override which kind of method to use for reimbursement, instead of using same as used for the payment transaction.This will only take effect if the payment method on the payment transaction allows for overriding.

Example: CASH

TerminalLanguage

string · enum

Enum values:

da_DK

de_DE

en_GB

es_ES

et_EE

fi_FI

fr_FR

it_IT

Language used in the payment terminal. Default is 'no_NO'.

Example: no_NO

TerminalResponse

Information about how to access the terminal.

terminalUri

string · required

Location of the payment terminal.

Example: https://epayment.nets.eu/Terminal/default.aspx?merchantId=700000&transactionId=8841532204d4426da913a5abfbg322f0

paymentId

integer · int64

ID of the payment the transaction belongs to. Used with the transactionId to later capture transaction.

Example: 1

transactionId

integer · int64

ID of the transaction this terminal belongs to. Used with the paymentId to later capture transaction.

Example: 1

recurringPaymentId

integer · int64

ID of the recurring payment this terminal belongs to.

Example: 1

AgreementInterval

Defines the billing interval for a payment agreement.

unit

string · enum · required

The time unit for the interval.

Enum values:

WEEK

MONTH

YEAR

count

integer · min: 1 · required

The number of time units per interval.

AuthorizeResponse

Information about the authorized transaction

paymentId

integer · int64 · required

ID of the payment the transaction belongs to. Used with the transactionId to later capture transaction.

Example: 1

transactionId

integer · int64 · required

ID of the transaction this terminal belongs to. Used with the paymentId to later capture transaction.

Example: 10

PaymentMergePatch

Request body udes to update a payment. The properties described here are the only properties that can be updated on a payment.

totalAmount

string · required

Amount to pay, represented in the standard currency. Maximum (totalDigits: 18, fractionDigits: 5) according to ISO 20022. The integer and fractional digits are separated by a dot. Editable: true

Example: 450.00

active

boolean

Active is used during activation of payment

Example: true

settlementId

integer

Id of a settlement used to identify on-site payments i.e. mobile terminals, ticket vending machines and customer service help-desks.

Example: 100123

TransactionStatus

string · enum

Enum values:

CANCELLED

CAPTURED

CREATED

CREDITED

INITIATED

REJECTED

Current state of the transaction.

Example: CREATED

TransactionRequest

Information used to create a transaction.

amount

string · required

Amount to pay, represented in the standard currency. Maximum (totalDigits: 18, fractionDigits: 5) according to ISO 20022. The integer and fractional digits are separated by a dot.

Example: 450.00

currency

string · pattern: [A-Z]{3}

3-letter ISO 4217 currency code. Default is NOK.

Example: NOK

Default: NOK

isImport

boolean

Import flag. Selects a special payment method for imports.

Example: false

Default: false

paymentType

PaymentType · enum

The actual type of payment.

Enum values:

AMEX

BANKAXEPT

COLLECTOR

GIFTCARD

MASTERCARD

PAYPAL

VIPPS

VISA

Example: VISA

scaExemption

ScaExemption

The type of SCA (secure customer authentication) Exemption for a transaction. Defaults to NO_EXEMPTION. Other available values are: LOW_VALUE.

Example: NO_EXEMPTION

with3DSecure

boolean

Flag to choose payment methods with or without 3D Secure. This option is only accessible to privileged clients.

Example: true

Default: true

createAgreement

boolean

If true, a new FLEXIBLE Vipps agreement is created and the transaction amount becomes the initial charge. The user must approve the agreement before the charge is processed. Use with paymentType VIPPS / paymentTypeGroup MOBILE. Mutually exclusive with paymentAgreementId and recurringPaymentId.

Example: false

Default: false

paymentTypeGroup

PaymentTypeGroup · enum

Enum values:

AGENT

CASH

ECARD

GIFTCARD

INVOICE

MOBILE

PAYMENTCARD

PAYPAL

Example: CASH

paymentAgreementId

integer · int64

ID of the payment agreement to charge against. Used for Vipps recurring agreement payments. Mutually exclusive with recurringPaymentId.

Example: 456

recurringPaymentId

integer · int64

ID of the saved payment method to use for this transaction.

Example: 123

TransactionSummary

Aggregated summary of amounts on a transaction.

capturedAmount

string · required

Captured amount, represented in the standard currency. Maximum (totalDigits: 18, fractionDigits: 5) according to ISO 20022. The integer and fractional digits are separated by a dot.

Example: 450.00

creditedAmount

string · required

Credited amount, represented in the standard currency. Maximum (totalDigits: 18, fractionDigits: 5) according to ISO 20022. The integer and fractional digits are separated by a dot.

Example: 450.00

remainingAmountToCredit

string · required

Remaining amount to credit, represented in the standard currency. Maximum (totalDigits: 18, fractionDigits: 5) according to ISO 20022. The integer and fractional digits are separated by a dot.

Example: 450.00

remainingAmountToCapture

string · required

Remaining amount to capture, represented in the standard currency. Maximum (totalDigits: 18, fractionDigits: 5) according to ISO 20022. The integer and fractional digits are separated by a dot.

Example: 450.00

TerminalCountryCode

string · enum

Enum values:

ISO 3166-1 Alpha 2 country code used for certain terminals (PayPal, Collector). Used to decide which country store the customer wants to use. Default is 'NO'

Example: NO

Default: NO

TransactionResponse

Payment transaction information

amount

string · required

Amount to pay, represented in the standard currency unit. Maximum (totalDigits: 18, fractionDigits: 5) according to ISO 20022. The integer and fractional digits are separated by a dot. Deprecated and will be removed in next version of API. Use summary instead.

Example: 450.00

status

TransactionStatus · enum · required

Current state of the transaction.

Enum values:

CANCELLED

CAPTURED

CREATED

CREDITED

INITIATED

REJECTED

Example: CREATED

currency

string · required

3-letter currency code. (ISO 4217)

Example: NOK

Default: NOK

createdAt

string · date-time · readOnly · required

Timestamp for when transaction was first created.

Example: 2025-09-30T22:00:00Z

transactionId

integer · int64 · required

ID of the specific transaction.

Example: 1

rrn

string

Reconciliation reference number used to track a transaction through different economy systems.

Example: 000012345678

TransactionSummary

Aggregated summary of amounts on a transaction.

Example: {"capturedAmount":"450.00","creditedAmount":"450.00","remainingAmountToCredit":"0.00","remainingAmountToCapture":"0.00"}

updatedAt

string · date-time · readOnly

Timestamp for when transaction was last updated.

Example: 2025-09-30T22:00:00Z

cardNumber

string

Last 4 digits in card number (PAN - Personal Account Number)

Example: 0004

paymentType

PaymentType · enum

The actual type of payment.

Enum values:

AMEX

BANKAXEPT

COLLECTOR

GIFTCARD

MASTERCARD

PAYPAL

VIPPS

VISA

Example: VISA

TransactionOperationResponse[]

Log of each successful operation made on the transaction. Failing operations will not be included.

Example: [{"pos":"18930345","error":{"code":"25","source":"Netaxept","message":"Transaction not found."},"amount":"450.00","operation":"CREATE","timestamp":"2025-08-24T14:15:22Z","distributionChannelId":"ENT:DistributionChannel:Test"}]

object

Extra transaction data from external client. Only relevant for clients using the import flow.

Example: {"extraData":"any extra data you want to add"}

paymentTypeGroup

PaymentTypeGroup · enum

Enum values:

AGENT

CASH

ECARD

GIFTCARD

INVOICE

MOBILE

PAYMENTCARD

PAYPAL

Example: CASH

paymentAgreementId

integer · int64

ID of the payment agreement associated with this transaction, if any.

Example: 456

recurringPaymentId

integer · int64

Reference to the saved payment agreement this transaction will use, if any was specified.

Example: 123

PaymentMethodResponse

Result from creating a PaymentMethod.

id

integer · int64 · required

Unique identifier for a payment method.

Example: 1

paymentTypeGroup

string · required

Group for the payment type. Payment types which are payment cards is in the PAYMENTCARD group.

Example: PAYMENTCARD

distributionChannelId

string · required

Distribution Channels controls which organisations can sell, refund or inform on available products or salepoints.

Example: ENT:DistributionChannel:Test

clientId

string

ID of the client this payment method belongs to. This ID is the one found in the client's token.

Example: sS7grDF79fddBFd4=

paymentType

string

The actual type of payment.

Example: VISA

PaymentConfigurationResponse

Current payment configuration set up for psp-client relationship.

Example: {"id":1,"accountName":"Entur Test","merchantConfig":{"someKey":{"configParam":"configValue"}},"paymentProvider":"NETAXEPT"}

PaymentWebhookRequest

The request object a client can expect to receive when we send them webhooks.

eventName

string · required

The name of the event that is being sent with the webhook. Currently only support CREDIT-events

Example: CREDIT

WebhookTransactionSummary · required

A summary of the the different operations done on a transaction.

Example: {"capturedAmount":"100.00","creditedAmount":"100.00"}

enturPaymentTransactionId

integer · int64 · required

The transaction id of the transaction in Entur's system.

Example: 1

id

string

The identification of a sent webhook event.

Example: 1

timestamp

string · minLength: 1 · maxLength: 10 · pattern: ^[0-9]+$

Unix timestamp (seconds since epoch) for when webhook was sent.

Example: 1736698393

object

Extra transaction data from external client. Only relevant for clients using the import flow.

Example: {"extraData":"any extra data you want to add"}

externalTransactionId

string

The transaction id of the transaction in the partners system. This is provided by the partner when importing the transaction.

Example: 1234

PanHashTerminalRequest

Information used to create a terminal.

panHash

string · required

The pan hash used to execute the payment.

Example: eVHXJzGr4gu1lz9TwGJU

redirectUrl

string · pattern: ^(https?://).{0,1024… · required

Location to be redirected to from the payment terminal.

Example: http://www.entur.org

recurringType

string · minLength: 1 · maxLength: 1 · pattern: ^R|S$ · required

The type of the recurring payment. Can be either R og S.

Example: R

InternalTerminalRequest

Information used to customize the payment terminal.

redirectUrl

string · pattern: ^(https?://).{0,1024… · required

Location to be redirected to from the payment terminal.

Example: http://www.entur.org

RecurringPaymentRequest

Recurring payment API resource.

nickname

string

Nickname for the recurring payment

Example: Bottomless mastercard

isPrimary

boolean

Is the recurring payment the primary recurring payment of the user. There can only be one primary recurring payment at a time. Therefore, changing this status to true might set another recurring payment's isPrimary to false.

Example: false

customerNumber

string

The customer number this recurring payment belongs to. This field is optional and will only be considered for certain privileged clients. This value can not be updated.

Example: 42

CreditTransactionRequest

Single credit transaction referring to a single payment transaction.

amount

string · maxLength: 19 · pattern: ^[1-9][0-9]{0,17}\.[… · required

Amount to credit, represented in the standard currency. Maximum (totalDigits: 18, fractionDigits: 5) according to ISO 20022. The integer and fractional digits are separated by a dot.

Example: 450.00

paymentTransactionId

integer · int64 · required

Reference to the transaction to credit.

Example: 1

currency

string · pattern: [A-Z]{3}

3-letter ISO 4217 currency code. Default is NOK.

Example: NOK

Default: NOK

reimbursementTypeGroup

PaymentTypeGroup · enum

Enum values:

AGENT

CASH

ECARD

GIFTCARD

INVOICE

MOBILE

PAYMENTCARD

PAYPAL

Example: CASH

object

Required data when importing transaction/overriding method of reimbursement. This only works when importing already credited transactions, and will only be considered when this is the case.

Example: {"rrn":"000123456123","companyId":"1","terminalId":"123-133-44","paymentType":"Coop Mastercard","envNetworkId":"578000","transactionData":{"someKey":"someValue"},"mediaSerialNumberId":"0067340023","externalTransactionId":"7381cc2886b147198tuf257440c614fd","transactionConfirmedAt":"2025-01-12T16:13:13Z"}

InternalTerminalResponse

Information about how to access the terminal.

terminalUrl

string · required

Location of the payment terminal.

Example: https://terminal.entur.no/?data=MTAzNTgzMzoxMDY1NTY4

paymentId

integer · int64

ID of the payment the transaction belongs to.

Example: 1

transactionId

integer · int64

ID of the transaction this terminal belongs to.

Example: 1

PaymentAgreementResponse

Response containing payment agreement details.

status

string · enum

The current status of the agreement.

Enum values:

CREATED

PENDING

ACTIVE

STOPPED

EXPIRED

AgreementPricing

Base pricing model for a payment agreement.

agreementId

integer · int64

The unique identifier of the payment agreement.

productName

string

Name of the product or subscription.

AgreementResponseProviderData

Base provider-specific data in an agreement response.

RecurringPaymentResponse

Response type for the Recurring Payment API

primary

boolean · required

Example: false

expiresAt

string · date-time · required

When the recurring payment is no longer valid

Example: 2025-02-12T16:13:13Z

maskedPan

string · required

The stored card's masked number

Example: 4925 **** **** 0004

paymentType

PaymentType · enum · required

The actual type of payment.

Enum values:

AMEX

BANKAXEPT

COLLECTOR

GIFTCARD

MASTERCARD

PAYPAL

VIPPS

VISA

Example: VISA

cardExpiresAt

string · date-time · required

The stored card's expiration date, may be longer than the recurring payment's expiration date, but never shorter.

Example: 2025-01-12T16:13:13Z

recurringStatus

RecurringStatus · enum · required

Status of this recurring payment

Enum values:

ACTIVE

CANCELLED

CREATED

DEFAULTED

EXPIRED

Example: ACTIVE

recurringPaymentId

integer · int64 · required

ID of the recurring payment

Example: 111

nickname

string

Nickname for the recurring payment

Example: Bottomless mastercard

TransactionImportRequest

Request body for importing an already completed transaction.

transactionConfirmedAt

string · date-time · required

Time when payment transaction was completed by the client.

Example: 2018-03-07T12:20:46Z

rrn

string · minLength: 1 · maxLength: 12

Reconciliation reference number used to track a transaction through different economy systems. Required for PAYMENTCARD.

Example: 000012345678

companyId

string · pattern: [\d]{1,4}

Id of the issuing organisation. The id is equal to the internal id in Enturs Organisation Register. Required for ECARD.

Example: 1

terminalId

string

Unique identifier for a physical terminal. Makes a transaction unique together with rrn. Required for PAYMENTCARD.

Example: 123-133-44

paymentType

string

Name of the specific payment type used. This further specifies the type of payment method used for this transaction. Often referred to as the name of the issuer for payment cards in the transaction data retrieved from payment terminals. Required for PAYMENTCARD.

Example: Coop Mastercard

envNetworkId

string · pattern: [\d]{6}

County code for issuer

Example: 578000

object

Any extra transaction data which could be relevant can be specified as a key value map of strings.

Example: {"someKey":"someValue"}

mediaSerialNumberId

string · pattern: [\d]{1,10}

Numerical e-Card identifier. Required for ECARD.

Example: 0067340023

externalTransactionId

string

Transaction ID from 3rd party payment provider.

Example: 7381cc2886b147198tuf257440c614fd

CreditTransactionResponse

Represents a credit transaction referring to a payment transaction.

amount

string · required

Amount to credit, represented in the standard currency. Maximum (totalDigits: 18, fractionDigits: 5) according to ISO 20022. The integer and fractional digits are separated by a dot.

Example: 450.00

paymentId

integer · int64 · required

Reference to the payment the credited payment transaction belongs to.

Example: 1

paymentTransactionId

integer · int64 · required

Reference to the transaction this credit transaction credits.

Example: 10

reimbursementTypeGroup

string · required

General type of reimbursement method.

Example: PAYMENTCARD

rrn

string

Reconciliation reference number used to track a transaction through different economy systems.

Example: 000012345678

status

string · enum

Status of this credit transaction.

Enum values:

CREATED

CREDITED

Example: CREATED

currency

string

3-letter ISO 4217 currency code. Default is NOK.

Example: NOK

createdAt

string · date-time · readOnly

Timestamp for when transaction was first created.

updatedAt

string · date-time · readOnly

Timestamp for when transaction was last updated.

Example: 2025-01-12T16:13:13Z

creditedAt

string · date-time

Time when credit was confirmed.

Example: 2025-01-12T16:13:13Z

newGiftCardId

string · readOnly

Reference to the gift card id (contract uuid) the credited payment transaction belongs to. Note: This field will be set if the transaction was credited to a gift card.

Example: 0068a450-066f-442d-8117-1543fe2b1e0e

object

Extra transaction data from external client. Only relevant for clients using the import flow.

Example: {"extraData":"any extra data you want to add"}

reimbursementMethod

string

Specific type of reimbursement method.

Example: VISA

WebhookTransactionSummary

A summary of the the different operations done on a transaction.

capturedAmount

string · required

The amount that has been captured on this transaction

Example: 100.00

creditedAmount

string · required

The amount that has been credited on this transaction.

Example: 100.00

PageOfWebhookConfiguration

Page displays a subset of a list of entities

WebhookConfigurationResponse[] · readOnly · required

Items on a specific page

Example: [{"secret":"xgr*hyw8bru4DWZ1wqc","baseUrl":"https://entur-partner.no/webhooks","eventPaths":[{"path":"/credit","event":"CREDIT"},{"path":"/capture","event":"CAPTURE"}],"organisationId":1}]

totalItems

integer · int64 · readOnly · required

Total number of items

Example: 72

totalPages

integer · int64 · readOnly · required

Total number of pages available to browse

Example: 9

WebhookConfigurationRequest

The request body a client will send when registering a webhook configuration.

baseUrl

string · required

The client specified base url where they want to use for all event paths.

Example: https://entur-partner.no/webhooks

WebhookConfigurationEventPaths[] · minItems: 1 · required

A collection of which webhooks events and the paths they should be sent to. The path is combined with the base url to form a complete url

Example: [{"path":"/credit","event":"CREDIT"},{"path":"/capture","event":"CAPTURE"}]

AgreementRequestProviderData

Base provider-specific data for creating an agreement.

agreementProvider

string · enum · required

The payment provider for the agreement.

Enum values:

VIPPS

PaymentConfigurationResponse

Current payment configuration set up for psp-client relationship.

id

integer · int64 · required

Unique identifier of this payment configuration.

Example: 1

accountName

string · required

Name describing the owner of the configuration. Usually the name of the client.

Example: Entur Test

paymentProvider

string · required

The payment service provider this configuration is used for. This is not necessarily a 3rd party provider. This will control the way the API is used.

Example: NETAXEPT

object

Key/value map of merchant configuration parameters needed for each merchant. See documentation for specific merchant on which parameters are required.

Example: {"someKey":{"configParam":"configValue"}}

TransactionOperationResponse

Describes an operation performed on a transaction.

pos

string · required

Point-of-sale id which performed this operation.

Example: 18930345

amount

string · required

Amount for this operation, represented in the standard currency. Maximum (totalDigits: 18, fractionDigits: 5) according to ISO 20022. The integer and fractional digits are separated by a dot.

Example: 450.00

operation

Operation · enum · required

A transaction has a list of operations performed on a transaction. These operations can have one of the values in this enum.

Enum values:

AUTHENTICATE

CANCEL

CAPTURE

CREATE

CREDIT

IMPORT

INITIATE

REJECT

Example: CREATE

timestamp

string · date-time · required

Time when operation was completed. A date without a time zone in the ISO 8601 calendar system.

Example: 2025-01-12T16:13:13Z

ErrorResponse

Information about an error that occurred.

Example: {"code":"25","source":"Netaxept","message":"Transaction not found."}

distributionChannelId

string

Distribution Channels controls which organisations can sell, refund or inform on available products or salepoints. The distribution channel id represents a specific distribution channel.

Example: ENT:DistributionChannel:Test

WebhookConfigurationResponse

The response returned when registering or updating a webhook configuration

secret

string · required

The secret that should be used to validate the signature of receive webhooks. This is generated by Entur.

Example: xgr*hyw8bru4DWZ1wqc

baseUrl

string · required

The client specified base url where they want to use for all event paths.

Example: https://entur-partner.no/webhooks

WebhookConfigurationEventPaths[] · required

A collection of which webhooks events and the paths they should be sent to. The path is combined with the base url to form a complete url

Example: [{"path":"/credit","event":"CREDIT"},{"path":"/capture","event":"CAPTURE"}]

organisationId

integer · int64 · required

The organisation that own this webhook configuration

Example: 1

id

integer · int64

The id of the webhook configuration

Example: 1

AgreementResponseProviderData

Base provider-specific data in an agreement response.

agreementProvider

string · enum · required

The payment provider for the agreement.

Enum values:

VIPPS

CreatePaymentAgreementRequest

Request to create a new payment agreement.

AgreementPricing · required

Base pricing model for a payment agreement.

productName

string · required

Name of the product or subscription.

AgreementRequestProviderData · required

Base provider-specific data for creating an agreement.

customerNumber

string · required

The customer number for the agreement.

WebhookConfigurationEventPaths

The response returned when registering or updating a webhook configuration

path

string · required

The path a webhook event should be sent to.

Example: /credit

event

string · required

A webhook event. Possible values are: CREDIT.

Example: CREDIT

RegisterWalletTransactionRequest

Request body used to register a wallet transaction with an external payment provider.

paymentData

string · minLength: 1 · required

Contains payment data that will be ECC encrypted. Client should send this as a JSON-string containing the data as described in https://developer.apple.com/documentation/passkit/payment-token-format-reference#Payment-token-format-reference .

Example: {data:{"version": "EC_v1","data": "CiAgQmFzZTY0IGVueWNyeXB0ZWQgY29udGVudCBvZiB0aGUgdG9rZW4gZGF0YS4uLg==","signature": "MEUCIQDfKf9Zl...FAKE_SIGNATURE...b7Q==","header": {"ephemeralPublicKey": "BCEFAKE_EPHEMERAL_PUBLIC_KEY_BASE64==","publicKeyHash": "FAKE_PUBLIC_KEY_HASH_BASE64==","transactionId": "6B1F2E3A-9C4D-4B1A-8F4C-1234567890AB"}}

walletProvider

WalletProvider · enum · required

Examples of providers are ApplePay and GooglePay. Both of these are supported.

Enum values:

APPLE_PAY

GOOGLE_PAY

Example: APPLE_PAY

redirectUrl

string | null

Points to where users should be redirected to for 3DS handling after registering payment, according to client. This is optional, and should only be used for GooglePay and if the transaction is being initiated from a web client, and not an app client.

Example: https://your-redirect-url.org/123123

RegisterWalletTransactionResponse

Information about registered wallet-transaction.

paymentId

integer · int64

ID of the payment the transaction belongs to. Used with the transactionId to later capture transaction.

Example: 1

terminalUri

string | null

Location of the payment terminal for handling 3DS. This will only be returned if the redirectUrl was provided in the request.

Example: https://epayment.nets.eu/epay/default.aspx?merchantId=700000&transactionId=8841532204d4426da913a5abfbg322f0

transactionId

integer · int64

ID of the transaction this terminal belongs to. Used with the paymentId to later capture transaction.

Example: 1

walletProvider

string

Examples of providers are ApplePay and GooglePay. Both are supported.

Example: ApplePay

VippsAgreementRequestProviderData

Vipps-specific data for creating a recurring agreement.

agreementProvider

string · enum · required

The payment provider for the agreement.

Enum values:

VIPPS

merchantRedirectUrl

string · uri · required

URL to redirect the customer to after they have accepted or rejected the agreement in Vipps.

merchantAgreementUrl

string · uri · required

URL where the customer can manage the agreement on the merchant's site.

phoneNumber

string

The customer's phone number for Vipps push notification.

VippsAgreementResponseProviderData

Vipps-specific data returned when an agreement is created.

agreementProvider

string · enum · required

The payment provider for the agreement.

Enum values:

VIPPS

confirmationUrl

string · uri · required

URL to redirect the customer to for confirming the agreement in Vipps.