Kashing Payments

Provides Kashing Payments integration with Drupal.

Start accepting secure card payments instantly with the Kashing module on your website. It’s quick and easy to set up. You can do it yourself in no time!

All the transactions are logged through your Kashing membership account and are available for you to view and search anytime.

Never miss out on an online sale again.

Do you sometimes need to sell things face-to-face as well? Have a look at the Kashing Smart App and ditch your old fashioned card reader.

Features

• Integrate your Kashing Smart Payment Technology account with your Drupal website and allow your site visitors & clients to pay directly on your website.
• Build unlimited payment forms – each with a different transaction amount and description – so you may easily recognise them in your Kashing transaction history.
• Display your payment form in chosen page region using block.
• Easily place payment forms anywhere on your website using shortcodes (module required).
• Debug and test the integration with a convenient ”Test Mode” before you go live.
• Easily change the transaction currency.
• Fully customize the payment failure and success pages.

Installation

1. Download the Kashing module (bottom of this page).
2. Login to your page as an administrator and navigate to Extend menu.
3. Choose the +Install new module option. You will be redirected to module installation page.
4. Either upload previously downloaded module .zip file or just paste the module URL. You can also just unzip the kashing module folder and place it directly in /modules/ directory of your page.
5. Go back to Extend menu. In a Filter by name or description field type in Kashing or scroll the page down to the Kashing module section.
6. Activate selected module elements (Kashing itself is the main one and is required by the other elements) by marking them out and click an Install button.
7. If you are not able to mark any of the module elements verify the required modules (click on the module description).
8. After the CKEditor button or Shortcodes module selection make sure to follow up the instructions under Activating shortcodes functionality and/or Activating CKEditor button functionality section of this page.
9. Do not forget to clear cache.
10. After the installation, selected module elements should be available.

Module elements

• Kashing - the main standalone module providing Kashing payments functionality. It allows to configure the payments (API keys) and to create payment form in a separate block.
• Kashing Shortcodes - provides Kashing shortcode tag functionality. Just put down [kashing id=[ID] /] in your node body, where [ID] refers to previously created form ID (block machine name). Note: the shortcodes module is required.
• Kashing CKEditor button - adds the Kashing shortcode button to CKEditor, which allows to easily choose one of the created forms and place a shortcode directly in selected node.

Kashing module configuration

1. Navigate to Extend/Kashing and under the module details click on Configure button. Alternatively go to Administration page and you will find Kashing Payments Settings under the Index tab.
2. Click the Retrieve Your Kashing API Keys link (Configuration tab) – that will take you to the latest version of Kashing documentation where you will be explained how to retrieve the module configuration data.
3. After you receive the configuration data, fill all 4 fields in the Configuration tab: Test Merchant ID, Test Secret Key, Live Merchant ID, Live Secret Key. The first two are going to be used only if the Test Mode is enabled. When you’re done, click Save Settings button.
4. For test purposes, it is recommended to use the Test Mode.
5. To change the currency or to create success and failure pages select the General tab.
6. Choose your desired currency from the Choose Currency dropdown menu.
7. Design the look of both the success and failure page in a standard way using CKEditor.
8. Once again save changes.

Creating a Payment Form

1. Navigate to Add New Form tab under the Kashing settings (Similarly to step 1 of Kashing module configuration instruction).
2. Enter the form title and fill out the required fields: Amount and Description.
3. The Form ID field fills in by itself but you can change it too. Just remember to use only small letters, numbers and underscore symbol. The Form ID is used in a shortcode functionality to identify created forms.
4. When you’re done, save the form by clicking Add New Form button.

Editing Payment Forms

1. Navigate to Edit Forms tab under the Kashing settings (Similarly to step 1 of Kashing module configuration instruction).
2. If there are any forms you will see the ID, name, amount and description of all available forms.
3. To edit a form just click on Edit option associated with the table row. You will be redirected to a block layout edition page.
4. To delete a form click on the Delete option. Confirm by clicking on Remove button.
5. To delete multiple forms at once mark out chosen rows checkboxes and click on Delete Forms button.

Activating shortcodes functionality

1. To enable the shortcodes functionality download, install and activate shortcode module.
2. Navigate to Configuration / Text formats and editors.
3. Choose one of the CKEDitor variants by clicking the Configure button under the Operations column.
4. Make sure that Shortcodes checkbox under the Enabled filters is selected
5. Scroll down to the Filter settings section and varify if the Enable Kashing shortcode is checked.
6. If necessary save changes by clicking Save configuration button.
7. Now you are able to use [kashing id=[ID] /]

shortcode. Just change the ID to previously created form ID (machine name).

Activating CKEditor button functionality

1. Navigate to Configuration / Text formats and editors.
2. Choose one of the CKEDitor variants by clicking the Configure button under the Operations column.
3. In the Toolbar Configuration section drag and drop Kashing button to the desired place in CKEditor Active toolbar.
4. Save changes by clicking Save configuration button which can be find at the bottom of the page.
5. You should now be able to see the Kashing button during a content edition. If not make sure you are using a correct Text format.