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
  • General requirements
  • Technical requirements
  • Supported features
  • Payment Page integration
  • Display of pending status for captures (booking) and refunds
  • Testing

Was this helpful?

  1. Integration Guide
  2. Payment Methods & Wallets

paydirekt

PreviousMastercardNextPayPal

Last updated 4 months ago

Was this helpful?

paydirekt transactions can also be processed via the Saferpay JSON API. However, as paydirekt is a third party provider, there are a few things to consider.

General requirements

  • A and thus a valid identification with a username and password for the Saferpay system.

  • At least one active Saferpay terminal via which payment can be carried out and the associated Saferpay TerminalId.

  • A valid paydirekt merchant account

  • A valid paydirekt API-Key

  • A valid paydirekt API Secret

For paydirekt activation on the Saferpay terminal, please about your paydirekt credentials and the desired currency.

Technical requirements

The general integration of paydirekt can only be done via the and requires the following things to be noted:

  • JSON API Version 1.5 or later

  • paydirekt restricts the Payment.OrderId to a maximal length of 20 characters. The OrderId will be automatically trimmed if it exceeds the maximal length. Please keep this in mind to properly handle the use of the OrderId.

  • paydirekt does not support the . .

  • The notification URLs, inside theNotification conatiner are mandatory, in order to avoid missing payment successes. See the for further information.

Supported features

Feature

Support

✅

Multipart Captures

❌

Secure Card Data

❌

✅

Recurring Payments

❌

3D Secure

❌

Dynamic Currency Conversion

❌

Mail Phone Order

❌

✅

Omni-Channel

❌

paydirekt refunds do not need to be captured and will always report a Transaction.Status: "CAPTURED".

Payment Page integration

The processing of paydirekt transactions requires that the delivery address data is submitted. The minimum required delivery address values are:

  • FirstName

  • LastName

  • Zip

  • City

  • CountryCode

If the minimum required delivery data is missing or not complete, the Payment Page delivery address form, will be displayed during the payment process for the cardholder/purchaser to enter or complete the missing values. In this case the delivery address form is displayed regardless of the DeliveryAddressForm configuration (true or false).

Display of pending status for captures (booking) and refunds

paydirekt transfers every booking request to the buyer's bank for validation. If the validation process hasn’t yet taken place, the transaction status is shown as PENDING. Even if the validation process normally only takes a few seconds, Saferpay waits a few seconds for the result before transmitting the PENDING status with the booking response to the merchant system. In this case a notice will be displayed in the transaction details in the Saferpay Backoffice to inform that the booking is not yet completed.

The status of the transaction remains as "reservation", not permitting any follow-up actions until the pending action is completed.

Notification after change from pending to final status

As soon as Saferpay receives a response from paydirekt that a booking or refund with the status "pending" has been completed, an email notification is sent to the merchant or a server-to-server notification to the notification URL which was submitted via the JSON API. The notification informs the merchant whether the booking of the reservation or the credit has been accepted or rejected.

Querying the transaction status via API

Remember to reference the refund, not the original transaction, that has been refunded!

Testing

/

If the minimum required delivery address values are submitted during the , the delivery address form will not be displayed or will be skipped, except if the DeliveryAddressForm value is set to true.

The merchant email address is configurable via the JSON API or the .

Important Note: The "PENDING" status can only occur with and . The status-change can take up to several days, however, refunds may always be "PENDING" for at least one day!

To automatize this process, you first need to set the PendingNotification.NotifyUrl option, available for the and . Once Saferpay recieves a status-update, the NotifyUrl will be called, enabling you to query the final status.

The status of a paydirekt booking and/or refund can be queried with the JSON API. The corresponding functions are and . These functions are only available for paydirekt and for refunds, also WL Crypto Payments transactions.

This process is basically the same, as with the and follow the same rules.

Please refer to, if you want to test paydirekt.

Transaction/Capture
Transaction/Refund
Transaction/Capture
Transaction/Refund
Transaction/AssertCapture
Transaction/AssertRefund
Refunds
Testing
corresponding license
Payment Page
Iframe integration
Capture
Backoffice
Cancel
Saferpay will break out of the IFrame, if necessary
inform our customer service
Payment Page process
Payment Page initialization
Notification URLs, within the Payment Page process
this chapter
(click to enlarge)
(click to enlarge)