Swiss payment system PostFinance for CiviCRM

PostFinance: Swiss people are good at branding. It's a payment system developped by the Swiss Post, and this is a civicrm extension to interface with it.

Partly funded by TEDx Lausanne (you should attend, they have awesome speakers).

If you are using it, please consider contributing financially to its development too.

By all means, feel free to contact us if you need some help for your civicrm project, we are based in Geneva. [email protected]

Installation

Postfinance account

You need a post account in swizerland, and you need to contact them. They will probably insist you need to meet their commercial, but you should be able to quickly get the basic postFinance account (postfinance to postfinance account payment), and resonnably soon a full account.

They will provide you a PSPID (Postfinance Merchant ID) that you need to set up the account

CiviCRM Payment processor

Download and enable this extension. Once done, you need to create a payment processor (Administer/System Settings/Payment Processors). Configure it with your PSPID account and set is as enabled and the default.

That's it. Create a payment page or a paid event and test.

How to use

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

On PostFinance backend:

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.

Conf. > Techn. Inf. > Global security parameters

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

Conf. > Techn. Inf. > Data and origin verification

• 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))

Conf. > Techn. Inf. > Transaction feedback

• 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.

Conf. > Account > Currencies

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

Conf. > Payment methods

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

On CiviCRM:

Install the extension

Administer > System settings > Manage extensions

Create payment processor(s)

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

Adjust localization / currency settings

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.

Test: Create a contribution page

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

Troubleshooting

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.

Online help

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