Skip to main content
DELETE
Delete payment channel
Remove a channel you no longer need. Active transactions block deletion.

Deletion constraints

A channel cannot be deleted if it has linked transactions or customers. Attempting to delete it returns 409 CHANNEL_IN_USE. To safely remove a channel:
  1. Stop routing new requests to it (omit channelId in payment requests or switch to another channel)
  2. Wait for all active transactions to reach terminal states
  3. Delete the channel once no active references remain
If the channel is the default, reassign the default to another channel before deleting.

Authorizations

Authorization
string
header
required

Paste your PalPluss API key in the username field and leave the password field empty — it is ignored.

Get your key from console → Settings → API Keys (starts with pk_live_ or pk_test_).

In your own code, send the key directly: Authorization: Basic YOUR_API_KEY

Path Parameters

id
string<uuid>
required

The channel ID.

Response

Channel deleted.