<!-- Extension API v0 — pre-1.0. Interfaces may change without notice until P2 seals the custom-code format. First-party extensions track HEAD. -->

# `mozaik.kapida` — Kapıda ödeme

Teslimatta nakit veya kartla ödeme. Ücreti ayrı bir kalem olarak gösterilir.

- version **1.1.0** · publisher `mozaik` · runtime `platform` · listed: true
- provider kind: `payment` · methodId `kapida` · settlement `cod`
- capabilities: —
- scopes: `checkout`
- PII: none
- admin panels: — · actions: —

## Secrets

None.

## Provider-driven inbound

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

None.

## Config schema

```json
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "feeKurus": {
      "default": 0,
      "type": "integer",
      "minimum": 0,
      "maximum": 50000
    }
  },
  "additionalProperties": false
}
```

## For agents

Cash/card on delivery. The collect-cod op records the courier collection once the shipment is delivered; the optional method fee is plain config.

### Setup

1. **Install** — [`extension.install`](/reference/commands/extension.install) with `{"extensionId": "mozaik.kapida"}` and the consent block.
2. **Configure** — [`extension.configure`](/reference/commands/extension.configure) setting `/feeKurus`. Optional method fee in kuruş (≤ 50000); 0 = free.
3. **Enable** — [`extension.enable`](/reference/commands/extension.enable).

### Operations

| op | via | effects | proposal-only | requires |
|---|---|---|---|---|
| `collect-cod` | [`orders.cod.collect`](/reference/routes/orders.cod.collect) | `write` | ✓ | enabled |

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

### Lifecycle

[`extension.install`](/reference/commands/extension.install) → [`extension.configure`](/reference/commands/extension.configure) → [`extension.enable`](/reference/commands/extension.enable) → [`extension.disable`](/reference/commands/extension.disable) → [`extension.uninstall`](/reference/commands/extension.uninstall)