PayU iyzico

API Version

Minimum required API version: 1.3.0

Payment Methods

The following table lists all supported payment methods.

Currencies

CHF,EUR,GBP,IRR,NOK,RUB,TRY (default),USD

Payout currencies: EUR,GBP,TRY,USD

Features

The following table provides an overview of all supported and non-supported features.

Feature	Supported
3DS 2.0 External	No
3DS 2.0 PaymentsOS-handled	No
3DS 2.0 Provider-handled	No
3DS 2.0 Self-handled	No
Installments	Yes
Level 2 and 3 Data	No
Multi-seller Payments	Yes
Network Tokens	No
Payment Facilitator	No
PayU Risk	No
Pre-authorization	No
Retrieve Supported Payment Methods	No
Retrieve Supported Plans	Yes
Statement Soft Descriptor	No
Stored Credentials Flag	No
Transaction Processing without CVV	Yes

Requests

The following table lists all supported requests. Use the bodybuilder to create a sample request body for each request type.

• Cards
• eWallet

Setup Procedures

The following table lists the setup procedures that are specific to this provider.

Integration Procedures

The following sections list the integration procedures that are specific to this provider.

Enabling 3DS

If you want the user to complete a 3DS authentication step, then include a provider_specific_data object with an is3ds value of true in your Create Charge API request.

"provider_specific_data": {
    "payuiyzico": {
      "additional_details": {
        "is3ds": "true"
      }
    }
}

Showing Customers Available Installment Options during Checkout

If you configured different installment plans in your PayU iyzico account, then you can fetch those plans and display the various installment options in your checkout page when a customer initiates the payment. To do so, call the Retrieve Supported Plans request. Make sure to pass the transaction amount and currency for which to fetch the available plans as query parameters.

The response of the Retrieve Supported Plans request will include for each plan the number of allowed installments and their corresponding fee (that is, the fee charged by the issuer). You then pass in installments.number_of_installments the number of installments allowed by the plan selected by the customer. Here’s an example:

{
  ...
  "installments": {
      "number_of_installments": 12
  },
  ...
}

Implementing Shopping Credit with Pay with iyzico

Shopping credit offered through the ‘Pay with iyzico’ digital wallet is a popular payment option in Turkey. It functions as a digital version of loans provided by local banks, integrated seamlessly into the shopping process on iyzico.

To offer shopping credit to your shoppers, simply invoke the Create Charge request for the ‘Pay with iyzico’ payment method and include the provider_specific_data.payuiyzico.additional_details.product_category field to indicate the category to which the purchased item belongs:

{
  "merchant_site_url": "http://www.abc.com/return-url",
  "payment_method": {
    "source_type": "ewallet",
    "type": "untokenized",
    "vendor": "pay_with_iyzico"
  },
  "provider_specific_data": {
    "payuiyzico": {
      "additional_details": {
        "buyer_identityNumber": "123456",
        "product_category": "TABLET"
      }
    }
  },
  "reconciliation_id": "40762342"
}

The product_category field can have one of the following values:

• For gold: GOLD
• For food: FOOD
• For mobile phone: PHONE
• For Tablet: TABLET
• For Computer, desktop or laptop: PC

It is important to keep in mind the following caveats:

• When a shopper buys multiple products, it is important to specify the category of the item that has the most restrictive regulations regarding shopping credit. The order of restriction, from the most stringent to the least strict, is as follows: Gold and Food > Phone > Tablet > Computer.

• If you do not provide a category, the default value of general will be automatically assigned.

• Shopping credit will not be available as a payment option for products in the GOLD and FOOD categories.

• For products in the PHONE and TABLET categories, the purchase amount will determine the number of installments offered to the shopper. See Available Installments for Products in the Phone and Tablet Categories below.

Available Installments for Products in the Phone, Tablet and PC Categories

For products in the PHONE, TABLET and PC categories, the purchase amount will determine the maximum number of installments offered to the shopper:

• PHONE:

  • Above 12.000 TL: 3 installments
  • Below 12.000 TL: 12 installments

• TABLET: 6 installments

• PC: 12 installments

Errors in a Redirection Flow

In a redirection flow, customers finalize a transaction on a third-party site and are then directed back to your web page (the merchant_site_url) where you inform them of the status of their payment. Of course, there’s always a chance of an unexpected error (such as a provider communication timeout) in this process. If an error does occur, we’ll let you know about it by appending the type of error (api_error or provider_error) to the merchant_site_url. If available, we will also include the ID of the original payment request and related transaction request (action).

Here’s an example.

<merchant_site_url>?error=api_error&payment_id=dd1fbe34-4636-4a61-8cb1-27ac8a175284
&action_id=f7cdc75d-68d3-4a0b-b6ae-39c5a9a2cbcb/

Testing

Test Cards

The following test cards can be used to simulate a successful payment:

Cross border test cards:

Test cards to get specific error codes: