Skip to content

    Netaxept API reference

    The Netaxept API (Application Program Interface) supports REST interface (Representational State Transfer) and Web Services. Please select the most suitable interface option for your business. After you have selected the appropriate interface option, click the drop-down menu in the left side header or links below to find the right API calls for performing transactions through Netaxept. Also, familiarize yourself with the steps described in the Payment Flow Outline section to find out in which order you should perform these calls.

    Netaxept doesn't provide any proprietary software installed on your server.

    Environments and base addresses

    EnvironmentBase address
    Testhttps://test.epayment.nets.eu/netaxept/
    Livehttps://epayment.nets.eu/netaxept/

    Supported TLS versions

    TLS 1.2 is the only secure protocol available when connecting towards Netaxept. Please make sure TLS 1.2 is supported and used in your systems for all operations (i.e. Register, Terminal, Process, Query or similar) when communicating with Netaxept (epayment.nets.eu).

    You can check your current TLS version by logging into Netaxept Admin https://epayment.nets.eu. In "Transactions" page you will see the Info box with TLS version for each operation.

    REST

    In REST, the merchant sends API calls to Netaxept using POST or GET method in HTML format and receives responses in XML format. Parameters in these calls need to be URL encoded, otherwise spaces and special characters will break the call and Netaxept won’t receive it in its complete form. There are no versioning issues with the REST API as long as you implement your XML parsing in a non-strict fashion.

    Web Services

    Netaxept offers WSDL (Web Service Desciption Language) files which help merchants to easily understand and integrate the API endpoint. These files contain description of the API endpoint, such as the operations supported by the endpoint, input and output parameters of the supported operations, network protocols and serialization formats. The WSDL files can be downloaded below.

    Test environment:

    Production environment:

    Whitelisted Web Services platforms

    PlatformDescription
    PHP5PHP SoapClient (part of the normal PHP5 distribution)
    WCFWindows Communication Foundation (part of .NET framework)
    CXFApache CXF services framework
    ZSIThe Zolera Soap Infrastructure for Python
    DOTNET20.NET 2.0 Web References
    SUDSSuds lightweight SOAP client for Python
    JAX-WSJava API for XML Web Services

    Blacklisted Web Services platforms

    PlatformDescription
    Axis 1Apache Axis SOAP engine
    Axis 2Apache Axis2 Web Services / SOAP / WSDL engine

    Validation

    All fields in the Netaxept API are validated according to below mentioned validation rules.

    AlphaNumeric

    Any of characters a-z, A-Z and 0-9 are supported.

    Reference

    Reference values are currently validated on length alone. The max length for the reference value is given in the max length field in API section.

    Boolean

    Boolean parameters need to be given in text form; a string set to either "true" or "false" is supported.

    Base64

    Valid base64-encoded values are supported.

    URL

    URLs that are max 256 characters and start with the string "http://" or "https://" are supported.

    Timestamp

    Timestamps are returned with the format YYYY-MM-DDTHH:MM:SS.milliseconds+TZ. Time zone is optional. For example: 2017-02-15T14:35:19.305+01:00

    Printable

    The field can contain any printable characters.

    Custom

    The validation of the field is specific for the field and cannot be described in general. Custom fields typically map to enumerations, but can be anything.

    Payment methods

    The following table lists all possible values for the PaymentMethod parameter. Learn more about Payment Methods here.

    Payment cards

    NameDescription
    AcceptCardAcceptCard
    AmericanExpressAmerican Express
    DanishConsumerCardForbrugsforeningen (Danish loyalty card)
    DanishDebitMasterCardMastercard Debit (Danish merchants only)
    DanishDebitVisaVisa Debit (Danish merchants only)
    DanishDinersClubInternationalDiners Club (Danish merchants only)
    DanishDebitAmericanExpressAmerican Express (Danish merchants only)
    DanishDebitMaestroMaestro (Danish merchants only)
    DankortDankort

    Direct banks

    NameDescription
    BankAxessBankAxess
    BankAxessMobileBankAxess via mobile app
    EstonianBankLuminorLuminor Bank Estonia direct bank
    EstonianBankSEBSEB Estonia direct bank
    EstonianBankSwedbankSwedbank Estonia direct bank
    FinishBankAktiaAktia Finland direct bank
    FinishBankAlandsbankenÅlandsbanken Finland direct bank
    FinishBankHandelsbankenHandelsbanken Finland direct bank
    FinishBankNordeaNordea Finland direct bank

    Invoice and installments

    NameDescription
    AfterPayAfterPay New API integration
    CollectorWalley invoice
    CollectorInstallmentWalley instalment
    WalleyB2CWalley B2C invoice with Walley hosted terminal In pilot use
    WalleyB2BWalley B2B invoice with Walley hosted terminal In pilot use
    GothiaInstallmentAfterPay instalment Will be discontinued
    GothiaInvoiceAfterPay invoice Will be discontinued
    EnterpayEnterpay B-to-B invoice

    Gift cards and prepaid solutions

    NameDescription
    GiftCardNets gift card / Gavekort - Will be discontinued
    GiftCardCenterGift card center - Will be discontinued
    iGiveGiftCardiGive gift card
    iGivePromoCardiGive Promo gift card
    NetsPrepaidCardNets Prepaid Card
    PBSPrepaidCardNets Prepaid / PBS gift card - Will be discontinued
    SB1GiftCardSparebank 1 / SB1 gift card
    SB1GiftCardCenterSparebank 1 / SB1 gift card center

    Wallet based payment methods

    NameDescription
    MasterPassMasterpass
    MobilepayMobilePay
    VippsVipps

    Other

    NameDescription
    PayPalPayPal
    SwishESwish E-Commerce
    SwishMSwish M-Commerce

    Localization

    The following languages can be used in the hosted payment window:

    TagLanguage
    da_DKDanish
    nl_NLDutch
    en_GBEnglish
    et_EEEstonian
    fi_FIFinnish
    fr_FRFrench
    de_DEGerman
    it_ITItalian
    lv_LVLatvian