Vault sessions
Get a vault session
Read a session until the user finishes. The poll alternative to the vault.session_linked webhook.
GET
pending (wait poll_interval seconds and read again), linked (store user_id, stop), or expired (create a new session).true once the user has a card in the vault, whether saved on this link or already on file. false until the session is linked.The card this link hands your app: send it as
card_id on a purchase. The card the user saved on this link, or, when the user saved none and already has a card, the card on file the link picked. Null until the link hands a card.The last step the page recorded on a session created with
return_url: opened, signed_in, stopped, or left. left means the user tapped the button back to your app. reason carries a short code when the page stopped.Only on a session that asked for app auto-approval. Whether your app can pay with the card the user gave it:
card_id, grant_id, revision, status (pending, active, revoked, retired, or unavailable), and ready. Poll until ready is true. See Enable auto-approval.poll_interval and you never see a 429. Only the client that created the session can read it; anything else is a 404.