{
  "api": "AtlasPay Merchant API",
  "current_version": "2026-10-20",
  "entries": [
    {
      "version": "2026-10-20",
      "date": "2026-10-20",
      "type": "feature",
      "breaking": false,
      "changes": [
        "Added GET /v1/withdrawals/by-idempotency-key with the required original X-AtlasPay-Idempotency-Key header for merchant-scoped, read-only withdrawal recovery.",
        "The lookup never creates, reserves, approves, signs or broadcasts and returns the existing Withdrawal across all statuses.",
        "A 404 only means no committed match is visible at query time; preserve unresolved status and do not resubmit solely because of 404, timeout or 503."
      ]
    },
    {
      "version": "2026-08-02",
      "date": "2026-08-02",
      "type": "feature",
      "breaking": false,
      "changes": [
        "Added optional integration_mode=checkout|exchange_wallet|hybrid to AI merchant onboarding.",
        "Preserved checkout as the default when integration_mode is omitted.",
        "Added mode-specific AI integration prompts and exchange-wallet live readiness without checkout creation.",
        "Published AI discovery guidance at /llms.txt and a canonical well-known OpenAPI redirect."
      ]
    },
    {
      "version": "2026-07-22",
      "date": "2026-07-22",
      "type": "documentation",
      "breaking": false,
      "changes": [
        "Separated the platform-supported asset catalog from per-merchant asset enrollment; custom tokens are now opt-in.",
        "Added POST /v1/wallet-asset-enrollments and merchant_enabled/default_for_new_merchants policy fields.",
        "Restricted wallet, checkout, withdrawal and active RPC monitoring to assets enabled for the authenticated merchant.",
        "Documented X-AtlasPay-Idempotency-Key for retry-safe order and withdrawal creation, including replay and 409 conflict behavior.",
        "Completed webhook transport-event, payload-field, casing and delivery-idempotency contracts.",
        "Aligned fee quote documentation with native gas assets TRX, BNB and SOL and retained the no-quote-id flow.",
        "Clarified that Polygon is sunset for new funds operations and that Solana public-live scope is limited to SOLANA-SOL and SOLANA-USDT.",
        "Added checkout_mode and accepted_assets to the documented order request."
      ]
    },
    {
      "version": "2026-07-21",
      "date": "2026-07-21",
      "type": "feature",
      "breaking": false,
      "changes": [
        "Enabled SOLANA-SOL and SOLANA-USDT checkout, collection and withdrawal policies.",
        "Added distributed 3-of-5 EdDSA signing for Solana transactions.",
        "Added SPL associated-token-account creation, automatic SOL gas funding and confirmation inspection.",
        "Added Solana withdrawal fee policies denominated in SOL."
      ]
    },
    {
      "version": "2026-07-20",
      "date": "2026-07-20",
      "type": "documentation",
      "breaking": false,
      "changes": [
        "Published the machine-readable OpenAPI 3.1 contract at /v1/openapi.json.",
        "Published a public English developer reference and webhook payload catalog.",
        "Documented HTTP error behavior, fixed-point amount rules, supported withdrawal assets, and retry guidance.",
        "Added contract tests that validate required public paths, fee quote fields, and webhook schemas."
      ]
    },
    {
      "version": "2026-07-19.2",
      "date": "2026-07-19",
      "type": "fix",
      "breaking": false,
      "changes": [
        "Added POST /v1/withdrawal-fee-quote.",
        "Separated token withdrawal fees from native gas budgets.",
        "Withdrawal creation now stores a fee policy snapshot.",
        "Rejected unsupported amount precision and zero-net withdrawals before funds are locked."
      ]
    },
    {
      "version": "2026-07-18",
      "date": "2026-07-18",
      "type": "hardening",
      "breaking": false,
      "changes": [
        "Clarified order-address attribution and long-term deposit-address identity.",
        "Documented wallet.deposit.confirmed idempotency fields.",
        "Marked Solana withdrawals and collection as unavailable until signing is live."
      ]
    }
  ]
}