@rozoai/intent-common 0.1.5 → 0.1.6-beta.1

package/dist/api/fee.d.ts

@@ -1,5 +1,5 @@
 import { ApiResponse } from "./base";
-import { FeeType } from "./payment";
+import { FeeType } from "./types";
 /**
  * Fee response data type (success case)
  */

package/dist/api/fee.js

@@ -2,7 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getFee = void 0;
 const chain_1 = require("../chain");
-const payment_1 = require("./payment");
+const types_1 = require("./types");
 /**
  * Gets fee calculation for a payment amount
  * @param params - Fee calculation parameters (amount is required)
@@ -15,7 +15,7 @@ const getFee = async (params) => {
         const toChainName = chain.name.toLowerCase();
         const queryParams = new URLSearchParams({
             ...(appId ? { appId } : {}),
-            ...(type === payment_1.FeeType.ExactIn
+            ...(type === types_1.FeeType.ExactIn
                 ? { type: "exactIn" }
                 : { type: "exactOut" }),
             amount: toUnits,

package/dist/api/fee.js.map

@@ -1 +1 @@
-{"version":3,"file":"fee.js","sourceRoot":"","sources":["../../src/api/fee.ts"],"names":[],"mappings":";;;AAAA,oCAAwC;AAExC,uCAAoC;AAwCpC;;;;GAIG;AACI,MAAM,MAAM,GAAG,KAAK,EACzB,MAAoB,EACmB,EAAE;IACzC,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,GAAG,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,MAAM,CAAC;IAEpE,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,IAAA,oBAAY,EAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;QAC5C,MAAM,WAAW,GAAG,KAAK,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;QAE7C,MAAM,WAAW,GAAG,IAAI,eAAe,CAAC;YACtC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC3B,GAAG,CAAC,IAAI,KAAK,iBAAO,CAAC,OAAO;gBAC1B,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE;gBACrB,CAAC,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC;YACzB,MAAM,EAAE,OAAO;YACf,QAAQ;YACR,OAAO,EAAE,WAAW;SACrB,CAAC,CAAC;QAEH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAC1B,oCAAoC,WAAW,CAAC,QAAQ,EAAE,EAAE,CAC7D,CAAC;QAEF,MAAM,IAAI,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAmC,CAAC;QAEvE,sCAAsC;QACtC,IAAI,CAAC,QAAQ,CAAC,EAAE,IAAI,OAAO,IAAI,IAAI,EAAE,CAAC;YACpC,MAAM,SAAS,GAAG,IAAoB,CAAC;YACvC,OAAO;gBACL,IAAI,EAAE,IAAI;gBACV,KAAK,EAAE,IAAI,KAAK,CAAC,SAAS,CAAC,OAAO,IAAI,SAAS,CAAC,KAAK,CAAC;gBACtD,MAAM,EAAE,QAAQ,CAAC,MAAM;aACxB,CAAC;QACJ,CAAC;QAED,OAAO;YACL,IAAI,EAAE,IAAuB;YAC7B,KAAK,EAAE,IAAI;YACX,MAAM,EAAE,QAAQ,CAAC,MAAM;SACxB,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO;YACL,IAAI,EAAE,IAAI;YACV,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAChE,MAAM,EAAE,IAAI;SACb,CAAC;IACJ,CAAC;AACH,CAAC,CAAC;AA/CW,QAAA,MAAM,UA+CjB"}
+{"version":3,"file":"fee.js","sourceRoot":"","sources":["../../src/api/fee.ts"],"names":[],"mappings":";;;AAAA,oCAAwC;AAExC,mCAAkC;AAwClC;;;;GAIG;AACI,MAAM,MAAM,GAAG,KAAK,EACzB,MAAoB,EACmB,EAAE;IACzC,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,GAAG,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,MAAM,CAAC;IAEpE,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,IAAA,oBAAY,EAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;QAC5C,MAAM,WAAW,GAAG,KAAK,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;QAE7C,MAAM,WAAW,GAAG,IAAI,eAAe,CAAC;YACtC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC3B,GAAG,CAAC,IAAI,KAAK,eAAO,CAAC,OAAO;gBAC1B,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE;gBACrB,CAAC,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC;YACzB,MAAM,EAAE,OAAO;YACf,QAAQ;YACR,OAAO,EAAE,WAAW;SACrB,CAAC,CAAC;QAEH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAC1B,oCAAoC,WAAW,CAAC,QAAQ,EAAE,EAAE,CAC7D,CAAC;QAEF,MAAM,IAAI,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAmC,CAAC;QAEvE,sCAAsC;QACtC,IAAI,CAAC,QAAQ,CAAC,EAAE,IAAI,OAAO,IAAI,IAAI,EAAE,CAAC;YACpC,MAAM,SAAS,GAAG,IAAoB,CAAC;YACvC,OAAO;gBACL,IAAI,EAAE,IAAI;gBACV,KAAK,EAAE,IAAI,KAAK,CAAC,SAAS,CAAC,OAAO,IAAI,SAAS,CAAC,KAAK,CAAC;gBACtD,MAAM,EAAE,QAAQ,CAAC,MAAM;aACxB,CAAC;QACJ,CAAC;QAED,OAAO;YACL,IAAI,EAAE,IAAuB;YAC7B,KAAK,EAAE,IAAI;YACX,MAAM,EAAE,QAAQ,CAAC,MAAM;SACxB,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO;YACL,IAAI,EAAE,IAAI;YACV,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAChE,MAAM,EAAE,IAAI;SACb,CAAC;IACJ,CAAC;AACH,CAAC,CAAC;AA/CW,QAAA,MAAM,UA+CjB"}

package/dist/api/payment.d.ts

@@ -1,292 +1,5 @@
 import { ApiResponse, ApiVersion } from "./base";
-/**
- * FeeType, Fee calculation type:
- * - exactIn (default): Fee deducted from input, recipient receives amount - fee
- * - exactOut: Fee added to input, recipient receives exact amount
- */
-export declare enum FeeType {
-    ExactIn = "exactIn",
-    ExactOut = "exactOut"
-}
-/**
- * PaymentStatus, Payment status
- */
-export declare enum PaymentStatus {
-    PaymentBounced = "payment_bounced",
-    PaymentCompleted = "payment_completed",
-    PaymentExpired = "payment_expired",
-    PaymentPayinCompleted = "payment_payin_completed",
-    PaymentPayoutCompleted = "payment_payout_completed",
-    PaymentRefunded = "payment_refunded",
-    PaymentStarted = "payment_started",
-    PaymentUnpaid = "payment_unpaid"
-}
-/**
- * PaymentErrorCode, Error code (only present when status is payment_bounced)
- */
-export declare enum PaymentErrorCode {
-    AmountTooHigh = "amountTooHigh",
-    AmountTooLow = "amountTooLow",
-    ChainUnavailable = "chainUnavailable",
-    InsufficientLiquidity = "insufficientLiquidity",
-    InvalidRecipient = "invalidRecipient",
-    MissingTrustline = "missingTrustline",
-    NetworkError = "networkError",
-    ProviderError = "providerError",
-    ServiceMaintenance = "serviceMaintenance"
-}
-/**
- * DestinationRequest
- */
-export interface DestinationRequest {
-    /**
-     * Receive amount (required for type=exactOut).
-     * For exactIn, this field is omitted in request and calculated in response.
-     */
-    amount?: string;
-    chainId: number;
-    /**
-     * Final recipient's wallet address
-     */
-    receiverAddress: string;
-    /**
-     * Memo for Stellar/Solana destinations
-     */
-    receiverMemo?: string;
-    /**
-     * Override default token address
-     */
-    tokenAddress?: string;
-    tokenSymbol: string;
-    [property: string]: any;
-}
-/**
- * DisplayInfo
- */
-export interface DisplayInfo {
-    /**
-     * Display currency
-     */
-    currency: string;
-    /**
-     * Detailed description
-     */
-    description?: string;
-    /**
-     * Short title
-     */
-    title: string;
-    [property: string]: any;
-}
-/**
- * SourceRequest
- */
-export interface SourceRequest {
-    /**
-     * Pay-in amount (required for type=exactIn).
-     * For exactOut, this field is omitted in request and calculated in response.
-     */
-    amount?: string;
-    chainId: number;
-    /**
-     * Override default token address
-     */
-    tokenAddress?: string;
-    tokenSymbol: string;
-    [property: string]: any;
-}
-/**
- * PaymentRequest
- */
-export interface CreatePaymentRequest {
-    /**
-     * Your application ID
-     */
-    appId: string;
-    destination: DestinationRequest;
-    display: DisplayInfo;
-    /**
-     * Custom metadata (max 4 KB recommended)
-     */
-    metadata?: {
-        [key: string]: any;
-    };
-    /**
-     * Your order reference ID (for idempotency)
-     */
-    orderId?: string;
-    source: SourceRequest;
-    type?: FeeType;
-    /**
-     * Secret for HMAC-SHA256 signature verification.
-     * If not provided, a unique secret is auto-generated.
-     * The secret is returned in the response for you to store and use for verification.
-     */
-    webhookSecret?: string;
-    /**
-     * URL to receive payment status updates
-     */
-    webhookUrl?: string;
-    [property: string]: any;
-}
-/**
- * DestinationResponse
- */
-export interface DestinationResponse {
-    /**
-     * Amount to be sent to recipient
-     */
-    amount?: string;
-    chainId?: number;
-    /**
-     * Withdrawal confirmation time
-     */
-    confirmedAt?: Date;
-    /**
-     * Final recipient's wallet
-     */
-    receiverAddress?: string;
-    /**
-     * Memo for Stellar/Solana
-     */
-    receiverMemo?: string;
-    /**
-     * Token contract address
-     */
-    tokenAddress?: string;
-    tokenSymbol?: string;
-    /**
-     * Withdrawal transaction hash
-     */
-    txHash?: string;
-    [property: string]: any;
-}
-/**
- * SourceResponse
- */
-export interface SourceResponse {
-    /**
-     * Amount payer must send
-     */
-    amount?: string;
-    /**
-     * Actual amount received
-     */
-    amountReceived?: string;
-    chainId?: number;
-    /**
-     * Deposit confirmation time
-     */
-    confirmedAt?: Date;
-    /**
-     * Fee amount
-     */
-    fee?: string;
-    /**
-     * Deposit address (where payer sends funds)
-     */
-    receiverAddress?: string;
-    /**
-     * Memo for Stellar/Solana deposits
-     */
-    receiverMemo?: string;
-    /**
-     * Payer's wallet address (populated after deposit)
-     */
-    senderAddress?: string;
-    /**
-     * Token contract address
-     */
-    tokenAddress?: string;
-    tokenSymbol?: string;
-    /**
-     * Deposit transaction hash
-     */
-    txHash?: string;
-    [property: string]: any;
-}
-/**
- * PaymentResponse
- */
-export interface PaymentResponse {
-    /**
-     * Your application ID
-     */
-    appId: string;
-    /**
-     * ISO 8601 timestamp
-     */
-    createdAt: Date;
-    destination: DestinationResponse;
-    display: DisplayInfo;
-    errorCode: PaymentErrorCode | null;
-    /**
-     * ISO 8601 timestamp (when payment expires)
-     */
-    expiresAt: Date;
-    /**
-     * Payment ID
-     */
-    id: string;
-    metadata: {
-        [key: string]: any;
-    } | null;
-    /**
-     * Your order reference ID
-     */
-    orderId: string | null;
-    source: SourceResponse;
-    status: PaymentStatus;
-    type: FeeType;
-    /**
-     * ISO 8601 timestamp
-     */
-    updatedAt: Date;
-    /**
-     * Secret for webhook signature verification.
-     * Only present when webhookUrl was provided in the request.
-     * Store this securely to verify incoming webhook signatures.
-     */
-    webhookSecret: string | null;
-    [property: string]: any;
-}
-/**
- * Parameters for creating a new payment using the new backend interface
- */
-export interface CreateNewPaymentParams {
-    /** App ID for authentication */
-    appId: string;
-    /** Destination chain ID (e.g., 8453 for Base, 900 for Solana, 1500 for Stellar) */
-    toChain: number;
-    /** Destination token address */
-    toToken: string;
-    /** Destination address - Can be EVM, Solana, or Stellar address */
-    toAddress: string;
-    /** Chain ID where user will pay from (e.g., 137 for Polygon, 8453 for Base) */
-    preferredChain: number;
-    /** Token address user will pay with */
-    preferredTokenAddress: string;
-    /** Amount in human-readable units (e.g., "1" for 1 USDC, "0.5" for half a USDC) */
-    toUnits?: string;
-    /** Additional metadata to include */
-    metadata?: Record<string, unknown>;
-    /** Display title for the payment */
-    title?: string;
-    /** Display description for the payment */
-    description?: string;
-    /** Order reference ID (for idempotency) */
-    orderId?: string;
-    /** Fee calculation type (exactIn or exactOut) */
-    feeType?: FeeType;
-    /** Webhook URL to receive payment status updates */
-    webhookUrl?: string;
-    /** Secret for HMAC-SHA256 signature verification */
-    webhookSecret?: string;
-    /** Memo for Stellar/Solana destinations */
-    receiverMemo?: string;
-    /** API version to use (v2 or v4). Defaults to v4 */
-    apiVersion?: ApiVersion;
-}
+import { CreateNewPaymentParams, PaymentResponse } from "./types";
 /**
  * Creates a payment using the new backend interface
  *
@@ -320,3 +33,33 @@ export declare function createPayment(params: CreateNewPaymentParams): Promise<P
  * @returns Promise with payment response
  */
 export declare const getPayment: (paymentId: string, apiVersion?: ApiVersion) => Promise<ApiResponse<PaymentResponse>>;
