mozaik.iyzico — iyzico ile kart ödemesi

Kendi iyzico hesabınla kredi/banka kartı ödemesi al — 3D Secure ve taksit destekli.

Secrets

keylabel (TR)requiredsandbox prefix
psp.iyzico.api_keyAPI Anahtarıyessandbox-
psp.iyzico.secret_keyGüvenlik Anahtarıyessandbox-

Secrets are write-only and owner-entered — see Tokens.

Provider-driven inbound

Webhooks and jobs are the platform's to ingest and schedule — never callable by agents.

kindnamenote
webhookpsp (/v1/ext/mozaik.iyzico/wh/psp/{storeId})provider-driven ingestion (payment_events); not callable by agents

Config schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "mode": {
      "default": "sandbox",
      "type": "string",
      "const": "sandbox"
    },
    "enabledInstallments": {
      "maxItems": 12,
      "type": "array",
      "items": {
        "type": "integer",
        "minimum": 1,
        "maximum": 12
      }
    }
  },
  "additionalProperties": false
}

For agents

Card payments through the merchant's own iyzico account (3-D Secure, installments). Agents can propose refunds; checkout itself is shopper-driven.

Setup

  1. Installextension.install with {"extensionId": "mozaik.iyzico"} and the consent block. extension.install with the consent payload (scopes + buyer PII go to iyzico).
  2. Secret — the owner enters psp.iyzico.api_key in the admin panel (agents cannot set secrets). Owner enters it in the admin panel — agents can never set secrets.
  3. Secret — the owner enters psp.iyzico.secret_key in the admin panel (agents cannot set secrets).
  4. Configureextension.configure setting /mode. mode stays 'sandbox' until the platform unlocks live PSP traffic (M7).
  5. Enableextension.enable.
  6. Verify — run op refund via orders.refund. Dry-run orders.refund on a paid test order — a clean preview proves credentials.

Operations

opviaeffectsproposal-onlyrequires
refundorders.refundexternalenabled · capability refund

extensions.ops.get (GET /v1/extensions/mozaik.iyzico/ops) returns this table with live readiness — exactly what blocks each op right now (missing_secret:<key>, missing_config:<pointer>, not_enabled, …).

Lifecycle

extension.installextension.configureextension.enableextension.disableextension.uninstall

Generated from the live platform registries at build time — reference pages cannot go stale. Markdown variant: /catalog/mozaik.iyzico.md