Iyzico icon

Iyzico

Interact with Iyzico iyzilink API

Update Link

AI-generated

Overview

This node integrates with the Iyzico iyzilink API to manage product payment links. Specifically, the Update Link operation allows users to update details of an existing product link on the Iyzico platform. This is useful for merchants who want to modify product information such as price, description, or image after the product link has been created.

Common scenarios include:

  • Updating product pricing or currency.
  • Changing the product description or image.
  • Adjusting settings like installment availability or address requirements.

Practical example: A merchant initially sets a product price but later wants to increase it due to demand. Using this node's Update Link operation, they can update the product price without creating a new link.

Properties

Name Meaning
Product Name The name of the product displayed on screen.
Price The price of the product.
Currency Code The currency of the product price. Options: Turkish Lira (TRY), US Dollar (USD), Euro (EUR).
Description A description of the product shown to customers.
Encoded Image File The product image encoded in base64 format.
Token The unique token generated by Iyzico identifying the product link to update.
Additional Fields Optional extra parameters:
- Conversation ID Merchant-specific identifier sent and received back in responses (e.g., product number).
- Locale Language for response texts. Options: Turkish (tr), English (en).
- Installment Requested Whether installment payments are allowed (true/false).
- Address Ignorable Whether to request buyer address during purchase (true/false).

Output

The node outputs a JSON object representing the API response from Iyzico after attempting to update the product link. The structure includes:

  • status: Indicates success or failure of the operation.
  • errorMessage (if any): Describes the error if the update failed.
  • Other fields returned by the Iyzico API relevant to the updated product.

If the update is successful, the output contains the updated product details as confirmed by the API.

Dependencies

  • Requires an API key credential and secret key for authenticating with the Iyzico API.
  • The node uses HMAC SHA256 signing for request authentication.
  • Supports both sandbox and production environments based on credential configuration.
  • No additional external dependencies beyond standard HTTP requests.

Troubleshooting

  • Authentication failed: If you receive an authentication error, verify that your API key and secret key are correct and correspond to the environment (sandbox or production) you intend to use.
  • API errors: The node surfaces error messages returned by the Iyzico API. Common issues might be invalid tokens, malformed data, or missing required fields.
  • Invalid token: Ensure the token provided corresponds to an existing product link.
  • Base64 image encoding: The product image must be correctly base64 encoded; otherwise, the API may reject the request.
  • Use the "Continue On Fail" option in n8n to handle errors gracefully and inspect error details in the output.

Links and References

Discussion