# iyzico

<figure><img src="https://3790748257-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FT43PzcNjyZtWby9yrGd3%2Fuploads%2F4XgQ91iWUz55YqT8Xj53%2FUntitled.png?alt=media&#x26;token=48480681-10ac-4457-809d-6dd1fb44e3ee" alt="" width="342"><figcaption></figcaption></figure>

{% hint style="danger" %}
**Disclaimer:**

iyzico does not support authorization or capture transactions
{% endhint %}

**STEP 1**

Obtain **ApiKey** and **SecretKey** from iyzico.

**STEP 2**

Go to **Gateways > Gateway Integrations**

Activate the iyzico gateway tile. Enter **ApiKey**, **SecretKey** and **Language**. Optionally choose to use Secure 3DS.

<figure><img src="https://3790748257-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FT43PzcNjyZtWby9yrGd3%2Fuploads%2FWiTwmKdV4RkQAdq5w8eb%2FUntitled.png?alt=media&#x26;token=27252565-ae6b-4de4-aae4-cd68ac3c7205" alt="" width="375"><figcaption></figcaption></figure>

<figure><img src="https://3790748257-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FT43PzcNjyZtWby9yrGd3%2Fuploads%2FDz1fReMV8m1HnB9GudUO%2FUntitled.png?alt=media&#x26;token=bc9f2e6c-73c9-43f6-8a5d-15a62afbc269" alt="" width="563"><figcaption></figcaption></figure>

**STEP 3**

Identity Number for a buyer may be a required field for the order process (new sale, upsell & recurring billing). Discuss this requirement with iyzico.

This is TCKN for Turkish merchants and passport number for foreign merchants

If using CheckoutChamp hosted pages:

* Put an input on the checkout page. Set Name = custom field 3. Make it a required field. Give it a label and/or placeholder sufficient for the buyer to enter Identity Number.

If not using CheckoutChamp hosted pages:

* Use any order custom field 1-5 to pass the buyer's Identity Number with the proper prefix followed by a pipe (IDCARD or PASSPORT). For example IDCARD|74300864791

**STEP 4**

If using Secure 3DS be sure the checkout page supports the challenge requests

[Direct API 3DS Instructions](https://help.checkoutchamp.com/crm/gateway-setup/direct-api-3ds-instructions)

**STEP 5**

A transaction may be put in review if the fraud status is flagged as Review. To get the final disposition of the review a webhook must be enabled at iyzico. Put in a request to iyzico to send a webhook to **<https://api.checkoutchamp.com/billers/iyzico/notification/>**. You will need to share the Merchant ID on your iyzico dashboard with the iyzico team to get this enabled.