+/**
+ * Updates the Pay In TxHash for a payment.
+ *
+ * Only available on v2 (not supported on v1).
+ *
+ * @param paymentId - The payment ID to update (e.g., "pay_abc123")
+ * @param txHash - The transaction hash to associate with the payment
+ * @param apiVersion - Optional API version ("v2" or "v4"), defaults to "v4" if not specified
+ * @returns Promise with updated payment response
+ *
+ * Example usage:
+ *   await updatePaymentPayInTxHash("pay_abc123", "0x1234567890abcdef...");
+ */
+export declare const updatePaymentPayInTxHash: (paymentId: string, txHash: string, apiVersion?: ApiVersion) => Promise<ApiResponse<PaymentResponse>>;
+/**
+ * Updates the contact email associated with a payment.
+ *
+ * Allows an admin or integrator to associate or update the email for a given payment so support staff can contact the user.
+ *
+ * Only available on v2/v4 API (not v1).
+ *
+ * @param paymentId - The payment ID to update (e.g., "pay_abc123")
+ * @param email - The contact email to associate with the payment
+ * @param apiVersion - Optional API version ("v2" or "v4"), defaults to "v4" if not specified
+ * @returns Promise with updated payment response
+ *
+ * Example usage:
+ *   await updatePaymentEmail("pay_abc123", "user@example.com")
+ */
+export declare const updatePaymentEmail: (paymentId: string, email: string, apiVersion?: ApiVersion) => Promise<ApiResponse<PaymentResponse>>;

