Debit wallet

curl -X POST "https://api.nedzo.ai/v1/workspaces/19c3b12f-ec54-43ad-8686-00e921f1befd/billing/wallet/debit" \
    -H "Authorization: Bearer YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{
      "amount": 1000,
      "reason": "Chargeback correction",
      "idempotencyKey": "debit-2026-04-17-xyz"
    }'

{
  "workspaceId": "19c3b12f-ec54-43ad-8686-00e921f1befd",
  "transactionId": "d5f6a7b8-2345-6789-abcd-ef0123456789",
  "amount": 1000,
  "newBalance": 6500,
  "type": "debit",
  "reason": "Chargeback correction",
  "createdAt": "2026-04-17T10:35:00Z"
}

POST

workspaces

{workspaceId}

billing

wallet

debit

curl -X POST "https://api.nedzo.ai/v1/workspaces/19c3b12f-ec54-43ad-8686-00e921f1befd/billing/wallet/debit" \
    -H "Authorization: Bearer YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{
      "amount": 1000,
      "reason": "Chargeback correction",
      "idempotencyKey": "debit-2026-04-17-xyz"
    }'

{
  "workspaceId": "19c3b12f-ec54-43ad-8686-00e921f1befd",
  "transactionId": "d5f6a7b8-2345-6789-abcd-ef0123456789",
  "amount": 1000,
  "newBalance": 6500,
  "type": "debit",
  "reason": "Chargeback correction",
  "createdAt": "2026-04-17T10:35:00Z"
}

string

required

Workspace UUID

integer

required

Amount to debit in cents. Must be a positive integer.

string

required

Human-readable reason for the adjustment (1-500 characters). Cannot contain the substring [idempotency:.

string

Optional idempotency key (a-z, A-Z, 0-9, hyphen, 1-128 chars). If provided, a retry with the same key within 24 hours returns the existing transaction without re-applying the debit.

curl -X POST "https://api.nedzo.ai/v1/workspaces/19c3b12f-ec54-43ad-8686-00e921f1befd/billing/wallet/debit" \
    -H "Authorization: Bearer YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{
      "amount": 1000,
      "reason": "Chargeback correction",
      "idempotencyKey": "debit-2026-04-17-xyz"
    }'

{
  "workspaceId": "19c3b12f-ec54-43ad-8686-00e921f1befd",
  "transactionId": "d5f6a7b8-2345-6789-abcd-ef0123456789",
  "amount": 1000,
  "newBalance": 6500,
  "type": "debit",
  "reason": "Chargeback correction",
  "createdAt": "2026-04-17T10:35:00Z"
}

{
  "type": "https://api.nedzo.ai/errors/payment-required",
  "title": "Payment Required",
  "status": 402,
  "detail": "Insufficient wallet balance"
}

API Reference

Workspaces

Agents

Contacts

Templates

Calls

Debit wallet