commerce
POST /v1/orders/{orderId}/customer-action
Reopen the checkout for a payment that is waiting on the customer.
Аутентификација
Пошаљите API кључ као bearer токен. Ова крајња тачка не наводи конкретну дозволу у спецификацији, па свом кључу доделите најмања неопходна овлашћења и проверите одговор уместо да претпостављате.
Ова крајња тачка не прихвата id организације. Ваш кључ већ идентификује организацију којој припада, а одговор је ограничен на њу.
Испробајте
Замените све што је у угластим заградама сопственим вредностима, а чувар места кључа кључем са своје контролне табле.
curl -X POST https://api.zinndigital.com/v1/orders/{orderId}/customer-action \
-H "Authorization: Bearer zdk_live_…"Пријављени сте? API конзола на вашој контролној табли попуњава ваш прави id организације и ваш сопствени кључ, и покреће захтев према живом API-ју како бисте могли да видите стварни одговор. Отворите ову крајњу тачку у API конзоли
Детаљи
Returns where the customer finishes paying an order that is already part-way through a payment — the NOWPayments hosted crypto invoice, a PayPal approval page, or a fresh Stripe SCA credential. This is what makes a crypto order payable: the gateway supplies that link once, at the instant the invoice is opened, and until this endpoint existed nothing gave it to the customer. It never charges. POST /v1/orders/{orderId}/pay is the guarded surface that opens a payment; this one only reopens the checkout for a payment already in progress, so it sits behind none of the card-testing defences and needs none. Call /pay first; come back here to send the customer to the checkout, and again whenever they return to it later. A crypto action always returns the SAME invoice. The confirming IPN is matched on the invoice id recorded against the payment, so a second invoice for one order would take the customer's money against a record that does not exist. NOWPayments has no read-invoice endpoint either, so the link captured when the invoice was opened is the only one there is.
Параметри
| Назив | Тип | Обавезно | Шта је ово |
|---|---|---|---|
orderId (path) | Uuid | Да | The order's id. |
Одговор
| Назив | Тип | Обавезно | Шта је ово |
|---|---|---|---|
kind | string<pay, approve, authenticate> | Да | What the customer is being asked to do. pay — open a crypto invoice and send payment; approve — approve the payment in their PayPal account; authenticate — confirm the… |
url | string | Не | The hosted page to send the customer to, or "" when this action is a credential instead. For crypto this is the NOWPayments invoice and it is… |
token | string | Не | A short-lived client-side credential for the gateway's browser SDK (Stripe's client secret), or "". Never stored by the platform — it is re-read from the gateway each time this… |
provider | string | Да | The payments driver that owns this action (nowpayments, paypal, stripe). |
Грешке које ова крајња тачка може вратити
401 · 403 · 404 · 422 · 429