Merge pull request #21 from Kixo/branch_from_version_0_1_15

Version 0.1.16 - 2025-09-15 14:28:37

Author: Kixo

package.json

@@ -1,6 +1,6 @@
 {
   "name": "tailwind-plus-icpay",
-  "version": "0.1.15",
+  "version": "0.1.16",
   "private": true,
   "packageManager": "pnpm@9.12.3",
   "scripts": {

src/app/errors/page.mdx

@@ -11,7 +11,7 @@ All SDK errors are `IcpayError` with a machine code and message.
 import { Icpay, IcpayError } from '@ic-pay/icpay-sdk'
 
 try {
-  await icpay.sendFunds({ symbol: 'ICP', amount: '1000' })
+  await icpay.createPayment({ symbol: 'ICP', amount: '1000' })
 } catch (e) {
   if (e instanceof IcpayError) {
     if (e.isBalanceError()) {
@@ -27,7 +27,7 @@ try {
 
 | Code | Category | Description | What to do |
 |---|---|---|---|
-| WALLET_NOT_CONNECTED | Wallet | A wallet/principal is required but not connected (e.g., before calling `sendFunds`). | Ask the user to connect their wallet; provide an `actorProvider` and `connectedWallet`.
+| WALLET_NOT_CONNECTED | Wallet | A wallet/principal is required but not connected (e.g., before calling `createPayment`). | Ask the user to connect their wallet; provide an `actorProvider` and `connectedWallet`.
 | WALLET_CONNECTION_FAILED | Wallet | Failed to connect to the selected wallet provider. | Offer retry or let the user pick another provider.
 | WALLET_DISCONNECTED | Wallet | Wallet was disconnected mid-flow. | Reconnect and restart the action.
 | WALLET_SIGNATURE_REJECTED | Wallet | User rejected the signature prompt. | Treat as user cancel; allow retry.

src/app/page.mdx

@@ -32,7 +32,7 @@ Use the ICPay SDK to accept payments from users' wallets and manage your account
 
 The ICPay SDK ships as a single package that supports two usage modes. Use the public SDK on the frontend with your Publishable Key; use the private SDK on the server with your Secret Key. {{ className: 'lead' }}
 
-**Public SDK (frontend)**: Initialize with `publishableKey` for typical tasks like getting verified ledgers, resolving canister IDs, price calculation, and initiating payments from the user's wallet via `sendFunds`/`sendFundsUsd`.
+**Public SDK (frontend)**: Initialize with `publishableKey` for typical tasks like getting verified ledgers, resolving canister IDs, price calculation, and initiating payments from the user's wallet via `createPayment`/`createPaymentUsd`.
 
 **Private SDK (server)**: Initialize with `secretKey` for account details, payment history, transactions, ledgers with prices for your account, webhook event lookups, and other server-side operations.
 

src/app/sdk-overview/page.mdx

@@ -24,7 +24,7 @@ The ICPay SDK ships as a single package that supports two usage modes. Use the p
 ## Public SDK (frontend)
 
 - Initialize with `publishableKey`.
-- Typical tasks: get verified ledgers, resolve canister IDs, price calculation, and initiate payments from the user’s wallet via `sendFunds`/`sendFundsUsd` (requires wallet + actor provider).
+- Typical tasks: get verified ledgers, resolve canister IDs, price calculation, and initiate payments from the user’s wallet via `createPayment`/`createPaymentUsd` (requires wallet + actor provider).
 - See: [Public SDK guide](/sdk)
 
 ## Private SDK (server)

src/app/sdk/page.mdx

@@ -31,7 +31,7 @@ Create an account in the [icpay.org dashboard](/icpay-org) to obtain your Publis
 
 ## Quickstart
 
-Initialize the SDK with your publishable key on the client. Only when using `sendFunds` or `sendFundsUsd`, you must provide an `actorProvider` and a connected wallet.
+Initialize the SDK with your publishable key on the client. Only when using `createPayment` or `createPaymentUsd`, you must provide an `actorProvider` and a connected wallet.
 
 ```ts {{ title: 'Client setup (TypeScript)' }}
 import { Icpay, IcpayError } from '@ic-pay/icpay-sdk'
@@ -40,7 +40,7 @@ const icpay = new Icpay({
   publishableKey: process.env.NEXT_PUBLIC_ICPAY_PK!,
 
   // actorProvider + connected wallet are required only when calling
-  // sendFunds or sendFundsUsd (e.g. Plug, Internet Identity, Oisy)
+  // createPayment or createPaymentUsd (e.g. Plug, Internet Identity, Oisy)
 })
 
 try {
@@ -65,14 +65,14 @@ const icpay = new Icpay({
   connectedWallet: { owner: '<principal-id>' },
 })
 
-// We can send either symbol or ledgerCanisterId field to the sendFunds and sendFundsUsd (symbol is preferred)
+// We can send either symbol or ledgerCanisterId field to the createPayment and createPaymentUsd (symbol is preferred)
 const ledgers = await icpay.getVerifiedLedgers()
 const icpLedger = ledgers.find(l => l.symbol === 'ICP')!
 let ledgerCanisterId = icpLedger.canisterId
 // or
 // ledgerCanisterId = await icpay.getLedgerCanisterIdBySymbol('ICP')
 
-const tx = await icpay.sendFunds({
+const tx = await icpay.createPayment({
   ledgerCanisterId, // ICP ledger or any ICRC ledger
   symbol: 'ICP', // Its either symbol or ledgerCanisterId (symbol is preferred)
   amount: '150000000', // smallest unit (e.g. 1.5 ICP with 8 decimals)
@@ -81,7 +81,7 @@ const tx = await icpay.sendFunds({
 ```
 
 ```ts {{ title: 'Send by USD amount (auto conversion)' }}
-const res = await icpay.sendFundsUsd({
+const res = await icpay.createPaymentUsd({
   usdAmount: 5,
   ledgerCanisterId,
   symbol: 'ICP', // Its either symbol or ledgerCanisterId (symbol is preferred)
@@ -101,7 +101,7 @@ import { Icpay } from '@ic-pay/icpay-sdk'
 const icpay = new Icpay({ publishableKey: process.env.NEXT_PUBLIC_ICPAY_PK!, enableEvents: true })
 
 // 1) Create intent for onramp (no wallet needed)
-const start = await icpay.sendFundsUsd({
+const start = await icpay.createPaymentUsd({
   usdAmount: 25,
   symbol: 'ICP',
   metadata: { context: 'onramp' },

src/app/widget/components/pay-button/page.mdx

@@ -120,7 +120,7 @@ Notes:
 
 Enable card onramp from the wallet selector by configuring `onramp` and handle the success event. The component will:
 
-- Create an onramp intent via the SDK (`sendFundsUsd` with `onrampPayment: true`).
+- Create an onramp intent via the SDK (`createPaymentUsd` with `onrampPayment: true`).
 - Open Transak using the returned `sessionId`.
 - Close the Transak modal on `TRANSAK_ORDER_SUCCESSFUL` and start notifying ICPay until completion.