SDK Reference/issue()
issue()
Issues a new virtual Visa card from your agent wallet. Returns in under 300ms.
Signature
client.issue(options: IssueOptions): Promise<Card>Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| amount | number | Yes | Amount in cents |
| currency | string | Yes | ISO 4217 code (e.g. USD) |
| rules.merchant | string | No | Restrict to one merchant domain |
| rules.singleUse | boolean | No | Burn after first charge |
| rules.expiresIn | number | No | TTL in seconds |
| rules.maxAmount | number | No | Per-charge limit in cents |
Returns
| Field | Type | Description |
|---|---|---|
| id | string | Unique card identifier |
| number | string | Masked card number |
| cvv | string | Masked CVV |
| expiry | string | Expiry date MM/YY |
| status | string | active | expired | revoked |
Example
issue.ts
const card = await client.issue({
amount: 50_00,
currency: 'USD',
rules: {
merchant: 'aws.com',
singleUse: true,
expiresIn: 300,
},
})
console.log(card.id) // "card_..."
console.log(card.number) // "4111 •••• •••• 9821"✓
Card is active immediately after the promise resolves.