Configuration

Configure the Module in nopCommerce

  1. Activate the Module as a Payment Method
    Select "Configuration" > "Payment Methods" from the menu and locate the "PostFinance" payment method. Click "Edit" and activate the "is active" checkbox. Specify a optional "Display Order". Click "Update".
  2. Configure the PostFinance Payment Method
    Click "Configure" to open the configuration page.
    • Gateway URL

      Enter the Gateway URL provided by PostFinance.

    • PSPID

      Enter the PSPID provided by PostFinance.

    • SHA-IN/SHA-OUT

      Enter the same SHA-IN/SHA-OUT pass phrase you configured in PostFinance Backoffice (see below). The SHA-IN/SHA-OUT pass phrase is your own password (free definition). It's used to create signed and secure communication between your store and the E-Payment service. Keep it save!

    • Additional fee

      Enter a optional additional fee when customers select this payment method.

    • License Key

      Paste in your licence key, see the page License to generate your license key. You don't need a license key to test this module. The module is fully functional without a license key with amounts up to 100.-.

    • Additional Parameters

      Add additional parameters line by line in the form <parameter>=<value> to customize the payment page at PostFinance. Consult the implementation guide provided by PostFinance to see what parameters can bee used.

    • Click "Save" to save your configuration values.

  3. Translate the Message Customers see in Check Out
    In the check out procedure, after the customer has selected your payment method, he will be informed with a message that he will be redirected to the payment service of PostFinance, after he has confirmed the order. Translate the message "After you confirmed your order, you will be redirected to PostFinance to pay your order" to all languages you have activated in your store. Go to "Configuration" > "Languages" and select "View string resources". Search/Filter for the resource string plugins.payments.postfinance.fields.redirectiontip.

Configure PostFinance Backoffice Test Environment

  1. Open PostFinance Backoffice Test Environment
    Login at your PostFinance Backoffice Test Environment account and select "Technical Information". See screen shots below of all important tabs in this area and how to apply the configuration settings needed to implement your payment method you have configured in nopCommerce.
  2. Settings "Global transaction parameters"
    Apply the setting of this screenshot.

  3. Settings "Global security parameters"
    Apply the setting of this screenshot.

  4. Settings "Payment Page layout"
    Apply the setting of this screenshot.

  5. Settings "Data and origin verification"
    Enter the same SHA-IN/SHA-OUT pass phrase you have used in the configuration of the PostFinance Module for nopCommerce (see above). The SHA-IN/SHA-OUT pass phrase is your own password (free definition). It's used to create signed and secure communication between your store and the E-Payment service. Keep it save!

  6. Settings "Transaction feedback"
    Set the URLs for server to server communication to http://<your store url>/Plugins/PaymentPostFinance/IPNHandler
    Enter the same SHA-IN/SHA-OUT pass phrase you have used in the configuration of the PostFinance Module for nopCommerce (see above). The SHA-IN/SHA-OUT pass phrase is your own password (free definition). It's used to create signed and secure communication between your store and the E-Payment service. Keep it save!

Switch to Production Environment

You have completed the testing phase and your store is ready to go online.
  1. Contact PostFinance
    Contact PostFinance by email address merchanthelp@postfinance.ch to order your PostFinance Backoffice for production use with the services enabled you need. PostFinance will provide you with all informations necessary to access and use your production environment. Your PostFinance Backoffice for production use will be preconfigured with the settings of your test environment.
  2. Reconfigure the PostFinance Payment Method for Production
    To use your PostFinance Module for nopCommerce with the PostFinance Backoffice production environment, you need to change the configuration of the module in nopCommerce. See the section Configure the PostFinance Payment Method at the top of this configuration guide and apply the settings Gateway URL and PSPID provided by PostFinance.