Sign in
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. A 200 means we answered, not that the method was saved — always branch on this. 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, and only this one means saved. canceled — abandoned or refused; see last_setup_error to tell which.

Example response

{
  "id": "sint_xxxxxxxxxxxxxx",
  "last_setup_error": {
    "code": "enrollment_declined",
    "message": "The bank declined the enrollment."
  },
  "next_action": {
    "data": {
      "frame_max_width": 500,
      "url": "https://psp.example/3ds/challenge"
    },
    "render": [
      "inline"
    ],
    "type": "redirect"
  },
  "object": "setup_status",
  "return_url": "https://shinetime.example/billing/saved",
  "status": "canceled"
}

Changes

Changed in 8 of the 74 revisions of this API.612

  • 1660b8d622041See the full diff
    • ○

      added the optional property ///////// to the response with the status

      response-optional-property-added

    This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • 621705ee8f4a2See the full diff
    • ○

      added the optional property ///////// to the response with the status

      response-optional-property-added

    • ○

      added the optional property ///////// to the response with the status

      response-optional-property-added

    This revision also has 6 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • 48408451a1f012See the full diff
    • ▲

      added to the ////// response property oneOf list for the response status

      response-property-one-of-added

    • ○

      added discriminator to ////// response property for the response status

      response-property-discriminator-added

    • ○

      removed from the ////// response property oneOf list for the response status

      response-property-one-of-removed

  • ae20b30817de1See the full diff
    • ○

      added the required property /////// to the response with the status

      response-required-property-added

  • 6fb1c04bf2551See the full diff
    • ○

      added the required property to the response with the status

      response-required-property-added

  • a01100378e5951See the full diff
    • ▲

      added to the //// response property oneOf list for the response status

      response-property-one-of-added

    • ▲

      the //// response's property type changed from object to no type for status

      response-property-type-changed

    • ▲

      removed the required property ///// from the response with the status

      response-required-property-removed

    • ▲

      removed the required property ///// from the response with the status

      response-required-property-removed

    • ▲

      removed the required property ///// from the response with the status

      response-required-property-removed

    • ○

      added discriminator to //// response property for the response status

      response-property-discriminator-added

  • f1020c3ecda43See the full diff
    • ○

      added the optional property / to the response with the status

      response-optional-property-added

    • ○

      added the optional property / to the response with the status

      response-optional-property-added

    • ○

      added the optional property / to the response with the status

      response-optional-property-added

    This revision also has 9 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • ca841fbd67861See the full diff
    • ○

      endpoint added

      endpoint-added

    This revision also has 6 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

Of the 74 revisions, 1 has no diff computed.