Payments

Status: contracted_test. Payment Intents are in the generated API Reference; only sk_test_* mode is promised.

A Payment Intent is the core object for taking a payment directly through the API (as opposed to hosted Checkout). It tracks a single payment from creation through authorization, capture, and any refunds.

Lifecycle

created → requires_confirmation → requires_action (3DS) → processing → succeeded
                                                                     ↘ canceled

A succeeded intent exposes its money movement as a read-only Charge via latest_charge. Refunds are issued against the payment. Internal event projections exist, but merchant-public Events and WebhookEndpoints are unavailable; do not depend on a charge.refunded delivery.

Where to go next

• Quickstart — create → confirm → capture in a few calls.
• Authorize now, capture later — split auth and capture.
• Handle payment authentication — 3-D Secure and the requires_action step.
• Charges — the read-only projection of a succeeded payment.

The full field-level request/response shape is in the API Reference.