Skip to main content
POST
https://api.alguna.io
/
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"
  }'

{
  "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.
​
id
string
required
The wallet ID.
​
amount
string
required
Amount to credit as a decimal string (e.g., “100.00”).
​
transactionType
string
required
Type of credit transaction. Common values: manual_adjustment, promotional, refund.
​
referenceId
string
required
External reference ID for tracking (e.g., your internal transaction ID).
​
description
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"
  }'

{
  "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"
}