> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cope.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Changelog

> Weekly COPE release notes for checkout integrations, webhook contracts, and developer documentation.

# Changelog

Weekly COPE release notes for developer-facing checkout, webhook, and integration updates.

## 2026-08-17

Week of August 17

### New

* Enabled the documented read endpoints for orders, payments, refunds, and invoices: `GET /v1/commerce/orders`, `/payments`, `/refunds`, `/invoices`, plus retrieve by id for each. Existing API keys work unchanged — no new key, no settings change, no migration is needed.
* The commerce reference now lists only operations the gateway actually serves; endpoints that are implemented but not yet publicly routed are withheld from the sidebar until they ship.
* The order list returns completed orders only; draft, pending, and failed checkouts are not exposed. All four lists paginate with `page` and `per_page` (maximum 25; larger values are clamped) and return a `pagination` object with `total_pages`, `current_page`, `per_page`, and `total_count`. A page number beyond the last page returns the last page, so iterate until `current_page` equals `total_pages` rather than until `data` is empty.

## 2026-08-11

Week of August 11

### New

* Added paid community memberships, giving creators a full community create/edit flow, buyer checkout for paid access, automatic membership grants after purchase, and access removal when an eligible withdrawal or subscription end applies.
* Added community gamification settings, including a dedicated settings page and master toggle for community points.
* Added emailed sign-in codes as a supported second factor for new-device verification, so eligible users can complete sign-in without a separate authenticator or SMS factor.
* Added PayPal subscription price changes, so creators can update the recurring amount for eligible active PayPal subscriptions.
* Added a standalone VAT liability addendum page with in-portal reminders when a creator needs to re-accept current terms before liability transfer can apply.

### Updates

* Improved checkout confirmation pages for trials, active subscriptions, cancelled subscriptions, and subscriptions ending after the paid-through period, so buyers see accurate charge and access information.
* Improved product and checkout presentation for trials and multi-quantity orders, including trial badges before checkout, visible quantities in checkout and order views, and quantity-aware subscription amounts.
* Improved promo-code setup with clearer guidance for discounts in other currencies and a warning when a fixed discount only applies to the base currency.
* Improved Phone Offer setup by disabling empty currency selections and explaining when settlement onboarding is needed before pricing becomes available.
* Improved Promotions views by scoping promoter links, products, product stats, and order context to the selected business.
* Improved PayPal subscription reliability across trial conversion, renewal charging, seller capability sync, and recurring charge diagnostics.
* Improved payout resilience so reconciliation issues are isolated and payout requests return clear status instead of unnecessarily blocking unrelated sellers.
* Updated COPE branding in the cart app and public API reference.
* Updated email footer legal links so Terms and Privacy destinations resolve to the current `www.cope.com` legal pages.
* Updated buyer-facing COPE links in receipt and recovery surfaces to use current `cope.com` and `app.cope.com` destinations.

### Fixes

* Fixed re-sent promoter invites so vendors can resend an invite to an existing COPE user and see the resend cooldown clearly.
* Fixed affiliate transaction views so vendors and promoters see aligned revenue, commission, status, transaction IDs, and last-sale context for the same partnership.
* Fixed promo-code creation and editing so duplicate codes show a specific field-level rejection instead of a generic failure.
* Fixed promoter commission and product-stat reporting so earnings appear under the correct affiliate profile and incoming amounts do not stay hidden after invite acceptance.
* Fixed BNPL checkout for shipped orders so complete buyer location details keep eligible payment methods available through confirmation.
* Fixed checkout payment submission so buyers are not blocked by address requirements for a payment method they did not choose.
* Fixed checkout address validation so a delayed postal-code lookup from a previous country cannot overwrite the new billing address.
* Fixed multi-quantity subscription and installment totals so order KPIs, reminder amounts, schedule entries, and renewal charges match the quantity the buyer purchased.
* Fixed first-payment-only promo codes on subscriptions so recurring amounts return to the full undiscounted tax basis after the first charge.
* Fixed checkout safeguards so unsupported zero-value or below-minimum purchases cannot complete as paid transactions.
* Fixed product creation and editing details across localized placeholders, German creator copy, thank-you-page tooltips, narrow plan cards, location autocomplete, and product-required validation for promoter invites.
* Fixed checkout address autocomplete accessibility and modal behavior, including portalled suggestions that remain visible and attached to the correct field.

