Skip to navigation

Read Your Card on File and Introductory Offer

View as Markdown

Return the card paying the caller’s continuing Stripe subscription (brand, last four digits, expiry) and whether Checkout would charge each plan’s introductoryAmount from GET /v1/billing/plans on the first payment, which only an account the App Store does not bill, with no earlier subscription, payment, or unvoided invoice, gets. Read live from Stripe and never stored; 503 when Stripe is unavailable.

Authentication

AuthorizationBearer

Your aVenture API key (https://aventure.vc/settings/api-keys) or OAuth access token

Response headers

X-RateLimit-Limitinteger

Requests allowed per client IP in the current rate-limit window.

X-RateLimit-Remaininginteger

Requests left before the tightest applicable rate-limit bucket rejects.

X-RateLimit-Resetinteger

Seconds until the exhausted rate-limit bucket admits another request; 0 when none is exhausted.

Response

OK
introductoryOfferEligibleboolean

True when the catalog offers introductoryAmount, the App Store does not bill the account, and it has no earlier subscription, payment, or unvoided invoice; false otherwise

paymentMethodobject or nullOptional

Card that pays the continuing Stripe subscription; absent without one or when it is paid by something other than a card

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
406
Not Acceptable Error
422
Unprocessable Entity Error
429
Too Many Requests Error
500
Internal Server Error
503
Service Unavailable Error