Deactivate a wallet deposit address

curl --request DELETE \
  --url https://api.paystack.com/v1/wallets/{id}/deposit-addresses/{depositAddressId} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "reason": "<string>"
}
'

{
  "status": true,
  "message": "Deposit address has been successfully deactivated",
  "code": "ok",
  "data": {
    "id": "da_01HXYZABC1234567890ABCDEFG",
    "success": true
  },
  "meta": {
    "request_id": "req_01HXYZ4K5ABCDEFGHJKLMNPQRS",
    "timestamp": "2026-05-14T15:43:55.732Z",
    "version": "1"
  }
}

Wallets

Deactivate a wallet deposit address

Deactivates a wallet deposit address by flipping its status to disabled. The record is preserved — list and get continue to return it.

The path ids are GlobalStack external identifiers: the wallet (wal_…) and the deposit address (da_…).

An optional JSON body { "reason": "…" } (max 255 chars) records why the deposit address was deactivated in disabled_reason.

Funds sent to a deactivated address are not credited.

Response

{
  "status": true,
  "message": "Deposit address has been successfully deactivated",
  "code": "ok",
  "data": { "id": "da_01HXYZABC1234567890ABCDEFG", "success": true },
  "meta": { "request_id": "req_…", "timestamp": "…", "version": "1" }
}

Status preconditions

pending → disabled.
active → disabled.
frozen → 409 invalid_status.
disabled → 409 invalid_status (not idempotent).

Errors

400 invalid_input — wal_… or da_… id is malformed.
401 authentication_failed — invalid or missing API key.
404 not_found — wallet or deposit address does not exist in this integration.
409 invalid_status — deposit address is already disabled or is frozen.

Example

DELETE /v1/wallets/wal_01HXYZABC1234567890ABCDEFG/deposit-addresses/da_01HXYZABC1234567890ABCDEFG

DELETE

wallets

{id}

deposit-addresses

{depositAddressId}

Deactivate a wallet deposit address

curl --request DELETE \
  --url https://api.paystack.com/v1/wallets/{id}/deposit-addresses/{depositAddressId} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "reason": "<string>"
}
'

{
  "status": true,
  "message": "Deposit address has been successfully deactivated",
  "code": "ok",
  "data": {
    "id": "da_01HXYZABC1234567890ABCDEFG",
    "success": true
  },
  "meta": {
    "request_id": "req_01HXYZ4K5ABCDEFGHJKLMNPQRS",
    "timestamp": "2026-05-14T15:43:55.732Z",
    "version": "1"
  }
}

Authorizations

Authorization

string

header

required

API key issued during merchant onboarding.

Path Parameters

string

required

Pattern: [^\/#\?]+?

depositAddressId

string

required

Pattern: [^\/#\?]+?

Body

application/json

DeactivateDepositAddressDto

reason

string

Maximum string length: 255

Response

Deposit address has been successfully deactivated

status

enum<boolean>

required

Available options:

true

Example:

true

message

string

required

Human-readable summary

Example:

"Deposit address has been successfully deactivated"

code

enum<string>

required

Available options:

ok

Example:

"ok"

data

object

required

Show child attributes