package/dist/api/payment.js

@@ -1,50 +1,12 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getPayment = exports.PaymentErrorCode = exports.PaymentStatus = exports.FeeType = void 0;
+exports.updatePaymentEmail = exports.updatePaymentPayInTxHash = exports.getPayment = void 0;
 exports.createPayment = createPayment;
 const bridge_utils_1 = require("../bridge-utils");
 const chain_1 = require("../chain");
 const token_1 = require("../token");
 const base_1 = require("./base");
-/**
- * FeeType, Fee calculation type:
- * - exactIn (default): Fee deducted from input, recipient receives amount - fee
- * - exactOut: Fee added to input, recipient receives exact amount
- */
-var FeeType;
-(function (FeeType) {
-    FeeType["ExactIn"] = "exactIn";
-    FeeType["ExactOut"] = "exactOut";
-})(FeeType || (exports.FeeType = FeeType = {}));
-/**
- * PaymentStatus, Payment status
- */
-var PaymentStatus;
-(function (PaymentStatus) {
-    PaymentStatus["PaymentBounced"] = "payment_bounced";
-    PaymentStatus["PaymentCompleted"] = "payment_completed";
-    PaymentStatus["PaymentExpired"] = "payment_expired";
-    PaymentStatus["PaymentPayinCompleted"] = "payment_payin_completed";
-    PaymentStatus["PaymentPayoutCompleted"] = "payment_payout_completed";
-    PaymentStatus["PaymentRefunded"] = "payment_refunded";
-    PaymentStatus["PaymentStarted"] = "payment_started";
-    PaymentStatus["PaymentUnpaid"] = "payment_unpaid";
-})(PaymentStatus || (exports.PaymentStatus = PaymentStatus = {}));
-/**
- * PaymentErrorCode, Error code (only present when status is payment_bounced)
- */
-var PaymentErrorCode;
-(function (PaymentErrorCode) {
-    PaymentErrorCode["AmountTooHigh"] = "amountTooHigh";
-    PaymentErrorCode["AmountTooLow"] = "amountTooLow";
-    PaymentErrorCode["ChainUnavailable"] = "chainUnavailable";
-    PaymentErrorCode["InsufficientLiquidity"] = "insufficientLiquidity";
-    PaymentErrorCode["InvalidRecipient"] = "invalidRecipient";
-    PaymentErrorCode["MissingTrustline"] = "missingTrustline";
-    PaymentErrorCode["NetworkError"] = "networkError";
-    PaymentErrorCode["ProviderError"] = "providerError";
-    PaymentErrorCode["ServiceMaintenance"] = "serviceMaintenance";
-})(PaymentErrorCode || (exports.PaymentErrorCode = PaymentErrorCode = {}));
+const types_1 = require("./types");
 /**
  * Creates a payment using the new backend interface
  *
@@ -97,7 +59,7 @@ async function createPayment(params) {
     // Build payment request data matching new backend interface
     const paymentData = {
         appId,
-        type: feeType ?? FeeType.ExactIn,
+        type: feeType ?? types_1.FeeType.ExactIn,
         ...(orderId ? { orderId } : {}),
         source: {
             chainId: sourceChain.chainId,
@@ -165,4 +127,64 @@ const getPayment = (paymentId, apiVersion) => {
     return base_1.apiClient.get(`/payment-api/payments/${paymentId}`);
 };
 exports.getPayment = getPayment;
+/**
+ * Updates the Pay In TxHash for a payment.
+ *
+ * Only available on v2 (not supported on v1).
+ *
+ * @param paymentId - The payment ID to update (e.g., "pay_abc123")
+ * @param txHash - The transaction hash to associate with the payment
+ * @param apiVersion - Optional API version ("v2" or "v4"), defaults to "v4" if not specified
+ * @returns Promise with updated payment response
+ *
+ * Example usage:
+ *   await updatePaymentPayInTxHash("pay_abc123", "0x1234567890abcdef...");
+ */
+const updatePaymentPayInTxHash = async (paymentId, txHash, apiVersion) => {
+    // Set API version if provided
+    if (apiVersion) {
+        (0, base_1.setApiConfig)({ version: apiVersion });
+    }
+    // Only support v2/v4 (not v1)
+    if (apiVersion === "v1") {
+        throw new Error("updatePaymentPayInTxHash is only available on API version v2 or later.");
+    }
+    const endpoint = `/payment-api/payments/${paymentId}/payin`;
+    const payload = {
+        txHash,
+    };
+    return base_1.apiClient.post(endpoint, payload);
+};
+exports.updatePaymentPayInTxHash = updatePaymentPayInTxHash;
+/**
+ * Updates the contact email associated with a payment.
+ *
+ * Allows an admin or integrator to associate or update the email for a given payment so support staff can contact the user.
+ *
+ * Only available on v2/v4 API (not v1).
+ *
+ * @param paymentId - The payment ID to update (e.g., "pay_abc123")
+ * @param email - The contact email to associate with the payment
+ * @param apiVersion - Optional API version ("v2" or "v4"), defaults to "v4" if not specified
+ * @returns Promise with updated payment response
+ *
+ * Example usage:
+ *   await updatePaymentEmail("pay_abc123", "user@example.com")
+ */
+const updatePaymentEmail = async (paymentId, email, apiVersion) => {
+    // Set API version if provided
+    if (apiVersion) {
+        (0, base_1.setApiConfig)({ version: apiVersion });
+    }
+    // Only support v2/v4 (not v1)
+    if (apiVersion === "v1") {
+        throw new Error("updatePaymentEmail is only available on API version v2 or later.");
+    }
+    const endpoint = `/payment-api/payments/${paymentId}/email`;
+    const payload = {
+        email,
+    };
+    return base_1.apiClient.post(endpoint, payload);
+};
+exports.updatePaymentEmail = updatePaymentEmail;
 //# sourceMappingURL=payment.js.map

