v14

latestOpenAPI 3.1.02026-08-083813925.4 MB

Setup Intents

Retrieve setup status

Retrieves how far a setup has got and what the buyer must do next, if anything. Collection runs in the background, so poll this rather than reading the create response. Accepts either a secret key or the setup's own client_secret, so the surface collecting the payment method can poll it directly.

get/setup_intents/{setup_intent_id}/status

Path parameters

setup_intent_idstring required

The unique identifier of the setup intent.

Response

Setup status retrieved

idstring required

The setup this status describes, prefixed sint_.

objectstring required

Always setup_status.

return_urlstring nullable required

Where to send the buyer once the setup reaches a resting state, or null to leave them where they are.

status'processing' | 'succeeded' | 'canceled' | 'requires_action' required

How far the setup has got. requires_action — the buyer has a step outstanding; see next_action. processing — the buyer has done their part and the processor is deciding. succeeded — the payment method is saved. canceled — abandoned or refused.

Example response

{
  "next_action": {
    "type": "redirect"
  },
  "status": "processing"
}