## 2026-08-04

Week of August 4

### New

* Added public Community API documentation, including community OpenAPI references and webhook event pages for memberships, posts, comments, channels, events, invites, gamification, and library activity.
* Added PayPal support for recurring subscriptions and trial subscriptions, including buyer approval, saved PayPal re-authorization from subscription settings, renewal handling, and cancellation support.
* Released Growth Hub and Promotions in production, giving creators and promoters access to affiliate management, promoter earnings, and promotion performance views.
* Added estimated arrival dates to creator payout pages, so creators can see both when a payout is initiated and when it is expected to reach their bank.
* Added a refund policy link to checkout and public footer surfaces, making buyer-facing refund terms easier to reach before purchase.

### Updates

* Improved Promotions order and transaction views with business-scoped results, clickable promotion order rows, richer promoter order overviews, clearer pending-commission context, and revenue and commission columns for promo-code performance.
* Improved affiliate invite emails with clearer collaboration copy, vendor identity, localized guidance, and per-product affiliate links when product-specific promotion is available.
* Improved checkout and phone-offer tax reliability by routing active buyer pricing paths through COPE's unified tax calculation flow, preserving authoritative zero-tax outcomes, and failing visibly when tax cannot be calculated safely.
* Improved PayPal subscription reliability so recurring charges, trials, revoked-consent recovery, and renewal declines follow the buyer's actual PayPal authorization state.
* Improved creator setup by preselecting the business country from the visitor's region when it is supported, while preserving any manual selection.
* Improved community navigation by showing About and Rules consistently inside communities and keeping Rules ordered below About.

### Fixes

* Fixed checkout billing-country changes so a country-specific billing address is reset when the buyer switches countries.
* Fixed invalid checkout tax addresses so buyers receive a validation response instead of an ambiguous tax failure.
* Fixed product setup safeguards so unsupported tax codes cannot be saved and payment-plan numbers stay within supported bounds.
* Fixed product management so creators can clear an upsell funnel and blank shipping prices are treated as zero.
* Fixed sign-in and sign-up controls so email and SSO submissions show progress and avoid duplicate password-alternative submissions.
* Fixed creator KYC messaging so creators do not receive false account-paused emails.

## 2026-07-28

Week of July 28

### New

* Added a promoter order overview from promotion transactions, so promoters can open an order and review their own commission, vendor, attribution, and promoted product details without exposing buyer details.
* Added order-level affiliate reassignment for creator order management, including preserved commission terms for future recurring payments after an affiliate is changed or removed.
* Added more flexible installment-plan setup by making the second-payment offset optional in product and phone-offer editors.

### Updates

* Improved Payment Providers settings by replacing the broader KYC section label and keeping internal PayPal tracking references out of seller-facing account details.
* Improved checkout localization so an English checkout selection is saved correctly for receipts and withdrawal-rights emails.
* Improved localized email coverage with Italian, Dutch, Polish, Portuguese, and Japanese subject lines across transactional templates.
* Improved affiliate commission reporting so reassigned recurring commissions and promoter order views follow the correct earner and attribution context.
* Improved tax accuracy by using COPE's registered platform origin when a product has no specific origin address for tax calculation and filing.
* Improved embedded checkout reliability by retrying approved-origin policy checks before failing closed.
* Improved checkout reliability in in-app browsers by handling changed totals server-side and routing card authentication through a WebView-compatible flow.

### Fixes

* Fixed post-sign-in account setup so creators can create and load businesses without needing to refresh after authentication.
* Fixed payment-provider verification retries so recoverable Stripe webhook failures can be reprocessed instead of being treated as completed.
* Fixed phone-offer currency defaults so offers follow the selected product or business currency instead of falling back to USD.
* Fixed deployed community requests that could fail when the community service initialized its data client.

## 2026-07-21

Week of July 21

### New

* Added clearer KYC guidance while creators create and publish products, including draft-saving prompts and a direct path to complete verification before launch.
* Added a business-name column to creator and affiliate promotion views, making vendor partnerships easier to recognize across approved and pending tabs.

### Updates

