PostFinance Pay

Via the Saferpay JSON API, payments can be handled through PostFinance Pay.

General requirements

Acceptance of PostFinance Pay requires:

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

• A valid contract with PostFinance.

Technical requirements

The general integration of PostFinance Pay can be done via the Payment Page and has the following requirements for integration:

• JSON API Version 1.37 or later.

• Recurring payments are only available via Alias.

• Postfinance Pay does not support the Iframe integration. Saferpay will break out of the IFrame, if necessary.

• The Payment.OrderId is restricted to a maximum of 18 characters. Anything more will be truncated.

• The Payment.OrderId is restricted to an alphanumeric format. Special characters (including "-" and "_") will be filtered aut automatically.

PostFinance Pay transactions are only valid for 30 days and must be captured in this time frame. After 30 days, the reservation will void and the authorized amount can no longer be transferred! However you have a guaranteed payout, within these 30 days.

Refunds may only be executed up to 12 months, after the original transaction.

Supported features

Feature	Support
Capture/Cancel	✅ / ✅
Multipart Captures	✅
Secure Card Data	✅
Refunds	✅ Needs attention!
Recurring Payments	✅ Needs attention!
3D Secure	❌
Dynamic Currency Conversion (DCC)	❌
Mail Phone Order	❌
Testing	✅
Omni-Channel	❌

Storage in the Secure Card Data Store

If you intend on saving PostFinance Pay-data for later use, Saferpay provides the possibility of storing the payment data inside the Saferpay Secure Card store, for the Payment Page and the Standalone Alias Registration. For this, the following requirements must be met:

• Activation of Saferpay Secure Card Data in the Saferpay merchant account.

• The feature must also be activated on PostFinance side.

Stansdalone registration

If you intend to use the standalone registration, you need to specify the parameter Type with the value POSTFINANCEPAY, which signals, that you want to save Postfinance Pay payment means.

Request

{
  "RegisterAlias": {
    "IdGenerator": "RANDOM_UNIQUE"
  },
  "Type": "POSTFINANCEPAY",
  "LanguageCode": "en",
  "RequestHeader": {
    "SpecVersion": "1.37",
    "CustomerId": "242225",
    "RequestId": "5f543be575b3f3ecff3214257ac6978a",
    "RetryIndicator": 0,
    "ClientInfo": {
      "ShopInfo": "My Shop",
      "OsInfo": "Windows Server 2013"
    }
  },
  "ReturnUrl": {
    "Url": "https://www.myshop.com/"
  }
}

Address collection from PostFinance

This function is currently not yet available and will be delivered at a later date.

Testing

Please refer to this chapter, if you want to test PostFinance Pay.