Create Link
AI-generatedOverview
This node integrates with the Iyzico iyzilink API to manage payment product links. Specifically, the "Create Link" operation allows users to create a new product link that can be shared or embedded for payment purposes. This is useful for merchants who want to quickly generate payment links for products without building a full e-commerce platform.
Common scenarios include:
- Creating payment links for individual products to share via email or social media.
- Setting up product details such as price, currency, description, and images dynamically.
- Including buyer information and additional options like installment requests or stock management.
For example, a merchant selling handmade crafts could use this node to generate a payment link for each item, specifying the price in Turkish Lira, attaching a product image encoded in base64, and optionally including buyer contact info.
Properties
| Name | Meaning |
|---|---|
| Product Name | The name of the product displayed on the payment screen. |
| Price | The price of the product as a string (e.g., "100.00"). |
| Currency Code | The currency of the product price. Options: Turkish Lira (TRY), US Dollar (USD), Euro (EUR). |
| Description | A textual description of the product shown on the payment page. |
| Encoded Image File | The product image encoded as a base64 string. |
| Additional Fields | Optional extra settings: |
| - Conversation ID | Merchant's product number or custom identifier sent and received in responses. |
| - Locale | Language for response texts. Options: Turkish (tr), English (en). |
| - Installment Requested | Whether installment payments are allowed (boolean). |
| - Address Ignorable | Whether the buyer's address is requested during purchase (boolean). |
| - Stock Count | Number of items in stock (number). |
| - Stock Enabled | Whether stock control is enabled (boolean). |
| Buyer Information | Optional buyer details: |
| - Buyer Name | Buyer's first name. |
| - Buyer Surname | Buyer's last name. |
| - Buyer Email | Buyer's email address. |
| - Buyer GSM | Buyer's phone number. |
| - Buyer Address | Buyer's physical address. |
| - Buyer City | Buyer's city. |
| - Buyer Country | Buyer's country. |
Output
The node outputs JSON data representing the API response from Iyzico. On successful creation, the output includes details about the newly created product link, such as its token, status, and other metadata returned by the API.
If an error occurs, the output contains error messages and codes describing the failure.
No binary data is output by this node.
Dependencies
- Requires an API key credential and secret key for authenticating with the Iyzico API.
- Supports both sandbox and production environments based on the credential configuration.
- Uses HMAC SHA256 signature for request authentication.
- Requires network access to
https://sandbox-api.iyzipay.comorhttps://api.iyzipay.com.
Troubleshooting
- Authentication failed: If you receive a 401 error, verify your API key and secret key are correct and correspond to the selected environment (sandbox or production). Ensure the HMAC SHA256 signing method is used properly.
- API errors: The node surfaces API error messages from Iyzico. Check the error message and group for clues. Common issues include invalid parameters or missing required fields.
- Invalid input data: Make sure all required properties (name, price, currencyCode, description, encodedImageFile) are provided and correctly formatted.
- Base64 image encoding: The product image must be correctly converted to a base64 string; otherwise, the API may reject the request.