paydirekt
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.
Requirements
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
Supported features
paydirekt refunds do not need to be captured and will always report a Transaction.Status: "CAPTURED"
.
Integration
JSON API Version 1.5 or later
paydirekt restricts the
Payment.OrderId
to a maximal length of 20 characters. TheOrderId
will be automatically trimmed if it exceeds the maximal length. Please keep this in mind to properly handle the use of theOrderId
.
Handling of delivery address
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
Last updated