Commerce & payments
iyzico integration: post-payment automation and payment links
Connect your iyzico account with your API keys. Every successful payment starts a workflow through iyzico's merchant notifications, and the workflow can read payments and create payment links to send to customers.
- Connection type
- API key
- Scope
- Per project: every brand connects its own account
- Inbound webhook
- Yes, you get a webhook URL for incoming events
- Capabilities
- event triggers, workflow actions
- Setup time
- 15 min
What it does in OrqLabs
OrqLabs connects to iyzico with requests signed by your API key and secret key (IYZWSv2), in live or sandbox mode. After connecting, you paste the address shown on the integration card into Merchant Notifications in the iyzico panel.
Each notification's X-IYZ-SIGNATURE-V3 signature is checked with your secret key and the payment is re-read from the iyzico API; the workflow starts with the payment id, collected amount, currency, installments, conversationId and basketId. iyzico notifications carry no buyer contact details, so you match the payment to your own order record.
The iyzico node reads a payment by its id or checkout-form token and creates an iyzico Link or a single-use fast link. Test runs in the editor never create links.
What you can automate
Post-payment thank-you
When a payment succeeds, the workflow finds the order on your site by
conversationId, AI writes a short thank-you and it goes out by WhatsApp template or email.Review requests
A Wait node sends a review-request email a few days after the payment.
Payment links from chat
Your chatbot or team creates a fast link for a deposit or service fee and the link is sent in the same conversation.
Payment checks
Get payment reads the status, installments and fraud check result inside a workflow, so suspicious payments can be flagged to the team.
Nodes that use this integration
In the workflow editor these nodes run with your iyzico account.
iyzico
Get payment · Create payment link
Setup at a glance
Copy the API key and secret key from Settings → Company Settings in the iyzico panel.
In OrqLabs, go to Integrations → iyzico → Connect, enter both keys and pick the environment (live / sandbox).
Copy the webhook address shown on the integration card.
Paste it into Merchant Notifications in the iyzico panel and save.
Make a sandbox payment with a test card and check the workflow's runs.
Requirements
- An approved iyzico merchant account (or a sandbox account for testing).
- The API key and secret key from the iyzico panel.
- Access to Merchant Notifications in the iyzico panel.
- For iyzico Link: pay-by-link enabled on the account and a public product image.
What you enter when connecting
- API anahtarı *
- Güvenlik anahtarı *
- Ortam *
Good to know
- iyzico notifications and payment lookups don't include the buyer's name, email or phone; take customer details from your own order record.
- Fast links are single-use and subject to iyzico's amount limit; iyzico Links require a product image.
- Subscription notifications and refunds don't start the trigger.
Frequently asked questions
Can a payment notification be forged?
Each notification's signature is checked with your secret key and the payment is re-read from the iyzico API. The workflow only starts when the API reports the payment as successful.
How do I send the customer a thank-you message?
Notifications carry no buyer details, so you look the customer up by conversationId or basketId on your site or store integration and send the message from there. Promotional content needs İYS consent in Turkey.
My site already uses the iyzico notification address. What now?
iyzico allows one notification address. Your site can forward the request to OrqLabs unchanged, body and signature header included.
Get started with OrqLabs
Build your first workflow today
Start on the free plan: connect your accounts, pick a template and stay in control with approval steps. No credit card required.