Migration Guide — v1.0.0

This guide covers breaking changes introduced in v1.0.0 of the Easy SDK packages.

Balance Transfer Operations Removed

Affected packages: @easylabs/react, @easylabs/node, @easylabs/react-native, @easylabs/common

Balance transfer APIs — used to move funds between merchant accounts — have been removed from the SDK surface. This is a semver-major breaking change.

What was removed

API	Package	Reason
createTransfer({ source_account, destination_account })	react, react-native	Balance transfer — now internal

Why

Treasury and account-to-account fund movement is now managed automatically by the Easy platform. Exposing these operations through the SDK was error-prone and unnecessary for the vast majority of integrations.

Migration steps

1. Remove calls to balance transfer createTransfer

If you were calling createTransfer with source_account / destination_account parameters to move funds between merchant accounts, remove those calls. The Easy platform handles this automatically.

// ❌ Remove — no longer supported
await createTransfer({
  source_account: "acct_123",
  destination_account: "acct_456",
  amount: 5000,
  currency: "usd",
});

2. For customer payment processing, use checkout

Standard payment charging (charging a customer's payment instrument) is handled by checkout:

// ✅ Use checkout for customer payments
const { checkout } = useEasy(); // React / React Native

// or in Node:
const result = await easy.checkout({ ... });

3. Read-only transfer access still works

Viewing transfers (getTransfer, getTransfers) and updating transfer metadata (updateTransfer) are unaffected and continue to work as before.

4. Need payouts or custom settlements?

Contact support@itseasy.co. The Easy platform manages settlements and payouts automatically based on your account configuration.

---

Other Changes in v1.0.0

• Fixed /dispute routes → /disputes (plural) in the Node SDK client
• Added checkoutWithWallet as the canonical wallet checkout method (replaces legacy /wallet/checkout endpoint)
• createWalletCheckout is now deprecated — use checkoutWithWallet instead
• Improved TypeScript type safety in EasyApiClient