This document is assuming that your civicrm site is installed on example.org, and that you use drupal clean urls. Please adjust accordingly for another domain/CMS

Create a test account, and login to the admin backend. https://e-payment.postfinance.ch/ncol/test/admin_postfinance.asp

Open "Configuration" > "Technical information" in the menu.

• "Compose the string ...": "Each parameter followed by a passphrase." Hash algorithm: SHA-512 Character encoding: UTF-8

• Define the url of the merchant page, without subfolders, trailing slashes and spaces. ex: http://example.org/civicrm/contribute/transact;http://www.example.org/civicrm/contribute/transact

• "SHA-IN Pass phrase": Randomize a string, and remember it for later. eg. sha1(uniqid(mt_rand(), true))

• HTTP redirection in the browser (leave this empty for now)

• Direct HTTP server-to-server request

  Request type: Always online

  URL of the merchant page.

• Accept: http://www.example.org/civicrm/payment/ipn/ok?processor_name=postfinance&mode=test

• Cancel: http://www.example.org/civicrm/payment/ipn/notok?processor_name=postfinance&mode=test

Notes The CiviCRM payment processor will ignore the "ok" or "notok" after the "ipn". However, it absolutely needs the processor_name and mode GET params. The processor_name needs to be identical with the extension name. This is why we chose a simple lowercase name without spaces. The mode should be set to 'live' on the prod postfinance config. All other data is transmitted with http POST. SSL is not necessary on the IPN.

Method: POST

• "SHA-OUT Pass phrase": Again, randomize a string (different than SHA-IN), and remember it for later.

Add the currencies of your choice. (Recommended: CHF, EUR, USD)

Add the payment methods of your choice. (e.g. VISA)

Administer > System settings > Manage extensions

Administer > System settings > Payment processors

• Payment Processor Type = PostFinance

• Processor details (Live / Test) PSPID (Merchant ID): The name you use to login on the postfinance backend SHA-IN pass phrase: Same as above SHA-OUT pass phrase: Same as above

Administer > Localization > Languages, Currency, Locations

Suggested (optional) settings:

• "Default Currency": EUR or CHF (instead of USD).
• "Available Currencies": Add EUR and CHF.
• "Default Country": Switzerland (make your choice)
• "Available Countries": Add Switzerland, and your personal choice of EU countries.

Contributions > New contribution page

Tab: Amounts

• Currency: EUR or CHF
• Payment Processor: PostFinance
• Contribution Amounts section enabled: Yes
• Allow other amounts: Yes

Note: In some cases the "Payment Processor" checkboxes do not show up. Usually this is because one of the previous steps was not done correctly.

Contributions > Manage Contribution Pages

You see a list of contribution pages. For the one you just created, click the "Links" on the right column, then in the pop-up menu click "Test-drive".

On the test-drive contribution page:

• Contribution Amount: E.g. 55 (EUR)
• Email: Your email

On PostFinance backend: https://e-payment.postfinance.ch/ncol/test/admin_postfinance.asp

Configuration > Error logs

"unknown order/1/s/": Usually this means a mismatch of the SHA

"unknown order/1/r/": Usually this means you have the wrong referer url.

"Parameter cookbook": https://e-payment.postfinance.ch/ncol/param_cookbook.asp