Jak označit fakturu za zaplacenou po platbě kartou

Platba kartou na e-shopu proběhne za pár sekund, jenže v Pohodě o ní nikdo neví. Peníze od platební brány dorazí na účet souhrnně za několik dní, často jednou částkou za desítky objednávek, a účetní je pak páruje ručně. Mezitím faktura svítí jako neuhrazená — a v horším případě zákazníkovi odejde upomínka.

apios umí fakturu označit jako uhrazenou hned ve chvíli, kdy platební brána potvrdí platbu.

Jak to funguje

Pohoda zná dva způsoby, jak fakturu uhradit: spárováním s bankovním nebo pokladním dokladem, nebo likvidací bez vazby na záložce Likvidace dokladu. API používá druhý způsob — nevytváří žádný bankovní doklad, jen zaznamená, že faktura byla uhrazena, kdy a v jaké výši.

Volání

Zavolejte ho třeba z webhooku platební brány (GoPay, Comgate, Stripe a dalších), jakmile dorazí potvrzení o úspěšné platbě:

curl -X POST https://api.apios.cz/api/v1/invoice/812/pay \
  -H "X-AUTH-TOKEN: VAS_API_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: platba-gopay-3201456789" \
  -d '{ "date": "2026-10-19" }'

{
  "success": true,
  "message": "Faktura byla označena jako uhrazená",
  "data": { "id": 812, "type": "issued" }
}

Totéž volání najdete v dokumentaci se všemi parametry a můžete si ho tam rovnou vyzkoušet:

812 v adrese je ID faktury v Pohodě. Bez dalších údajů se uhradí celá zbývající částka k dnešnímu datu.

Všechna pole jsou nepovinná:

• amount — uhrazená částka v korunách. Hodí se pro částečné platby, například zálohu. Bez ní se uhradí celý zbytek.
• date — datum úhrady, výchozí je dnešek.
• type — issued pro vydanou fakturu (výchozí), received pro přijatou fakturu, kterou platíte vy dodavateli.

Proč posílat Idempotency-Key

Platební brány posílají webhooky opakovaně, dokud nedostanou potvrzení — a někdy pošlou stejnou notifikaci dvakrát i tak. Když jako klíč použijete ID platby z brány, Pohoda každou platbu zpracuje jen jednou a opakovaný požadavek vrátí 409 bez dalšího zápisu. Podrobnosti v návodu Jak zabránit dvojímu zápisu dokladu.

Na co si dát pozor

• Bankovní výpis a likvidace. Až peníze od brány dorazí na účet, účetní zaúčtuje bankovní výpis proti zúčtovacímu účtu brány, ne proti jednotlivým fakturám. Domluvte si tento postup s účetní dopředu, ať faktura není uhrazená dvakrát.
• Kontrola. Že je faktura uhrazená, ověříte exportem GET /api/v1/invoice?id=812 — pole liquidation.amount_home ukazuje už uhrazenou částku.

Co dál

Přehled faktur, které zaplacené nejsou, popisuje návod Jak z Pohody vyexportovat faktury po splatnosti.