* Improved PayPal selling support so PayPal-verified creators are recognized across product publishing, verification badges, KYC banners, and checkout availability.
* Improved payment verification labels so creators can see whether their business is verified for Stripe, PayPal, or both, with steadier PayPal button rendering in checkout.
* Improved PayPal onboarding recovery so creators who disconnect and reconnect PayPal can complete verification without stale onboarding sessions or unnecessary popup windows.
* Improved PayPal checkout safeguards by hiding PayPal where recurring, installment, or trial billing cannot be supported, and by closing checkout availability when a seller can no longer receive PayPal payments.
* Improved affiliate promotion reporting so link, promo-code, and phone-offer sales stay in the right attribution views, promoter share links use stable attribution IDs, and incoming commissions appear in the correct payout currency.
* Improved checkout tax presentation with clearer subtotal, included-tax, estimated-tax, and reverse-charge VAT labels across product pages, hosted checkout, receipts, invoices, and subscription flows.
* Improved EU VAT ID handling so valid VIES responses resolve inline, unavailable validation falls back to charging VAT, and placeholder company names are no longer shown to buyers.
* Improved Growth Hub and Promotions reliability, including invite-decision confirmation, clearer filtered empty states, corrected commission display, and cleaner vendor partnership tables.
* Improved webhook signature guidance in the dashboard and public docs, with snippets that verify the timestamped `X-Cope-Signature` format used by live webhook deliveries.

### Fixes

* Fixed product creation after a KYC publish gate so repeated saves update the saved draft instead of creating duplicate products.
* Fixed checkout legal links so buyers can reach COPE's current Terms, Privacy Policy, Legal Notice, and Accessibility URLs from checkout and related public surfaces.
* Fixed checkout payment-method filtering so buyers see a clear unavailable-payment state when no supported method remains for the selected seller and currency.
* Fixed subscription renewal tax sourcing so recurring tax is based on the buyer's destination instead of the seller's origin.
* Fixed checkout behavior during country-VAT service outages so COPE fails safely instead of completing an EU consumer checkout with missing VAT.
* Fixed Stripe refund and dispute processing so out-of-order webhook events retry cleanly and creator dispute reporting can recover when payment records arrive later.
* Fixed webhook reliability so event catalog requests avoid transient unavailable states and queued webhook deliveries keep processing after recoverable delivery errors.
* Fixed B2B phone-offer payments so company names carry into Stripe billing details and vendor transaction details.
* Fixed Terminal Readers localization so supported creator locales no longer fall back to English.
* Fixed support-contact phone validation and formatting across creator settings.

## 2026-07-14

Week of July 14

### New

* Added a refreshed creator onboarding experience, including a guided "Almost there" questionnaire and updated Getting started pages for creator and community setup.
* Added PayPal-verified selling support, so eligible creators can create products and accept checkout without waiting on Stripe KYC when PayPal is ready.
* Added product approval and denial notifications, helping creators stay informed when product review decisions are made.

### Updates

* Improved checkout payment-method availability for PayPal and Stripe, including per-currency payment-method filtering and on-demand refreshes when creator payment settings change.
* Improved checkout payment presentation by showing the Stripe Payment Element earlier and reducing iframe remount issues in hosted checkout.
* Improved creator product creation after first-business setup, reducing false "failed to load" states while account data finishes syncing.
* Improved community calendar presentation with updated layouts, event dialogs, navigation, and localized calendar copy.
* Improved subscription management copy, including clearer cancellation status labels and close-button wording.
* Improved support chat localization so the COPE messenger follows the active account language.

### Fixes

* Fixed offer expiry handling so lapsed offers show as expired consistently in creator views and public offer responses.
* Fixed buyer phone collection so checkout hints match the selected country and phone numbers appear on receipts, invoices, and refund confirmations when collected.
* Fixed subscription checkout for products without trials, preventing no-trial purchases from being processed or emailed as trial subscriptions.
* Fixed subscription emails so they use the creator business brand instead of generic placeholder sender copy.
* Fixed German reduced-rate VAT calculation and display so checkout, invoices, receipts, and subscription updates use exact statutory rates.
* Fixed Stripe onboarding edge cases that could show outdated KYC status or request deprecated capabilities.
* Fixed checkout setup for long business website URLs during payment onboarding.

