Iyzico

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.

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

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.

Notes:

  • iyzido does not support authorization or capture transactions

Last updated