Iyzico icon

Iyzico

Interact with Iyzico iyzilink API

Actions6

Get Link Details

AI-generated

Overview

This node integrates with the Iyzico iyzilink API to manage payment product links. Specifically, the "Get Link Details" operation retrieves detailed information about a specific iyzilink product using its unique token. This is useful for merchants or developers who want to fetch up-to-date product details such as price, description, status, and other metadata directly from Iyzico's platform.

Practical scenarios include:

  • Verifying product information before displaying it on a website or app.
  • Synchronizing product data between Iyzico and an internal system.
  • Debugging or auditing product configurations by fetching their current state.

Properties

Name Meaning
Token The unique token value generated by Iyzico that identifies the product link to retrieve.
Additional Fields Optional extra parameters:
- Conversation ID: Merchant-defined identifier sent in request and returned in response.
- Locale: Language of the response texts; options are "Turkish" (tr) or "English" (en).

Output

The output is a JSON object containing the full response from the Iyzico API for the requested product link. It includes all available details about the product such as name, price, currency, description, image, status, and any additional metadata provided by the API.

No binary data is output by this operation.

Example structure (simplified):

{
  "status": "success",
  "locale": "tr",
  "systemTime": 1234567890,
  "data": {
    "token": "string",
    "name": "Product Name",
    "price": "100.00",
    "currencyCode": "TRY",
    "description": "Product description",
    "encodedImageFile": "base64string",
    "status": "ACTIVE",
    ...
  }
}

Dependencies

  • Requires an API key credential and secret key credential for authenticating with the Iyzico API.
  • The node automatically selects the API endpoint based on the environment (sandbox or production).
  • Network access to https://api.iyzipay.com or https://sandbox-api.iyzipay.com is required.

Troubleshooting

  • Authentication failed: If you receive an authentication error, verify your API key and secret key credentials. Ensure they are correct and correspond to the selected environment (sandbox vs production). The node uses HMAC SHA256 for signing requests.
  • API errors: If the API returns an error status, check the errorMessage and errorGroup fields in the response for more details. Common issues include invalid tokens or missing required parameters.
  • Invalid token: Make sure the token provided corresponds to an existing product link in your Iyzico account.
  • Network issues: Confirm that your n8n instance can reach the Iyzico API endpoints without firewall or proxy blocking.

Links and References

Discussion