# NKolay Credit Card Integration

## <mark style="color:red;">Installation</mark>

### <mark style="color:red;">Preliminary Works</mark>

The following information is requested from the provider for the brand-specific and production (live) environment.

* **SX**
* **SX Cancel**
* **SX List**
* **Secret Key**
* **URL**

## <mark style="color:red;">Omnitron Settings</mark>

This payment method’s configuration can be done on the **Payment Options & Add/Edit POS** Integration pages. After the settings are completed, it will be accessible under a new tab on the payment screen as it is a credit card type payment integration.

### <mark style="color:red;">Payment Options</mark>

One payment option must be defined in Omnitron to use credit card payments. Explanations on how the settings should be made at this stage are in the table below.

| Field               | Description                           |
| ------------------- | ------------------------------------- |
| Payment Option      | “Credit Card” option must be selected |
| Payment Option Name | “Credit Card” or any related text     |
| Payment Option Slug | credit\_card                          |
| Config\*            | {}                                    |

{% hint style="info" %}
Fields in config should be determined according to the requirements.
{% endhint %}

### <mark style="color:red;">POS Integration</mark>

At least one POS integration must be defined in Omnitron to use credit card payment. Explanations on how the settings should be made at this stage are in the table below.

| Field                | Description                                                                                            |
| -------------------- | ------------------------------------------------------------------------------------------------------ |
| Name                 | NKolay                                                                                                 |
| Slug                 | nkolay                                                                                                 |
| Gateway              | nkolay                                                                                                 |
| Resource URL         | Requested URL from provider                                                                            |
| Three d resource url | Requested URL from provider                                                                            |
| SX                   | Requested SX from provider                                                                             |
| SX Cancel            | Requested SX Cancel from provider                                                                      |
| SX List              | Requested SX List from provider                                                                        |
| Secret Key           | Requested Secret Key from provider                                                                     |
| Merchant Code        | Required for Masterpass, otherwise optional. First value of SX, before the first pipe character (“\|”) |
| Three d enabled      | Yes/No                                                                                                 |

## <mark style="color:red;">Additional Notes</mark>

* There can be a maximum one credit card (or Masterpass) payment option per sales channel in Omnitron but POS integrations connected to the payment option can be multiple for different payment providers.
* If NKolay will be used with Masterpass for 3D Purchases, empty value should be added to Masterpass Allowed md statuses field.
* For additional information, refer to the [POS Integrations](https://app.gitbook.com/s/IbwGN7KwvYi0iLbjtnXz/omnitron/sales-channels/payment-management/how-to-manage-pos-integrations-in-omnitron) tutorial.
* [Masterpass REST POST](https://docs.akinon.com/technical-guides/3rd-party-integration/masterpass-integrations/masterpass-rest-pos)