Register & Invoke Intent

Overview

The registerAndInvokeIntent() method registers an intent and invokes it in a single call. The user approves via passkey once, and you immediately get payment tokens back. Best for: instant “Buy Now” flows where the AI doesn’t need to store a mandate for later.

Internally this calls registerIntent() then invokeIntent() in sequence. The passkey prompt fires once.

Method Signature

prava.registerAndInvokeIntent(params: RegisterAndInvokeParams): Promise<PaymentTokens>

Parameters

params

RegisterAndInvokeParams

required

Show properties

cardId

string

required

Card to charge

merchant

string

required

Merchant name

amount

number

required

Transaction amount

currency

string

required

ISO 4217 currency code

itemCount

number

Number of items

productUrl

string

Product URL

Return Value

tokens

PaymentTokens

Show properties

pan

string

Virtual card number

expMonth

number

Expiration month

expYear

number

Expiration year

cvv

string

Single-use CVV

Example

import { PravaSDK } from '@prava-sdk/core';

const prava = new PravaSDK({ publishableKey: 'pk_live_xxx' });

// User says "Buy this" → one call → done
const tokens = await prava.registerAndInvokeIntent({
  cardId: 'enr_abc123',
  merchant: 'Amazon',
  amount: 29.99,
  currency: 'USD',
  itemCount: 1,
  productUrl: 'https://amazon.com/dp/B0EXAMPLE',
});

// tokens.pan, tokens.expMonth, tokens.expYear, tokens.cvv
// → Hand these to the checkout flow
console.log('Virtual PAN:', tokens.pan);

When to Use

Scenario	Use
One-time instant purchase	✅ `registerAndInvokeIntent()`
Recurring / scheduled purchases	❌ Use `registerIntent()` + `invokeIntent()` separately
Need to store mandate for later	❌ Use `registerIntent()` separately
”Buy Now” button	✅ `registerAndInvokeIntent()`

Error Handling

Code	Cause	Resolution
`PASSKEY_REJECTED`	User declined the passkey prompt	Allow retry
`PASSKEY_UNAVAILABLE`	Device doesn’t support WebAuthn	Inform user
`CARD_NOT_FOUND`	Card ID is invalid or removed	Refresh card list
`MANDATE_VIOLATION`	Invalid params	Check amount/merchant

Getting Started

SDK Reference

Card Management

Intent Management

Payment Execution

Overview

Method Signature

Parameters

Return Value

Example

When to Use

Error Handling

Next Steps

Browser Automation

Register Intent

Getting Started

SDK Reference

Card Management

Intent Management

Payment Execution

​Overview

​Method Signature

​Parameters

​Return Value

​Example

​When to Use

​Error Handling

​Next Steps

Browser Automation

Register Intent

Overview

Method Signature

Parameters

Return Value

Example

When to Use

Error Handling

Next Steps