https://github.com/dachcom-digital/payum-postfinance

PostFinance Gateway for Payum
https://github.com/dachcom-digital/payum-postfinance

ecommerce payum postfinance

Last synced: about 2 months ago
JSON representation

PostFinance Gateway for Payum

• Host: GitHub
• URL: https://github.com/dachcom-digital/payum-postfinance
• Owner: dachcom-digital
• License: other
• Created: 2017-12-29T12:31:56.000Z (about 7 years ago)
• Default Branch: master
• Last Pushed: 2023-02-28T10:32:19.000Z (almost 2 years ago)
• Last Synced: 2024-10-20T23:12:32.922Z (2 months ago)
• Topics: ecommerce, payum, postfinance
• Language: PHP
• Size: 26.4 KB
• Stars: 3
• Watchers: 11
• Forks: 2
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.md

Awesome Lists containing this project

README

        
# Payum PostFinance

## Important Information

PostFinance fires the callback page **twice** if the user clicks the *"abort"* or *"ok"* button.

You need to implement a custom HttpRequestVerifierBuilder like [here](https://github.com/coreshop/PayumPostFinanceBundle/blob/master/src/CoreShop/Payum/PostFinance/Security/HttpRequestVerifier.php#L54) to disable the token invalidation!

## PostFinance Backend Configuration

1. In the Global Security Parameters tab, choose "each parameter followed by the passphrase."

2. The Hash algorithm needs to be SHA-512

3. Make sure to provide an SHA-IN pass phrase in "data and origin verification" tab

4. Check "I would like to receive transaction feedback parameters on the redirection URLs and supply a SHA-OUT pass phrase." in "Transaction feedback"

## Server To Server

You may want to enable the server-to-server functionality:

Go to "Transaction feedback" and set "Direct HTTP server-to-server request" to "Always deferred (not immediately after the payment)." for example.

In both URL fields you need to add `http://your-domain.com/payment/notify/`. Note the `` var. It gets replaced by postFinance.

**Important:** Set "Request method" to "GET" since the notifyAction only listens to the request query.

## Offline Authorisation

If you have enabled "Authorisation" in "Global transaction parameters -> Default Operation Code", you need to enable the request for status changes:

Go to "Transaction feedback -> HTTP request for status changes" and set "Timing of the request" to "For each offline status change (payment, cancellation, etc.)."

In the URL field add the same url as in section "HTTP server-to-server request".

## Language Parameter

The `LANGUAGE` Parameter cannot be set in the ConvertPaymentAction since there is no general language getter available in Payum.

To add this field you need to add a custom Extension (Check [this file](https://github.com/coreshop/PayumPostFinanceBundle/blob/master/src/CoreShop/Payum/PostFinance/Extension/ConvertPaymentExtension.php#L41) to get the Idea).

### Required Parameters

These Fields are required:

- `environment` (default 'Test')

- `shaInPassphrase`

- `shaOutPassphrase`

- `pspid`

### Optional Parameters

You can pass optional parameters to the `optionalParameters` config node.

You'll find all available fields [here](https://e-payment.postfinance.ch/ncol/param_cookbook.asp).

## To-Do

- Handle deprecated tokens?

## Copyright and License

Copyright: [DACHCOM.DIGITAL](http://dachcom-digital.ch)

For licensing details please visit [LICENSE.md](LICENSE.md)

### v2.0.0

- Bump dependencies, code improvements