---
title: "Odkaz na platbu kartou k existující objednávce"
method: POST
path: "/api/order/agent/payment-link"
tags: ["objednávka"]
---

# Odkaz na platbu kartou k existující objednávce

`POST /api/order/agent/payment-link`

## Request

- Base URL: `https://konfigurator.suorigo.cz`
- URL: `https://konfigurator.suorigo.cz/api/order/agent/payment-link`
- Auth: none declared

Když zákazník odkaz na platbu ztratil nebo vypršel (platí ~24 h). Stejná funkce jako tlačítko „Dokončit platbu kartou“ na stránce stavu: otevřenou Stripe session znovu použije (žádná druhá platba), zaplacenou jen doúčtuje, rozpracované ověření v bance (3DS < 30 min) nechá doběhnout. Jen pro objednávky kartou — objednávka na převod má platební údaje už v odpovědi create_order. S autorizací statusToken vrátí `paymentUrl`; s orderNumber + email odkaz NEvrací (id Stripe session v něm by šlo zneužít), ale pošle ho zákazníkovi na e-mail z objednávky (`emailSentTo`, max 1× / 15 min a 3× / den, jinak 429).

## Request body

- object: autorizace: statusToken (vrátí paymentUrl), NEBO orderNumber + email (odkaz odejde e-mailem zákazníkovi)
  - `statusToken` string: token ze statusUrl — plný přístup
  - `orderNumber` string: spolu s email
  - `email` string, email: spolu s orderNumber

## Response `200`

Odkaz (nebo aktuální stav platby)

- PaymentLinkResult
  - `ok` boolean
  - `status` integer
  - `error` string
  - `code` string
  - `orderNumber` string
  - `amount` number
  - `currency` 'CZK'
  - `paymentMethod` string
  - `paymentUrl` string
  - `paymentUrlExpiresAt` string, date-time, nullable
  - `paymentState` 'pending' | 'paid' | 'processing' | 'requires_action'
  - `statusUrl` string: jen s autorizací statusToken
  - `emailSentTo` string: jen s autorizací orderNumber + email: odkaz odešel e-mailem zákazníkovi (maskovaná adresa); paymentUrl se v tom případě NEvrací
  - `message` string

## Other responses

- `404`: Objednávka nenalezena (`not_found`)
- `409`: Objednávka se platí převodem (`bank_transfer_order`, chyba nese platební údaje), nebo se kartou zaplatit nedá — zaplacená, stornovaná, mimo dosah (`not_payable_cancelled`, `not_payable_not_pending`, …)
- `429`: Překročen limit (per IP, per e-mail, globální nebo denní). Text v `error` říká, co se stalo a co dělat; typicky počkej nebo odkaž zákazníka na https://konfigurator.suorigo.cz.
- `502`: Stripe teď neodpovídá (`stripe_error`)

---

[API](https://skmtc.dev/suorigo/apis/suorigo-api-pro-ai-agenty.md) · [All operations](https://skmtc.dev/suorigo/apis/suorigo-api-pro-ai-agenty/llms.txt) · [OpenAPI document](https://skmtc.dev/suorigo/apis/suorigo-api-pro-ai-agenty/revisions/08c6a3ef2349?raw)