---
name: "fakturownia-payments"
description: "Fakturownia CLI payments: list, fetch, create, update, and delete banking payments, including the README-backed `include=invoices` list mode and request-body discovery."
metadata:
  bundle: "fakturownia"
  category: "api-area"
  prerequisite: "fakturownia-shared"
  related_skills:
    - "fakturownia-shared"
    - "fakturownia-invoices"
    - "fakturownia-schema"
    - "fakturownia-doctor"
  command_refs:
    - "payment list"
    - "payment get"
    - "payment create"
    - "payment update"
    - "payment delete"
  cli_help: "fakturownia payment --help"
  requires_bins:
    - "fakturownia"
  discovery_hint: "Use `fakturownia schema payment list --json` for output fields and `fakturownia schema payment create --json` or `payment update --json` for request-body discovery."
---

> Auto-generated by `go run ./cmd/gen-skills`. Do not edit manually.

# Payments

> **PREREQUISITE:** Read [`fakturownia-shared`](../shared/SKILL.md) first.

## Use This Skill When

- The task is about reading or mutating banking payments.
- You need the README-backed `--include invoices` list mode or to build payment payloads with `invoice_id` or `invoice_ids`.

## Covered Commands

- `fakturownia payment list` — List payments
- `fakturownia payment get` — Fetch a single payment by ID
- `fakturownia payment create` — Create a payment
- `fakturownia payment update` — Update a payment
- `fakturownia payment delete` — Delete a payment

## Notable Flags

- `--page` (default `1`): Requested result page
- `--per-page` (default `25`): Requested result count per page
- `--include` (enum `invoices`): README-backed include such as invoices
- `--id` (required): Payment ID
- `--input` (required): Payment JSON input as inline JSON, @file, or - for stdin
- `--yes` (required, default `false`): Confirm payment deletion

## Environment

- `FAKTUROWNIA_PROFILE`: Select a profile unless --profile is provided
- `FAKTUROWNIA_URL`: Override the base account URL from any profile
- `FAKTUROWNIA_API_TOKEN`: Override the API token from any profile

## Output and Request Discovery

- Use `fakturownia schema payment list --json` and `fakturownia schema payment get --json` before building selectors.
- Read `output.known_fields` to discover README-backed payment output fields such as `name`, `price`, `paid`, `kind`, and conditional `invoices[]`.
- Use `fakturownia schema payment create --json` and `fakturownia schema payment update --json` to inspect `request_body_schema` and accepted `--input` modes.
- `--input` accepts inline JSON, `@file`, or `-` for stdin, and the CLI wraps the inner object into the upstream `banking_payment` envelope.
- Use `--include invoices` on `payment list` when you need the README-backed include mode, and inspect request fields such as `invoice_id` and `invoice_ids[]` before creating or updating payments.

## Examples

```bash
fakturownia payment list --json
fakturownia payment list --include invoices --json
fakturownia payment list --columns id,name,price,paid,kind
fakturownia payment list --page 2 --per-page 25 --raw
fakturownia payment get --id 555
fakturownia payment get --id 555 --fields id,name,price,paid --json
fakturownia payment get --id 555 --raw
fakturownia payment create --input '{"name":"Payment 001","price":100.05,"invoice_id":null,"paid":true,"kind":"api"}' --json
fakturownia payment create --input '{"name":"Payment 003","price":200,"invoice_ids":[555,666],"paid":true,"kind":"api"}' --json
fakturownia payment create --input @payment.json
fakturownia payment create --input '{"name":"Payment 001"}' --dry-run --json
fakturownia payment update --id 555 --input '{"name":"New payment name","price":100}' --json
fakturownia payment update --id 555 --input @payment-update.json
fakturownia payment update --id 555 --input '{"name":"New payment name"}' --dry-run --json
fakturownia payment delete --id 555 --yes --json
fakturownia payment delete --id 555 --yes
fakturownia payment delete --id 555 --yes --dry-run --json
```

## Related Skills

- [fakturownia-shared](../shared/SKILL.md)
- [fakturownia-invoices](../invoices/SKILL.md)
- [fakturownia-schema](../schema/SKILL.md)
- [fakturownia-doctor](../doctor/SKILL.md)