public

POST `/v1/pay/invoices/{token}/confirm`

The payer entered a card — record it and take the money. Unauthenticated.

Tất cả tài liệu dành cho nhà phát triển →

Xác thực

Điểm cuối này là công khai. Nó không yêu cầu thông tin xác thực hay tổ chức nào — đây chính là nội dung mà trang web tiếp thị và các công cụ trả lời bằng AI của chúng tôi đọc.

Endpoint này không nhận ID tổ chức. Khóa của bạn đã xác định tổ chức mà nó thuộc về và phản hồi được giới hạn trong phạm vi đó.

Dùng thử

Thay thế bất kỳ nội dung nào trong ngoعل (angle brackets) bằng giá trị của riêng bạn và trình giữ chỗ key bằng một key từ trang tổng quan của bạn.

curl -X POST https://api.zinndigital.com/v1/pay/invoices/{token}/confirm \
  -H "Content-Type: application/json" \
  -d '{ "setup_intent_id": <string> }'

Đã đăng nhập? Bảng điều khiển API trong trang quản lý của bạn sẽ tự điền ID tổ chức thực tế và khóa của riêng bạn, sau đó chạy yêu cầu đối với API trực tiếp để bạn có thể xem phản hồi thực tế. Mở điểm cuối này trong bảng điều khiển API

Chi tiết

The second half of a two-step that cannot be collapsed into one. A payer with no card on file gets a SetupIntent from /checkout, confirms it in the browser, and lands here; this records the mandate and then charges the order. Charging on the first call instead would put a failed payment on the order — this platform classifies a mandate-less charge as nothing was presented — and the capture webhook refuses to settle one of those, so the money would be taken and never recorded. setup_intent_id is an id and not a credential. The mandate behind it is re-read from the gateway and refused unless the gateway itself says it belongs to this invoice's payer, so holding one pay link cannot attach a stranger's saved card.

Tham số

Tên	Loại	Bắt buộc	Nội dung này là gì
`token (path)`	`string`	Có	—

Nội dung yêu cầu

Tên	Loại	Bắt buộc	Nội dung này là gì
`setup_intent_id`	`string`	Có	—

Phản hồi

Tên	Loại	Bắt buộc	Nội dung này là gì
`status`	`string`	Có	—
`settled`	`boolean`	Có	—
`amount_minor`	`integer`	Có	—
`currency`	`string`	Có	—
`client_token`	`string`	Không	A card intent's client secret, for the browser SDK. It authorises confirming this one intent and nothing else.
`redirect_url`	`string`	Không	An approval page to send the payer to (PayPal, a crypto invoice).
`action_kind`	`string`	Không	`setup` means no card is on file and `client_token` is a SetupIntent secret — confirm it, then call `/confirm`. Anything else is a live charge's own action.
`setup_intent_id`	`string`	Không	The SetupIntent the card form is mounted against, echoed back for the `/confirm` call. An id, not a secret: the server re-reads it from the gateway and refuses it unless the…

Các lỗi điểm cuối này có thể trả về

404 · 409 · 429

POST /v1/pay/invoices/{token}/confirm