Payment options tell you which payment methods, such as card, apple_pay, google_pay, or affirm, are available for a given transaction, and when one is not, exactly why. Resolve them for a specific context (amount, currency, buyer and billing country, capture method, and whether the payment is recurring or off-session) or for a stored source like a checkout_session, payment_link, invoice, subscription, or order.
Each resolved option reports a status of available or unavailable. Unavailable options carry a machine-readable reason, such as merchant_payments_disabled, capability_pending, requirements_due, amount_out_of_range, currency_not_supported, or country_not_supported, so you can explain or remediate rather than showing an empty payment form. This is the surface behind the most common checkout support question: "why are no payment methods showing?"
requirements_due, capability_pending, and merchant_payments_disabled point at account setup rather than the transaction. Check the merchant's readiness before charging so onboarding gaps surface early instead of at checkout.