LogoLogo
BlogLogin
English
English
  • An Introduction to Saferpay
    • Licensing
      • Legacy licensing
    • Reconciliation
    • Acquirers & Payment Methods
    • Web Shop Plugins and certified partners
      • ePages Beyond
      • ePages NOW
      • Magento 2
      • Odoo
      • PrestaShop
        • PrestaShop User Guide
      • Salesforce Commerce Cloud
      • SAP Commerce Cloud
      • Shopware 6
        • Shopware 6 User Guide - German
        • Shopware 6 User Guide - English
      • WordPress WooCommerce
      • Shopify
    • Supported Languages
    • Common Saferpay terms - Glossary
  • News
    • Changes for transactions without customer presence
    • Changes for the Saferpay Hosted Forms, Fields and Payment Page
  • Quick Links
    • Web Shop Plugins and certified partners
    • Secure PayGate
    • User Administration
    • Payment Page Configuration
    • Risk Management
    • API Authentication
  • Interfaces
    • Payment API (aka JSON API)
    • Management API
    • Backoffice
      • The Home screen
      • Batch Processing
      • Transactions
        • Transaction Details
        • Batch Close
        • Declined transactions
        • Pending authorizations
        • Analytics
        • SEPA Refunds Export
        • Authorization & Payment
        • Credit
      • Risk Management
      • Secure PayGate / Payment Links
      • Secure Card Data
        • Secure Card Data Details
      • Settings
        • JSON API basic/Client Certificate authentication
        • User Administration
        • Payment Page Configuration
      • Online Support
      • User Profile
    • Saferpay OnSite
    • Feedback
  • Integration Guide
    • Integrating Saferpay
    • Ways of integration
      • General Information
        • Data Security and PCI DSS
        • Versioning
        • 3-D Secure
        • PSD2
        • Dynamic Currency Conversion
        • Iframe Integration and CSS
        • Fraud Intelligence
          • Silver
          • Fraud Intelligence Integration
      • Payment Page
        • Payment Page checklist
      • Transaction Interface
        • Recurring Payments
        • Refunds
          • SEPA Refunds
      • Capture and Daily Closing
        • Partial Captures
          • Marketplace
      • Secure Card Data - Tokenization
      • Saferpay Fields
      • Inquire Interfaces
      • Mobile Integration
      • Omni-Channel
      • Mail Phone Order
      • Error Handling
      • API Health Check
      • Saferpay API Specification
    • Payment Methods & Wallets
      • General and special cases
      • Account-to-Account Payments
      • Alipay+
      • Apple Pay
      • American Express
      • Bancontact
      • Billie
      • blik
      • Click to Pay
      • Diners Club International & Discover Card
      • eps
      • giropay
      • Google Pay
      • iDEAL 2.0
      • JCB
      • Klarna Payments
      • Maestro International
      • Mastercard
      • paydirekt
      • PayPal
      • PostFinance Pay
      • Przelewy24
      • Reka
      • SEPA Direct Debit
      • Sofort by Klarna
      • TWINT
      • UnionPay
      • Visa & V PAY
      • WeChat Pay
      • WL Crypto Payments
    • Testing
    • Go-Live
    • Frequently Asked Questions
    • Saferpay Demo
      • Saferpay Demo Environment
      • Saferpay Demo Shop
    • Support
    • Changelog
Powered by GitBook
On this page

Was this helpful?

  1. Integration Guide
  2. Ways of integration
  3. General Information

Versioning

PreviousData Security and PCI DSSNext3-D Secure

Last updated 1 month ago

Was this helpful?

If you are implementing new payment methods and/or features, please make sure to implement the correct SpecVersion of our API. If you are unsure, you should refer to the newest SpecVersion. will give you further information about the current and past spec-versions. You'll also find the newest Version in the top left of our . Furthermore, each Payment Method will list the minimum required SpecVersion under its requirements.

Attention: This guide will always assume the latest SpecVersion of the Saferpay JSON API, unless stated otherwise. While some features do work with older versions, please always consult the specification and, if need be, the version, you have currently implemented, as stated below.

Furthermore, it is possible to go back to previous spec-versions, by adding the version to the url. For example, if you want to go back to the 1.4 specification, simply add the version to the url like this:

Note: SpecVersion 1.1 and lower are not available, since those were only released for internal use.

Important Changes in certain SpecVersions

If you plan on upgrading to a newer SpecVersion, you may have to keep the following major and breaking changes in mind:

SpecVersion

Changes

1.40+

  • The Transaction/RedirectPayment function has been deprecated and no longer works.

1.39+

1.36+

The values for the parameter Condition have been changed.

  • WITH_LIABILITY_SHIFT is now 3DS_AUTHENTICATION_SUCCESSFUL_OR_ATTEMPTED

  • IF_ALLOWED_BY_SCHEME is now NONE

1.33+

Error Behavior value ABORT has been renamed to DO_NOT_RETRY.

1.32+

The ReturnUrls.Success|Fail|Abort have been removed and replaced by a single ReturnUrl.Url. The outcome of the payment should be determined, by executing the next step, e.g. Transaction Authorize, or Payment Page Assert.

1.26+

The newely introduced parameter Billing|DeliveryAddressForm.AddressSource parameter now has a default Value of NONE. This means, that, per default, no address will be gathered, be it through Saferpay, or the payment method! You must keep this in mind, if you gather your customers address through Saferpay, or the payment method (e.g. PayPal). Likewise the parameter Billing|DeliveryAddressForm.Display no longer exists and is replaced by AddressSource.

1.24+

1.17+

Alias Insert Redirect: The RedirectUrl has been moved into the new Redirect container and out of the root-object.

1.12+

Notification E-Mail: Notification.MerchantEmail has been replaced with MerchantEmails, a string array, that now accepts up to 10 e-mails, instead of the one, with SpecVersion 1.11 and lower!

1.10+

1.9+

This list does not include all changes, that have been made to Saferpay. These are just the changes, that will most likely impact your development.

An extensive list of all changes, can be found in our Changelog (see below).

Removed every instance of the values for POSTFINANCE and POSTCARD inside the API, as it has been replaced by .

The Styling container has been removed from the . The Payment Page does no longer support CSS styling!

The Notification.NotifyUrl has been replaced by SuccessNotifyUrl and FailNotifyUrl, to now also cover failed transactions, with the. Both URLs behave like the old NotifyUrl, but now cover their respective cases, where the SuccessNotifyUrl is just the old NotifyUrl under a new name.

Refund Handling: Due to the introduction of and thus the splitting of a transaction into multiple transactions, you must do a refund using the CaptureId provided in the and responses, instead of the TransactionId, as with SpecVersions 1.9 and lower!

Shift of the ThreeDs-container: Due to the introduction of the Fraud Free Service, the Liability can now be accepted by one of two entities. Thusly the old ThreeDs container has been moved a level down, into the Liability container. This also applies for merchants, that do not use the Fraud Free Service!. For more information, please consult the

Tip: You should also keep an eye on , where we keep a record of API changes!

Our Changelog
API Specification
https://saferpay.github.io/jsonapi/1.4
our API Changelog
Postfinance Pay
Payment Page Interface
Partial Captures
Capture
MultipartCapture
API-Specification!
Payment Page