Credit Wallet

POST

wallets

{id}

credit

curl -X POST https://api.alguna.io/wallets/wal_def456/credit \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": "100.00",
    "transactionType": "promotional",
    "referenceId": "promo_jan2024",
    "description": "January promotional credit"
  }'

const wallet = await alguna.wallets.credit('wal_def456', {
  amount: '100.00',
  transactionType: 'promotional',
  referenceId: 'promo_jan2024',
  description: 'January promotional credit'
});

{
  "id": "wal_def456",
  "accountId": "acc_abc123",
  "name": "Prepaid Credits",
  "currency": "USD",
  "currentBalance": "600.00",
  "active": true,
  "productIds": [],
  "createdAt": "2024-01-20T10:00:00Z",
  "updatedAt": "2024-01-21T10:00:00Z"
}

Add funds to a wallet. Use this for manual adjustments or promotional credits.

string

required

The wallet ID.

string

required

Amount to credit as a decimal string (e.g., “100.00”).

string

required

Type of credit transaction. Common values: manual_adjustment, promotional, refund.

string

required

External reference ID for tracking (e.g., your internal transaction ID).

string

required

Description of the credit for record-keeping.

curl -X POST https://api.alguna.io/wallets/wal_def456/credit \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": "100.00",
    "transactionType": "promotional",
    "referenceId": "promo_jan2024",
    "description": "January promotional credit"
  }'

const wallet = await alguna.wallets.credit('wal_def456', {
  amount: '100.00',
  transactionType: 'promotional',
  referenceId: 'promo_jan2024',
  description: 'January promotional credit'
});

{
  "id": "wal_def456",
  "accountId": "acc_abc123",
  "name": "Prepaid Credits",
  "currency": "USD",
  "currentBalance": "600.00",
  "active": true,
  "productIds": [],
  "createdAt": "2024-01-20T10:00:00Z",
  "updatedAt": "2024-01-21T10:00:00Z"
}

Get Wallet Balance

⌘I

curl -X POST https://api.alguna.io/wallets/wal_def456/credit \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": "100.00",
    "transactionType": "promotional",
    "referenceId": "promo_jan2024",
    "description": "January promotional credit"
  }'

const wallet = await alguna.wallets.credit('wal_def456', {
  amount: '100.00',
  transactionType: 'promotional',
  referenceId: 'promo_jan2024',
  description: 'January promotional credit'
});

{
  "id": "wal_def456",
  "accountId": "acc_abc123",
  "name": "Prepaid Credits",
  "currency": "USD",
  "currentBalance": "600.00",
  "active": true,
  "productIds": [],
  "createdAt": "2024-01-20T10:00:00Z",
  "updatedAt": "2024-01-21T10:00:00Z"
}

API Reference

Billing Events & Usage Metering

Bundles

Credit Grants

Credit Notes

Customers

Invoices

Plans

Products

Refunds

Subscriptions

Subscription Versions

Wallets