Payment ServicesKBC Paypage

KBC Paypage

Sana Commerce 9.3
Your connector

Set up KBC Paypage Account

 NOTE

When the KBC Paypage payment provider is installed, it should be configured in the KBC Paypage BackOffice and in Sana Admin. To configure the KBC Paypage payment provider and payment methods, you should have the KBC Paypage test/ live account with all the necessary data.

Step 1: In the KBC Paypage BackOffice click: Configuration > Technical information > Global transaction parameters.

The table below provides the description of the required settings.

Settings Value
Default operation code Select "Sale".
Processing for individual transactions Select "Online but switch to offline when the online acquiring system is unavailable".

Step 2: Click: Configuration > Technical information > Global security parameters.

The table below provides the description of the required settings.

Settings Value
Hash algorithm Select "SHA-512" in order to comply with the highest data security standards.

  The same value should be set in Sana Admin (Hash algorithm).

Character encoding Select "UTF-8".

Step 3: Click: Configuration > Technical information > Payment Page.

Set up Back button redirection by specifying the URL of the web page that should be shown to a customer when he clicks on the "back" button on the KBC Paypage secure payment page.

Step 4: Click: Configuration > Technical information > Data and origin verification.

Checks for e-Commerce & Alias Gateway
URL of the merchant page containing the payment form that will call the page: orderstandard.asp KBC Paypage checks the origin of the payment request. You must enter the domain of your web store with the protocol at the beginning. If you have several web stores, you can enter all your web store domains separated by the semicolon ';' with no spaces before and after the semicolon.

Example: https://sanastore1.com;https://sanastore2.com

SHA-IN pass phrase The value of the SHA-IN pass phrase parameter should match the value of the SHAIN deliminator parameter in Sana Admin.

Step 5: Click: Configuration > Technical information > Transaction feedback.

Configure HTTP redirection in the browser. Select the checkboxes:

  • I would like to receive transaction feedback parameters on the redirection URLs.
  • I would like Paypage to display a short text to the customer on the secure payment page if a redirection to my website is detected immediately after the payment process. - This option is not essential for the correct functioning of KBC Paypage.

Step 6: In case KBC Paypage cannot connect to Sana for some reason to update the payment status of the order, it can be updated later, if you set up server-to-server communication.

On the Transaction feedback tab, set up the Direct HTTP server-to-server request settings.


Direct HTTP server-to-server request
Timing of the request Select "Online but switch to deferred request when the online request fail".
URL of the merchant's post-payment page Enter the following URL with the protocol in both fields. Replace "[DOMAIN]" with your web store domain.

https://[DOMAIN]/confirm/payment/KbcPaypage

Request method Select "POST".

Step 7: On the Transaction feedback tab, set up the Dynamic e-Commerce parameters.

"NCERROR", "PAYID", "ORDERID" and "STATUS" are default parameters. Select other parameters which you wish to receive as feedback for a transaction.

Step 8: Make sure that the following options are not selected on the Transaction feedback tab.

Step 9: On the Transaction feedback tab, set up the Security for request parameters.

The value of the SHA-OUT pass phrase parameter should match the value of the SHAOUT deliminator parameter in Sana Admin.

Step 10: On the Transaction feedback tab, set up HTTP request for status changes.

Select "For each offline status change (payment, cancellation, etc.)".

Enter the following URL and replace "[DOMAIN]" with your web store domain.

https://[DOMAIN]/confirm/payment/KbcPaypage

Step 11: Click: Configuration > Technical information > Transaction e-mails.

In the E-mails to the merchant parameters enter the e-mail address to which the information messages from KBC Paypage should be sent. Determine what type of messages you want to receive. 

Step 12: Click: Configuration > Payment methods. Here you can set up the necessary payment methods.

Payment ServicesKBC Paypage