Interface DelegationConfig

Configuration for delegation-based payments (both crypto and card schemes).

To reuse an existing delegation supply delegationId. To reuse an existing card (PaymentMethod entity) supply cardId. When creating a brand-new delegation provide providerPaymentMethodId, spendingLimitCents, and durationSecs.

interface DelegationConfig {
    apiKeyId?: string;
    cardId?: string;
    currency?: string;
    delegationId?: string;
    durationSecs?: number;
    maxTransactions?: number;
    merchantAccountId?: string;
    providerPaymentMethodId?: string;
    spendingLimitCents?: number;
}

Properties

apiKeyId?: string

NVM API Key ID to scope the delegation to

cardId?: string

PaymentMethod entity UUID — preferred way to reference an enrolled card

currency?: string

Currency code (default: 'usd')

delegationId?: string

Existing delegation UUID to reuse instead of creating a new one

durationSecs?: number

Duration of the delegation in seconds. Required only for new delegations.

maxTransactions?: number

Maximum number of transactions allowed

merchantAccountId?: string

Merchant account ID (Stripe Connect acct_xxx or Braintree merchantId)

providerPaymentMethodId?: string

Stripe payment method ID (e.g., 'pm_...'). Required only for new delegations.

spendingLimitCents?: number

Maximum spending limit in cents. Required only for new delegations.