Skip to main content
DELETE
/
payment-wallet
/
channels
/
{id}
Delete payment channel
curl --request DELETE \
  --url https://api.palpluss.com/v1/payment-wallet/channels/{id} \
  --header 'Authorization: Basic <encoded-value>'
{
  "success": false,
  "error": {
    "message": "Invalid or revoked API key.",
    "code": "INVALID_API_KEY",
    "details": {}
  },
  "requestId": "a1b2c3d4-0000-0000-0000-000000000000"
}
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

Use your API key as the username. Leave the password field empty.

Authorization: Basic <base64(apikey:)>

You can also pass the raw API key:

Authorization: Basic <apikey>

Path Parameters

id
string<uuid>
required

The channel ID.

Response

Channel deleted.