## 2026-07-07

Week of July 7

### New

* Added creator account deletion from settings, including payout-balance checks before an account can be removed.
* Added KYC action guidance in the creator portal and email notifications, so creators can see what needs attention before payouts or account capabilities are affected.
* Added support contact settings, giving creators a dedicated place to manage buyer-facing support details.
* Added subscription payment reminder emails for overdue or upcoming subscription payments.
* Added self-service VAT liability transfer for eligible Non-ESS products, including a plain-language addendum summary before acceptance.

### Updates

* Improved creator transaction reporting with separate sales and promotion transaction views, plus payment-context details for promotion transactions.
* Improved creator order reporting with separate sales and promotion order views, including promoter-facing vendor and commission context.
* Added product-level promotion performance details, including per-product affiliate links, sales, revenue, and commission context.
* Improved community member management with member directories, admin sorting, clearer filters, and complete localized community strings.
* Improved checkout presentation with live Stripe dark-theme updates, clearer prefilled billing-address behavior, and card-payment support for phone-offer checkouts.
* Improved checkout tax calculation for EU B2C purchases and added country-rate fallbacks when primary tax calculation returns zero.

### Fixes

* Fixed BNPL payment-session eligibility so blocked or stale sessions cannot be reused for checkout.
* Fixed session continuity through the gateway and public API proxy when upstream responses include multiple cookies.
* Fixed invoice PDFs so German buyers see a labeled, sequential invoice number.
* Fixed creator transaction rows so Klarna, Affirm, ACH, SEPA, and other payment methods no longer appear as generic card payments.
* Fixed checkout tax estimates for partial billing addresses in regions where state or province is required.
* Fixed course lesson paragraph spacing in the editor and student lesson view.
* Fixed product image handling so repeated saves do not duplicate uploaded product images.
* Fixed product cards so creators can distinguish products by their internal names.

## 2026-06-30

Week of June 30

### New

* Added public Commerce API documentation for product phone collection, including the `phone_collection` field on product list and retrieve responses.
* Added buyer withdrawal access for eligible EU orders, including receipt email links and Japanese localization.
* Added complete quiz-builder and course-settings translations across supported course locales.

### Updates

* Improved buyer subscription management with clearer cancelled states, recurring-amount labels, next billing dates, pending cancellation visibility, and payment-method update support.
* Improved subscription emails with localized price-change actions, brand footers, payment-plan labels, and Japanese invoice links.
* Improved checkout behavior by making buyer phone validation non-blocking, showing translated guidance for billing intervals over two years, and fitting single product images cleanly in checkout layouts.
* Updated public payment dispute and chargeback webhook schemas to match produced event payloads and keep generated contracts aligned.

### Fixes

* Fixed affiliate invite delivery with corrected invite event contracts and absolute invite links.
* Fixed refreshed community avatars and covers so re-uploaded images appear immediately.
* Removed the defunct EU ODR platform link from public terms pages.

## 2026-06-23

Week of June 23

### New

* Added full phone-offer payment-plan support in checkout, including clearer creator editing, buyer-facing payment schedules, and total plan price disclosure.

### Updates

* Persisted the buyer-selected checkout language through order creation, so order and payment confirmation emails use the buyer's selected locale.
* Refined creator account routing so buyer-origin accounts that already own a business can access creator tools.
* Simplified creator fee messaging by keeping progress-to-next-tier visible while hiding the next-tier fee rate.
* Improved COPE branding on sign-in and sign-up screens, including crisper logo rendering in Safari.

### Fixes

* Fixed physical-order receipts and invoices so shipping lines appear correctly.
* Fixed creator webhook pages for accounts without an active business by showing a localized, actionable empty state.
* Added missing community translations and hid unavailable community controls to keep public community pages and chat flows consistent.
* Fixed phone-offer checkout display so buyers see the configured installment or recurring plan instead of a one-time fallback.

## 2026-06-16

Week of June 16

### New