package/dist/api/payment.js.map

@@ -1 +1 @@
-{"version":3,"file":"payment.js","sourceRoot":"","sources":["../../src/api/payment.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"payment.js","sourceRoot":"","sources":["../../src/api/payment.ts"],"names":[],"mappings":"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"}

package/dist/api/types.d.ts

@@ -0,0 +1,289 @@
+import { ApiVersion } from "./base";
+/**
+ * FeeType, Fee calculation type:
+ * - exactIn (default): Fee deducted from input, recipient receives amount - fee
+ * - exactOut: Fee added to input, recipient receives exact amount
+ */
+export declare enum FeeType {
+    ExactIn = "exactIn",
+    ExactOut = "exactOut"
+}
+/**
+ * PaymentStatus, Payment status
+ */
+export declare enum PaymentStatus {
+    PaymentBounced = "payment_bounced",
+    PaymentCompleted = "payment_completed",
+    PaymentExpired = "payment_expired",
+    PaymentPayinCompleted = "payment_payin_completed",
+    PaymentPayoutCompleted = "payment_payout_completed",
+    PaymentRefunded = "payment_refunded",
+    PaymentStarted = "payment_started",
+    PaymentUnpaid = "payment_unpaid"
+}
+/**
+ * PaymentErrorCode, Error code (only present when status is payment_bounced)
+ */
+export declare enum PaymentErrorCode {
+    AmountTooHigh = "amountTooHigh",
+    AmountTooLow = "amountTooLow",
+    ChainUnavailable = "chainUnavailable",
+    InsufficientLiquidity = "insufficientLiquidity",
+    InvalidRecipient = "invalidRecipient",
+    MissingTrustline = "missingTrustline",
+    NetworkError = "networkError",
+    ProviderError = "providerError",
+    ServiceMaintenance = "serviceMaintenance"
+}
+/**
+ * DestinationRequest
+ */
+export interface DestinationRequest {
+    /**
+     * Receive amount (required for type=exactOut).
+     * For exactIn, this field is omitted in request and calculated in response.
+     */
+    amount?: string;
+    chainId: number;
+    /**
+     * Final recipient's wallet address
+     */
+    receiverAddress: string;
+    /**
+     * Memo for Stellar/Solana destinations
+     */
+    receiverMemo?: string;
+    /**
+     * Override default token address
+     */
+    tokenAddress?: string;
+    tokenSymbol: string;
+    [property: string]: any;
+}
+/**
+ * DisplayInfo
+ */
+export interface DisplayInfo {
+    /**
+     * Display currency
+     */
+    currency: string;
+    /**
+     * Detailed description
+     */
+    description?: string;
+    /**
+     * Short title
+     */
+    title: string;
+    [property: string]: any;
+}
+/**
+ * SourceRequest
+ */
+export interface SourceRequest {
+    /**
+     * Pay-in amount (required for type=exactIn).
+     * For exactOut, this field is omitted in request and calculated in response.
+     */
+    amount?: string;
+    chainId: number;
+    /**
+     * Override default token address
+     */
+    tokenAddress?: string;
+    tokenSymbol: string;
+    [property: string]: any;
+}
+/**
+ * PaymentRequest
+ */
+export interface CreatePaymentRequest {
+    /**
+     * Your application ID
+     */
+    appId: string;
+    destination: DestinationRequest;
+    display: DisplayInfo;
+    /**
+     * Custom metadata (max 4 KB recommended)
+     */
+    metadata?: {
+        [key: string]: any;
+    };
+    /**
+     * Your order reference ID (for idempotency)
+     */
+    orderId?: string;
+    source: SourceRequest;
+    type?: FeeType;
+    /**
+     * Secret for HMAC-SHA256 signature verification.
+     * If not provided, a unique secret is auto-generated.
+     * The secret is returned in the response for you to store and use for verification.
+     */
+    webhookSecret?: string;
+    /**
+     * URL to receive payment status updates
+     */
+    webhookUrl?: string;
+    [property: string]: any;
+}
+/**
+ * DestinationResponse
+ */
+export interface DestinationResponse {
+    /**
+     * Amount to be sent to recipient
+     */
+    amount?: string;
+    chainId?: number;
+    /**
+     * Withdrawal confirmation time
+     */
+    confirmedAt?: Date;
+    /**
+     * Final recipient's wallet
+     */
+    receiverAddress?: string;
+    /**
+     * Memo for Stellar/Solana
+     */
+    receiverMemo?: string;
+    /**
+     * Token contract address
+     */
+    tokenAddress?: string;
+    tokenSymbol?: string;
+    /**
+     * Withdrawal transaction hash
+     */
+    txHash?: string;
+    [property: string]: any;
+}
+/**
+ * SourceResponse
+ */
+export interface SourceResponse {
+    /**
+     * Amount payer must send
+     */
+    amount?: string;
+    /**
+     * Actual amount received
+     */
+    amountReceived?: string;
+    chainId?: number;
+    /**
+     * Deposit confirmation time
+     */
+    confirmedAt?: Date;
+    /**
+     * Fee amount
+     */
+    fee?: string;
+    /**
+     * Deposit address (where payer sends funds)
+     */
+    receiverAddress?: string;
+    /**
+     * Memo for Stellar/Solana deposits
+     */
+    receiverMemo?: string;
+    /**
+     * Payer's wallet address (populated after deposit)
+     */
+    senderAddress?: string;
+    /**
+     * Token contract address
+     */
+    tokenAddress?: string;
+    tokenSymbol?: string;
+    /**
+     * Deposit transaction hash
+     */
+    txHash?: string;
+    [property: string]: any;
+}
+/**
+ * PaymentResponse
+ */
+export interface PaymentResponse {
+    /**
+     * Your application ID
+     */
+    appId: string;
+    /**
+     * ISO 8601 timestamp
+     */
+    createdAt: Date;
+    destination: DestinationResponse;
+    display: DisplayInfo;
+    errorCode: PaymentErrorCode | null;
+    /**
+     * ISO 8601 timestamp (when payment expires)
+     */
+    expiresAt: Date;
+    /**
+     * Payment ID
+     */
+    id: string;
+    metadata: {
+        [key: string]: any;
+    } | null;
+    /**
+     * Your order reference ID
+     */
+    orderId: string | null;
+    source: SourceResponse;
+    status: PaymentStatus;
+    type: FeeType;
+    /**
+     * ISO 8601 timestamp
+     */
+    updatedAt: Date;
+    /**
+     * Secret for webhook signature verification.
+     * Only present when webhookUrl was provided in the request.
+     * Store this securely to verify incoming webhook signatures.
+     */
+    webhookSecret: string | null;
+    [property: string]: any;
+}
+/**
+ * Parameters for creating a new payment using the new backend interface
+ */
+export interface CreateNewPaymentParams {
+    /** App ID for authentication */
+    appId: string;
+    /** Destination chain ID (e.g., 8453 for Base, 900 for Solana, 1500 for Stellar) */
+    toChain: number;
+    /** Destination token address */
+    toToken: string;
+    /** Destination address - Can be EVM, Solana, or Stellar address */
+    toAddress: string;
+    /** Chain ID where user will pay from (e.g., 137 for Polygon, 8453 for Base) */
+    preferredChain: number;
+    /** Token address user will pay with */
+    preferredTokenAddress: string;
+    /** Amount in human-readable units (e.g., "1" for 1 USDC, "0.5" for half a USDC) */
+    toUnits?: string;
+    /** Additional metadata to include */
+    metadata?: Record<string, unknown>;
+    /** Display title for the payment */
+    title?: string;
+    /** Display description for the payment */
+    description?: string;
+    /** Order reference ID (for idempotency) */
+    orderId?: string;
+    /** Fee calculation type (exactIn or exactOut) */
+    feeType?: FeeType;
+    /** Webhook URL to receive payment status updates */
+    webhookUrl?: string;
+    /** Secret for HMAC-SHA256 signature verification */
+    webhookSecret?: string;
+    /** Memo for Stellar/Solana destinations */
+    receiverMemo?: string;
+    /** API version to use (v2 or v4). Defaults to v4 */
+    apiVersion?: ApiVersion;
+}

package/dist/api/types.js

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PaymentErrorCode = exports.PaymentStatus = exports.FeeType = void 0;
+/**
+ * FeeType, Fee calculation type:
+ * - exactIn (default): Fee deducted from input, recipient receives amount - fee
+ * - exactOut: Fee added to input, recipient receives exact amount
+ */
+var FeeType;
+(function (FeeType) {
+    FeeType["ExactIn"] = "exactIn";
+    FeeType["ExactOut"] = "exactOut";
+})(FeeType || (exports.FeeType = FeeType = {}));
+/**
+ * PaymentStatus, Payment status
+ */
+var PaymentStatus;
+(function (PaymentStatus) {
+    PaymentStatus["PaymentBounced"] = "payment_bounced";
+    PaymentStatus["PaymentCompleted"] = "payment_completed";
+    PaymentStatus["PaymentExpired"] = "payment_expired";
+    PaymentStatus["PaymentPayinCompleted"] = "payment_payin_completed";
+    PaymentStatus["PaymentPayoutCompleted"] = "payment_payout_completed";
+    PaymentStatus["PaymentRefunded"] = "payment_refunded";
+    PaymentStatus["PaymentStarted"] = "payment_started";
+    PaymentStatus["PaymentUnpaid"] = "payment_unpaid";
+})(PaymentStatus || (exports.PaymentStatus = PaymentStatus = {}));
+/**
+ * PaymentErrorCode, Error code (only present when status is payment_bounced)
+ */
+var PaymentErrorCode;
+(function (PaymentErrorCode) {
+    PaymentErrorCode["AmountTooHigh"] = "amountTooHigh";
+    PaymentErrorCode["AmountTooLow"] = "amountTooLow";
+    PaymentErrorCode["ChainUnavailable"] = "chainUnavailable";
+    PaymentErrorCode["InsufficientLiquidity"] = "insufficientLiquidity";
+    PaymentErrorCode["InvalidRecipient"] = "invalidRecipient";
+    PaymentErrorCode["MissingTrustline"] = "missingTrustline";
+    PaymentErrorCode["NetworkError"] = "networkError";
+    PaymentErrorCode["ProviderError"] = "providerError";
+    PaymentErrorCode["ServiceMaintenance"] = "serviceMaintenance";
+})(PaymentErrorCode || (exports.PaymentErrorCode = PaymentErrorCode = {}));
+//# sourceMappingURL=types.js.map

package/dist/api/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/api/types.ts"],"names":[],"mappings":";;;AAEA;;;;GAIG;AACH,IAAY,OAGX;AAHD,WAAY,OAAO;IACjB,8BAAmB,CAAA;IACnB,gCAAqB,CAAA;AACvB,CAAC,EAHW,OAAO,uBAAP,OAAO,QAGlB;AAED;;GAEG;AACH,IAAY,aASX;AATD,WAAY,aAAa;IACvB,mDAAkC,CAAA;IAClC,uDAAsC,CAAA;IACtC,mDAAkC,CAAA;IAClC,kEAAiD,CAAA;IACjD,oEAAmD,CAAA;IACnD,qDAAoC,CAAA;IACpC,mDAAkC,CAAA;IAClC,iDAAgC,CAAA;AAClC,CAAC,EATW,aAAa,6BAAb,aAAa,QASxB;AAED;;GAEG;AACH,IAAY,gBAUX;AAVD,WAAY,gBAAgB;IAC1B,mDAA+B,CAAA;IAC/B,iDAA6B,CAAA;IAC7B,yDAAqC,CAAA;IACrC,mEAA+C,CAAA;IAC/C,yDAAqC,CAAA;IACrC,yDAAqC,CAAA;IACrC,iDAA6B,CAAA;IAC7B,mDAA+B,CAAA;IAC/B,6DAAyC,CAAA;AAC3C,CAAC,EAVW,gBAAgB,gCAAhB,gBAAgB,QAU3B"}

package/dist/index.d.ts

@@ -1,6 +1,7 @@
 export { setApiConfig, type ApiVersion } from "./api/base";
 export * from "./api/fee";
 export * from "./api/payment";
+export * from "./api/types";
 export * from "./assert";
 export * from "./bridge-utils";
 export * from "./chain";

package/dist/index.js

@@ -19,6 +19,7 @@ var base_1 = require("./api/base");
 Object.defineProperty(exports, "setApiConfig", { enumerable: true, get: function () { return base_1.setApiConfig; } });
 __exportStar(require("./api/fee"), exports);
 __exportStar(require("./api/payment"), exports);
+__exportStar(require("./api/types"), exports);
 __exportStar(require("./assert"), exports);
 __exportStar(require("./bridge-utils"), exports);
 __exportStar(require("./chain"), exports);

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,mCAA2D;AAAlD,oGAAA,YAAY,OAAA;AACrB,4CAA0B;AAC1B,gDAA8B;AAC9B,2CAAyB;AACzB,iDAA+B;AAC/B,0CAAwB;AACxB,0CAAwB;AACxB,2CAAyB;AACzB,mDAAiC;AACjC,iDAA+B;AAC/B,4CAA0B;AAC1B,0CAAwB;AACxB,wCAAsB;AACtB,+CAA6B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,mCAA2D;AAAlD,oGAAA,YAAY,OAAA;AACrB,4CAA0B;AAC1B,gDAA8B;AAC9B,8CAA4B;AAC5B,2CAAyB;AACzB,iDAA+B;AAC/B,0CAAwB;AACxB,0CAAwB;AACxB,2CAAyB;AACzB,mDAAiC;AACjC,iDAA+B;AAC/B,4CAA0B;AAC1B,0CAAwB;AACxB,wCAAsB;AACtB,+CAA6B"}

package/dist/rozoPay.d.ts

@@ -44,11 +44,11 @@ export declare const zBridgeTokenOutOptions: z.ZodArray<z.ZodObject<{
     token: z.ZodEffects<z.ZodString, `0x${string}`, string>;
     amount: z.ZodEffects<z.ZodEffects<z.ZodString, `${bigint}`, string>, bigint, string>;
 }, "strip", z.ZodTypeAny, {
-    token: `0x${string}`;
     amount: bigint;
+    token: `0x${string}`;
 }, {
-    token: string;
     amount: string;
+    token: string;
 }>, "many">;
 export type BridgeTokenOutOptions = z.infer<typeof zBridgeTokenOutOptions>;
 export declare const zRozoPayOrderMetadata: z.ZodObject<{
@@ -68,14 +68,14 @@ export declare const zRozoPayOrderMetadata: z.ZodObject<{
         price: z.ZodOptional<z.ZodString>;
         priceDetails: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
-        name: string;
         description: string;
+        name: string;
         image?: string | undefined;
         price?: string | undefined;
         priceDetails?: string | undefined;
     }, {
-        name: string;
         description: string;
+        name: string;
         image?: string | undefined;
         price?: string | undefined;
         priceDetails?: string | undefined;
@@ -116,8 +116,8 @@ export declare const zRozoPayOrderMetadata: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     intent: string;
     items: {
-        name: string;
         description: string;
+        name: string;
         image?: string | undefined;
         price?: string | undefined;
         priceDetails?: string | undefined;
@@ -140,8 +140,8 @@ export declare const zRozoPayOrderMetadata: z.ZodObject<{
 }, {
     intent: string;
     items: {
-        name: string;
         description: string;
+        name: string;
         image?: string | undefined;
         price?: string | undefined;
         priceDetails?: string | undefined;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rozoai/intent-common",
-  "version": "0.1.5",
+  "version": "0.1.6-beta.1",
   "description": "Intent Pay shared types and utilities",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",