# Sipay Credit Card Integration

## <mark style="color:red;">**POS 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.

* **App ID**
* **App Secret**
* **Merchant Key**

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

This payment method’s configuration can be done on the **Payment Options & Add/Edit POS/Card Setting** pages on Omnitron. After the settings are completed, it will be accessible under a new tab on the checkout payment screen as it is a credit card type payment integration. Bin number must also be configured. For additional information, refer to the [POS Integrations](/tutorials/omnitron/sales-channels/payment-management/how-to-manage-pos-integrations-in-omnitron.md) tutorial.

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

Credit card payment option must be defined on Omnitron. Explanations on how the settings should be made at this stage are in the table below.

{% hint style="info" %}
Do not set more than one active payment option with the type “masterpass” or “credit card”.
{% endhint %}

| Field               | Description         |
| ------------------- | ------------------- |
| Payment Option      | Credit Card         |
| Payment Option Name | Any text you prefer |
| Payment Option Slug | credit\_card        |
| Config\*            | {}                  |

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

One POS integration must be defined in Omnitron to be specific for the extension installed. Explanations on how the settings should be made at this stage are in the table below.

| Field                | Description                              |
| -------------------- | ---------------------------------------- |
| Name                 | Sipay                                    |
| Slug                 | sipay                                    |
| Gateway              | sipay                                    |
| Resource URL         | Requested URL from the provider          |
| Three D resource url | Requested URL from the provider          |
| app\_id              | Requested App Id from the provider       |
| app\_secret          | Requested App Secret from the provider   |
| merchant\_key        | Requested Merchant Key from the provider |
| three\_d\_enabled    | Yes                                      |

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

At least one CARD 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                              | A related name                |
| Slug                              | A related slug                |
| Single payment POS infrastructure | Created POS in above          |
| Installment POS Infrastructure    | Created POS in above          |
| 3D POS Infrastructure             | Created POS in above          |
| Card Payment Type                 | Debit or Credit Card          |
| Card Type                         | The related created card type |
| Bank                              | The related created bank      |
| Commercial Card                   | Yes or No                     |

After creating a card, go to its detail and add bin numbers to it.

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

* If there is any error during the capture process, a void request will be sent, but it will not succeed. Nevertheless, the provider will cancel the payment after 15 minutes.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.akinon.com/technical-guides/3rd-party-integration/payment-integrations/sipay-credit-card-integration.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
