Tinka

Wordpress Plugin

Installation

Tinka WooCommerce is a payment gateway plugin for WooCommerce which allows customers to pay with credit using Tinka.

Follow these steps to start using Tinka WooCommerce:

  • Download the plugin to get the WooCommerce Plugin Version 1.4.7

    OR

  • Contact us to get the plugin and configuration information

    THEN

  • Install the plugin
  • Configure the plugin
  • Setup mandatory shortcodes

Install the plugin

Install Tinka WooCommerce just like any standard Wordpress plugin. Requires WooCommerce version 4.7+.

Configure the plugin

You can configure by clicking on the Settings link from the list of plugins or clicking on the WooCommerce > Payment methods > Tinka > Manage button.

The plugin page contains these fields:

  • Enable/Disable
  • Language (mandatory)
  • Title (mandatory)
  • Base URL (mandatory, provided by Tinka)
  • Callback URL
  • Cancel URL
  • Thank you page URL
  • Merchant Id (mandatory, provided by Tinka)
  • Merchant Username (mandatory, provided by Tinka)
  • Merchant Password (mandatory, provided by Tinka)
  • Merchant Secret (mandatory, provided by Tinka)
  • Display Name (mandatory, by default is set to “Buy now, pay later“ and it can be updated according to the enabled payment methods. For example, if you have enabled Tinka Pay in 12 months and Tinka Pay in 24 months payment methods, you can show at the checkout: Tinka - Betaal in 12 of 24 maanden)
  • Checkout Logo (mandatory, options: Left side logo, Right side logo, Squared logo)

Merchant credentials (Merchant Id, Merchant Username, Merchant Password, Merchant Secret) and Base URL are mandatory fields and they are provided by Tinka.

There are three fields that are not mandatory. Leaving them empty implies using the default values:

  • Callback URL, defaults to shop.com/wc-api/CALLBACK/. This is where we will send you notifications about payment requests that are pending verification. If you change this endpoint, we need to be informed as well, in order to operate the corresponding changes.
  • Cancel URL, defaults to shop.com/wc-api/CALLBACK/?action=cancel. This is where the customer will be redirected upon canceling the payment request at Tinka.
  • Thank you page URL, defaults to shop.com/checkout/order-received/{orderId}/, dynamic WooCommerce thank you page. This is where the customer will be redirected upon finishing the payment request at Tinka.

Shortcodes

In order to help you comply with our marketing guidelines, we've assembled a couple of shortcodes that you can use. The shortcodes are just wrappers around our UI components.

  • [tinkaJavaScriptLibrary] - Mandatory shortcode which should be place just before the closing body tag which includes Tinka's CSS and JavaScript files
  • [tinkaMessage] - Renders the order status message (usually on the "Thank you" page)
  • [tinkaComponents] - Renders the tinka component
  • [tinkaInstallmentAmount] - Renders the installmentAmount component
  • [tinkaCreditExampleTable] - Renders the creditExampleTable component (credit examples table)
  • [tinkaBnplAvailable] - Renders the Bnpl ("Buy now, pay later") component
  • [tinkaZeroPercentageInstallments] - Renders the zeroPercentageInstallments component
  • [tinkaWarning] - Renders a warning message "borrowing money costs money"
  • [tinkaZeroPercentage] - Renders the "Zero Percentage" credit info
  • [tinkaButton popup="installment-amount"] - Renders a button which shows the installment popup. Can have the folowing custom parameters:
    • popup - Installment-amount / tinka-calculator / credit-example-table
    • label - Button text
    • amount - Amount of money (integer)
    • class - Custom css class

© 2024 Tinka. All Rights Reserved. All trademarks, service marks and trade names used in this material are the property of their respective owners.