[naor-gal]

Summary

Types and docs for shipping on checkouts:

• CreateCheckoutParams.shipping: an optional { address?, amount? }.
  • amount is the shipping fee in minor units, computed by the app's backend.
  • address is one the app collected, needed when the fee depends on it. The provider shows it locked, so the buyer can't change it.
  • Without an address, the provider asks the buyer for one.
• Purchase: gains shipping_address, returned to service role callers only, like metadata, and shipping_amount.
• New exported type: CheckoutShippingAddress.
• Provider support: PayPal one-time checkouts only for now. Stripe, Wix Payments and PayPal subscriptions reject shipping with invalid_request.

Notes

• No runtime change: createCheckout already sends its params as-is.
• Merge timing: merge once the API accepts shipping, since it rejects the field as unknown until then.

Testing

Type-only change; tsc and the existing unit tests pass in CI.

🤖 Generated with Claude Code

[github-actions]

🚀 Package Preview Available!

---

Install this PR's preview build with npm:

npm i @base44-preview/sdk@0.8.56-pr.350.bba16c2

Prefer not to change any import paths? Install using npm alias so your code still imports @base44/sdk:

npm i "@base44/sdk@npm:@base44-preview/sdk@0.8.56-pr.350.bba16c2"

Or add it to your package.json dependencies:

{
  "dependencies": {
    "@base44/sdk": "npm:@base44-preview/sdk@0.8.56-pr.350.bba16c2"
  }
}

• 📦 Preview Package: @base44-preview/sdk@0.8.56-pr.350.bba16c2
• 🔗 View this commit on GitHub

---

_{Preview published to npm registry — try new features instantly!}