Extensions/Payment/mw-payment-ogone

The Ogone payment extension enables customers to pay their orders via the payment methods provided by the Ogone payment service provider. A full list of all supported payment methods can be found in the PDF provided by Ogone.

Setup Ogone account
You need to set up an Ogone account first. They allow to create test accounts for free that can be used as a base for the production account later and guide you through the setup of the account. In case of questions have a look into the Ogone documentation or ask Ogone for support.

Request data verification


The SHA-IN setting is a secret string that's used by the Ogone server to verify the parameters sent with the redirect of the customer to Ogone. Entering a string for this setting is required and the same string must be also entered in the Arcavias payment service configuration (this is described in the next section).

You can find the SHA-IN setting in the Ogone administration interface in
 * Configuration > Technical Information > Data and origin verification

Note: This must be the same string as for SHA-OUT!



Direct transaction feedback


Customers should get immediate feedback on the checkout confirmation page that their payment was accepted, declined or whatever has happened. For this, the payment status must be part of the URL to your shop that the customer is redirected to by Ogone.

Enable this behaviour with the setting named
 * "I would like to receive transaction feedback parameters on the redirection URLs."

You can find the transaction feedback setting in the Ogone administration interface in
 * Configuration > Technical Information > Transaction feedback



Server to server transaction feedback


If the customer closes his browser window or doesn't get redirected to the checkout confirmation page, you still want to know if the payment was successful so you can deliver the products. Ogone provides a server to server transaction feedback for this case so the payment status is directly sent to your server.

You can find the necessary settings in the Ogone administration interface in
 * Configuration > Technical Information > Transaction feedback

There are several settings to change:
 * Timing of the request: Online but switch to a deferred request when the online requests fail.
 * URL of the merchant's post-payment page: This is the shop URL to the confirmation update page. Use that URL in both input fields.
 * Request method: GET



Response data verification


The SHA-OUT setting is a secret string that's used by Arcavias to verify the parameters sent with the redirect of the customer from Ogone. Entering a string for this setting is required and the same string must be also entered in the Arcavias payment service configuration (this is described in the next section).

You can find the SHA-OUT setting in the Ogone administration interface in
 * Configuration > Technical Information > Transaction feedback

Note: This must be the same string as for SHA-IN!



Status change notification


The payment status of an order changes when the payment was finally executed, cancelled or refund in the Ogone administration interface. To receive the latest payment status you have to configure asynchronous notifications from Ogone.

You can find the settings for payment status changes in the Ogone administration interface in
 * Configuration > Technical Information > Transaction feedback

There are several settings to change:
 * Timing of the request: For each offline status change (payment, cancellation, etc.).
 * URL on which the merchant wishes to receive a deferred HTTP request, should the status of a transaction change offline: This is the shop URL to the confirmation update page.



Setup Arcavias payment service


After copying the mw-payment-ogone extension to the Arcavias extension directory (e.g. ./ext/ in the Arcavias demo), you need to add it to the list of available payment services:


 * 1) Open the Arcavias administration interface
 * 2) Switch to the "Service" tab
 * 3) Click at the "Add" button to create a new one
 * 4) Select or enter the following details:
 * 5) * Status: enabled
 * 6) * Type: Payment
 * 7) * Code: An unique code of your choice
 * 8) * Provider: Ogone
 * 9) * Label: A string of your choice that is used if no text in the language of the customer is available
 * 10) * Position: The position at which the payment option is displayed
 * 11) In the configuration panel at the right side add at least
 * 12) * ogone.account
 * 13) * ogone.secret
 * 14) Click on the "Save" button




 * ogone.account (required) : The name of the Ogone account you've created in the first step. It's also known as PSPID.


 * ogone.secret (required) : Secret string entered in SHA-IN and SHA-OUT fields in the Ogone account configuration (in Configuration > Technical Information > Data and origin verification and in Configuration > Technical Information > Transaction feedback). Both strings have to be the same as the mw-payment-ogone extension uses one secret for verifying incoming and outgoing requests.


 * ogone.url (optional, default "https://secure.ogone.com/ncol/prod/orderstandard.asp") : URL the customer is forwarded to enter his payment details. If you want to connect to the test environment, use "https://secure.ogone.com/ncol/test/orderstandard.asp" instead


 * ogone.operation (optional, default "SAL") : Payments can be either transferred to your account immediately (this is the default mode) or some payment methods allow to reserve the amount from the customer account for some days (mode "RES"). If only a reservation is done, you have to ensure that the payment is executed later, either manually or automatically by Ogone.