* Added a vendor integration quickstart that walks through dashboard setup, checkout installation, webhook confirmation, and launch checks.
* Added Growth Hub promoter management, including a Configure Promoter page, updated affiliate link and promo-code panels, mobile views, and per-product sales and revenue metrics.
* Added a buyer confirmation page and action-required email for subscription cancellations requested on a buyer's behalf, so buyers can confirm before the cancellation is scheduled.
* Published payload contracts for `payment.dispute.opened`, `payment.dispute.won`, and `payment.dispute.lost`, including CloudEvents metadata, schema IDs, payload fields, and example events.
* Added a public changelog page with dated weekly sections so product updates can be scanned in one place.

### Updates

* Refreshed subscription price-change and cancellation-confirmation emails with clearer alert styling, branded footers, aligned calls to action, and production-ready icon assets.
* Moved the COPE logo into the sign-in card for a cleaner, more consistent authentication experience.
* Refined order, sale, and refund webhook pages to describe raw attribution signals such as first-click references, phone offer IDs, and promo codes.
* Simplified docs navigation around live checkout and webhook guides.

### Fixes

* Fixed subscription management and cancellation links in lifecycle emails so buyers land on the correct COPE app environment instead of a legacy marketing domain or the wrong deployment.
* Fixed order and refund receipt emails so subscriptions and installments show the correct localized payment-plan label instead of falling back to one-time payment copy.
* Localized Create Affiliate validation messages so sellers see field errors in their selected language instead of raw English validation defaults.

## 2026-06-09

Week of June 9

### New

* Added ticketing event documentation for scanner and ticket lifecycle work.
* Released Checkout SDK `0.2.0`, including the embedded checkout support needed for iframe-based buyer flows.
* Made buyer subscription management easier to reach, including localized subscription pages and clearer recurring-subscription filtering.

### Updates

* Refreshed generated webhook pages and schema links.
* Improved checkout payment-method handling by hiding BNPL options when the seller country or order amount does not support them.
* Added richer product description editing and buyer rendering, giving product pages a more structured presentation.
* Improved community feed rendering and navigation behavior for creator communities.

### Fixes

* Fixed checkout navigation and deployment reload edge cases that could leave buyers on stale frontend chunks.
* Improved subscription cancellation and price-change messaging so buyers see clearer access dates and localized labels.

## 2026-06-02

Week of June 2

### New

* Added Checkout SDK documentation for redirect checkout, embedded hosted checkout, iframe mount behavior, trusted postMessage events, fallback behavior, and troubleshooting.
* Added terminal checkout and reader management for in-person payment workflows.
* Added buyer refund deadline visibility and credit note access in order views.

### Updates

* Tightened public docs guidance so docs.cope.com stays external-facing.
* Improved checkout success-page handling so confirmation screens rely on trustworthy checkout state instead of ambiguous redirects.
* Improved community navigation by hiding inactive sidebar areas for members.

### Fixes

* Fixed promo-discount presentment totals so buyer-facing totals stay currency-safe.
* Improved localized order payment method labels, including null and unknown fallbacks.
* Hardened realtime community chat recovery after connection drops or browser wakeups.

## 2026-05-26

Week of May 26

### New

* Added the embedded checkout foundation for iframe checkout flows, including SDK support and launch-oriented integration guidance.
* Added Japanese checkout locale support and dashboard controls for checkout locale allowlists.
* Added a daily payout cadence option for creators.

### Updates

* Improved checkout currency presentation across product pages, buyer-selected currencies, and payment plan labels.
* Improved affiliate and promo-code workflows, including product-specific affiliate links and clearer promotion management.
* Added Japanese buyer-journey translations and more complete localized checkout/payment method copy.

### Fixes

* Fixed iframe checkout framing headers so approved embedded checkout origins can render correctly.
* Fixed stale plan-currency handling and presentment metadata so checkout totals stay aligned with server-calculated prices.
* Fixed Intercom Messenger identity handling for authenticated users.

## 2026-05-19

Week of May 19

### New

* Introduced the COPE brand across public-facing surfaces.
* Added the foundation for hosted checkout iframe work, including iframe stability checks and guarded frame policies.
* Added settings improvements for fees and business identifier copy workflows.

### Updates

* Improved checkout presentment totals by trusting server-calculated repricing in the buyer's selected currency.
* Improved trial-badge display in checkout product summaries.
* Improved affiliate and promo-code management flows, including copy actions and product-link updates.

### Fixes

* Fixed checkout embed ordering issues that could affect iframe flows.
