@bitpal/checkout 0.6.0 → 0.7.0

package/README.md

@@ -63,10 +63,16 @@ shows the per-order deposit address + QR, and confirms the payment on-chain.
 ```ts
 const { data: session } = await bitpal.checkout.createSession({
   line_items: [
-    { name: 'Pro Plan', amount: '29', currency: 'USDC' },  // just the USD number
+    { name: 'Pro Plan', amount: '29', currency: 'USDC' },  // `currency` = price denomination (USD via USDC)
+  ],
+  // Payment options the buyer may choose — (chain, token) pairs. Mix tokens freely.
+  //   `chain` accepts a short-name ('base' | 'arbitrum' | 'bnb' | 'tron' | 'solana') or a CAIP-2 id;
+  //   it resolves to the right testnet/mainnet chain for your mode (test vs live key) automatically.
+  allowed_assets: [
+    { chain: 'base',   token: 'USDC' },
+    { chain: 'tron',   token: 'USDT' },
+    { chain: 'solana', token: 'USDC' },
   ],
-  pay_chain: 'eip155:84532',     // Base Sepolia (test mode). Live mode: 'eip155:8453' (Base mainnet).
-                                 // Or use allowed_pay_chains for a buyer-picked chain.
   expires_in_seconds: 1800,
   success_url: 'https://yourstore.com/thanks',
 });
@@ -75,7 +81,13 @@ const { data: session } = await bitpal.checkout.createSession({
 redirect(session.checkout_url!);
 ```
 
-`pay_chain` (single fixed chain) and `allowed_pay_chains` (buyer picks) are mutually exclusive.
+**Setting the payment options** (precedence, highest first):
+
+- **`allowed_assets`** — `(chain, token)` cells. The standard, most explicit way; the buyer picks any listed pair (lets you mix tokens, e.g. USDC on Base + USDT on Tron).
+- `allowed_pay_chains: string[]` — shorthand for "the line-item `currency` across these chains" (one token, many chains).
+- `pay_chain: string` — a single fixed chain, no buyer choice.
+
+`pay_chain` and `allowed_pay_chains` are mutually exclusive; `allowed_assets` takes precedence over both. Omit all three and it defaults to **one chain × the line-item currency**. `currency` on the line item is always the **price denomination** (what the amount is quoted in) — independent of which token the buyer pays with.
 
 ### Self-hosted flow: issue a deposit address yourself
 
@@ -89,7 +101,7 @@ const { data } = await bitpal.checkout.issueDepositAddress(session.id, {
   session_token: session.session_token!, // from createSession
   refundAddress: '0xBuyerWallet...',      // VM-matched (EVM 0x… / Tron T… / Solana base58); committed, immutable after issuance
   chain: 'eip155:84532',                  // match the session's chain (test: Base Sepolia / live: eip155:8453).
-                                          // only needed for multi-option (allowed_pay_chains) sessions
+                                          // only needed for multi-option (allowed_assets / allowed_pay_chains) sessions
   token: 'USDC',
 });
 

package/dist/index.cjs

@@ -214,7 +214,11 @@ var BitPalCheckoutClient = class {
     if (params.pay_chain && params.allowed_pay_chains && params.allowed_pay_chains.length > 0) {
       throw new Error("[BitPal] pay_chain and allowed_pay_chains are mutually exclusive \u2014 use only one.");
     }
-    const body = { ...params, line_items: params.line_items.map(validateLineItem) };
+    const body = {
+      ...params,
+      line_items: params.line_items.map(validateLineItem),
+      ...params.allowed_assets ? { allowed_assets: params.allowed_assets.map((a) => ({ caip2: a.chain, token: a.token })) } : {}
+    };
     const res = await this.request(
       "POST",
       "/v1/checkout/sessions",

package/dist/index.d.cts

@@ -67,6 +67,17 @@ interface CreateSessionParams {
      * 예: ['eip155:84532', 'eip155:11155420', 'eip155:80002', 'eip155:421614']
      */
     allowed_pay_chains?: string[];
+    /**
+     * chain×token cell 허용 목록(**결제 수단** 표준 입력) — buyer 가 (체인, 토큰) 조합을 고른다.
+     * allowed_pay_chains(×단일 currency shorthand)보다 우선. 서로 다른 토큰을 섞을 때 사용.
+     * `chain` 은 short-name('base','tron','solana') 또는 CAIP-2 둘 다 허용(서버가 mode-relative 로 정규화).
+     * paymentLinks.allowed_assets 와 동일 형태(SDK 일관).
+     * 예: [{ chain: 'base', token: 'USDC' }, { chain: 'tron', token: 'USDT' }]
+     */
+    allowed_assets?: Array<{
+        chain: string;
+        token: string;
+    }>;
     /** 결제 자산 (예: USDC) */
     pay_asset?: string;
     /** 허용 오차 (%, 기본값: 2.00) */

package/dist/index.d.ts

@@ -67,6 +67,17 @@ interface CreateSessionParams {
      * 예: ['eip155:84532', 'eip155:11155420', 'eip155:80002', 'eip155:421614']
      */
     allowed_pay_chains?: string[];
+    /**
+     * chain×token cell 허용 목록(**결제 수단** 표준 입력) — buyer 가 (체인, 토큰) 조합을 고른다.
+     * allowed_pay_chains(×단일 currency shorthand)보다 우선. 서로 다른 토큰을 섞을 때 사용.
+     * `chain` 은 short-name('base','tron','solana') 또는 CAIP-2 둘 다 허용(서버가 mode-relative 로 정규화).
+     * paymentLinks.allowed_assets 와 동일 형태(SDK 일관).
+     * 예: [{ chain: 'base', token: 'USDC' }, { chain: 'tron', token: 'USDT' }]
+     */
+    allowed_assets?: Array<{
+        chain: string;
+        token: string;
+    }>;
     /** 결제 자산 (예: USDC) */
     pay_asset?: string;
     /** 허용 오차 (%, 기본값: 2.00) */

package/dist/index.js

@@ -165,7 +165,11 @@ var BitPalCheckoutClient = class {
     if (params.pay_chain && params.allowed_pay_chains && params.allowed_pay_chains.length > 0) {
       throw new Error("[BitPal] pay_chain and allowed_pay_chains are mutually exclusive \u2014 use only one.");
     }
-    const body = { ...params, line_items: params.line_items.map(validateLineItem) };
+    const body = {
+      ...params,
+      line_items: params.line_items.map(validateLineItem),
+      ...params.allowed_assets ? { allowed_assets: params.allowed_assets.map((a) => ({ caip2: a.chain, token: a.token })) } : {}
+    };
     const res = await this.request(
       "POST",
       "/v1/checkout/sessions",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bitpal/checkout",
-  "version": "0.6.0",
+  "version": "0.7.0",
   "description": "BitPal Checkout SDK — non-custodial crypto checkout: create sessions, issue per-order deposit addresses, poll status, verify signed webhooks.",
   "license": "MIT",
   "repository": {