Interface CreateDelegationPayload

Payload for creating a new delegation via POST /api/v1/delegation/create.

interface CreateDelegationPayload {
    apiKeyId?: string;
    currency?: string;
    durationSecs: number;
    maxTransactions?: number;
    merchantAccountId?: string;
    planId?: string;
    provider: "stripe" | "braintree" | "erc4337";
    providerPaymentMethodId?: string;
    spendingLimitCents: number;
}

Properties

apiKeyId?: string

NVM API Key ID to scope the delegation to

currency?: string

Currency code (default: 'usd')

durationSecs: number

Duration of the delegation in seconds

maxTransactions?: number

Maximum number of transactions allowed

merchantAccountId?: string

Merchant account ID (Stripe Connect acct_xxx or Braintree merchantId)

planId?: string

Plan ID to scope the delegation to

provider: "stripe" | "braintree" | "erc4337"

Delegation provider: 'stripe' or 'braintree' for card, 'erc4337' for crypto

providerPaymentMethodId?: string

Payment method ID from the provider (Stripe 'pm_...' or Braintree vault token). Required for stripe/braintree providers.

spendingLimitCents: number

Maximum spending limit in cents