Skip to main content

​
API Changelog

Track all API version changes, new endpoints, deprecations, and breaking changes.

​
2025-01-15 - V3 Products API

  • Added: POST /api/v3/products - Create products with Stripe-compatible schema.
  • Added: package_dimensions, shippable, statement_descriptor, and tax_code fields to product creation.
  • Added: Support for amountType field with FIXED, CUSTOM, and FREE pricing options.
  • Changed: Product images field now accepts up to 8 URLs instead of 1.
  • Added: POST /api/v2/payment-links - Create payment links with multiple products.
  • Added: successUrl parameter for custom redirect after successful payment.
  • Added: productIds array parameter to attach multiple products to a payment link.
  • Improved: GET /api/v2/payment-links now supports filtering by status and pricingType.

​
2025-01-08 - Checkout Sessions V2

  • Added: metadata parameter to POST /api/v2/checkout/sessions (max 50 key-value pairs).
  • Added: externalCustomerId parameter for linking sessions to your user IDs.
  • Added: expiresAt field in checkout session responses.
  • Changed: Session expiration reduced from 24 hours to 1 hour for better security.

​
2025-01-05 - Products V2 Enhancements

  • Added: GET /api/v2/products pagination with limit and offset parameters.
  • Added: recurringInterval field supporting month and year values for subscriptions.
  • Added: minimumAmount and presetAmount fields for custom pricing.
  • Improved: Product filtering now supports date range queries with createdAfter and createdBefore.

​
2025-01-01 - Webhooks Enhancement

  • Added: New webhook event checkout.session.expired for abandoned cart tracking.
  • Added: loops-signature header for webhook signature verification using HMAC SHA-256.
  • Changed: Webhook retry logic now uses exponential backoff (3 retries max).
  • Improved: Webhook event payload now includes completedAt timestamp for completed sessions.

​
2024-12-28 - Rate Limiting

  • Added: Rate limiting headers: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset.
  • Changed: Default rate limit set to 100 requests per minute per API key.
  • Added: 429 status code responses now include Retry-After header.

​
2024-12-20 - Error Handling Improvements

  • Improved: Error responses now include details array with field-level validation errors.
  • Added: New error codes: invalid_metadata, payment_link_inactive, session_expired.
  • Changed: 400 Bad Request responses now provide more descriptive error messages.

​
2024-12-15 - V2 API General Availability

  • Released: V2 API endpoints for checkout sessions, products, and payment links.
  • Added: updatedAt timestamp field on all V2 resources.
  • Deprecated: V1 checkout session endpoints (still supported, removal planned for 2025-06-01).

​
2025-08-23

  • Added: Meta Conversions API integration and Meta Pixel management.
  • Improved: Standardized Meta test-event handling; default user agent and event source URL now included for test events.
  • Fixed: Test event description now renders correctly using HTML entities.

​
2025-08-22

  • Fixed: Legacy responses now supported in Payment Links fetching.

​
2025-08-14

  • Checkout: Simplified creation by removing embed code/theme selection; discount/billing/metadata fields removed from Checkout Links.

​
2025-08-13

  • Integrations: Slack webhook formatting for multiple event types; Umami tracking script integrated.
⌘I