**CONTENT from APM AI Agent output Jan. 4, 2026**

** Ensure you emphasize that the user is not redirected to the cashier when using the PostFinance mobile app.**

 

 

PostFinance Pay

Introduction

PostFinance is an instant payment method used for domestic pay-ins in Switzerland. Instant payments enable real-time transfers between accounts 24/7, eliminating traditional banking delays. This advancement provides faster access to funds.

Supported Countries

• Switzerland

Switzerland

Supported Currencies

• CHF

CHF; EUR

REST API

Payment (Deposit) Flow

Follow these steps to perform a payment using Nuvei REST API integration:

1. Generate a sessionToken

Press here for details.

Use the paymentMethod value: PostFinance_Pay. Ensure the following parameters are included:

• APM_Base_Url: https://csgw.postfinance.ch/epay/merchantapi/v1
• APM_MerchantID: MUST UPDATE
• PSP_ID: 35
• APM_Return_Url: https://apm.safecharge.com/ApmConnector/
• APM_NotificationURL: https://apm.safecharge.com/ApmConnectorNotify/Connector/{encryptedId}
• APM_PaymentAction: Sale

Example Deposit Request

{
  "paymentMethod": "PostFinance_Pay",
  "amount": "100.00",
  "currency": "CHF",
  "merchantId": "MUST UPDATE",
  "notificationUrl": "https://apm.safecharge.com/ApmConnectorNotify/Connector/{encryptedId}"
}

Payout (Withdrawal) Flow

Send a /payout request and include the userPaymentOptionId, which contains the user’s previously stored APM account details. After the transaction is processed, Nuvei sends a DMN that includes the result of the transaction to urlDetails.notificationUrl, which Nuvei recommends including in the /payout request.

Web SDK

Payment (Deposit) Flow

To integrate PostFinance Pay via Web SDK:

1. Initialize the SDK session using initPayment() with paymentMethod: "PostFinance_Pay".
2. Set apmWindowType based on your UX:
   • 'popup': Opens a popup window automatically.
   • 'newTab': Opens a new browser tab.
   • 'redirect': Redirects the user in the current tab.
3. Call createPayment() with the required parameters (amount, currency, merchantId).

Example Web SDK Payment Request

{
  "paymentMethod": "PostFinance_Pay",
  "amount": "100.00",
  "currency": "CHF",
  "apmWindowType": "popup"
}

Withdrawal Flow

Currently not supported via Web SDK for PostFinance Pay.

Payment Page

Payment (Deposit) Flow

The customer initiates a deposit on your site, is redirected to the PostFinance Pay page, and approves the payment via QR code (desktop) or the PostFinance mobile app (mobile). Note: The user is not redirected back to the cashier from the mobile app.

Simply Connect

Payment (Deposit) Flow

TBD

DMN

Example DMN Notification:

{
  "version": "1.0",
  "status": "APPROVED",
  "apmGwRequestReference": "E196440A96839942BC9AAAF5F15F7C71",
  "amountInfo": {
    "amount": "100.00",
    "currency": "CHF"
  },
  "paymentMethod": "PostFinance_Pay",
  "transactionId": "2610000000206721",
  "reason": "",
  "errorInfo": null
}

User Experience

The user selects the ‘PostFinance Pay’ option on the cashier, enters the deposit amount, and confirms. Approval is via QR code or mobile app.

placeholder: PF_PAY_Desktop_2026-01-04_18-45.png

placeholder: PF_PAY_Mobile_2026-01-04_18-45.png

Testing

Test credentials and testing scenarios can be provided by Nuvei, if necessary. Contact Nuvei support for assistance.

INTERNAL NOTES

APM Type: Instant Bank Transfer
APM Method: PostFinance Pay
Attributes:
Payment: true
Payout: false
Refund: false
Recurring: false

Source Documents

– PostFinance Pay 2025.docx
– APM Testing Plan Excel (DMN and Web SDK details)

Other Issues and Notes

Notes: DMN examples and Web SDK details included; Simply Connect section remains TBD.