Delete payment method
Deletes a payment method. You cannot delete the default payment method — set another as default first.
**Path Parameters**
| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `payee_id` | UUID | Yes | ID of the payee |
| `payment_method_id` | UUID | Yes | ID of the payment method to delete |
- You cannot delete a payment method that is currently set as **default**. Set a different verified payment method as default first.
**Response**
204 No Content – The payment method was successfully deleted.
**Success Responses**
| Status Code | Description |
|-------------|-------------|
| 204 | No Content – The payment method was successfully deleted. |
**Error Responses**
| Status Code | Error Code | Description |
|-------------|------------|-------------|
| 400 | DEFAULT_PAYMENT_METHOD | Cannot delete the default payment method. Set another payment method as default first. |
| 401 | AUTHENTICATION_ERROR | Authentication credentials are invalid or missing. |
| 403 | AUTHORIZATION_ERROR | You do not have permission to perform this action. |
| 404 | NOT_FOUND | The specified payment method was not found. |
Authentication
x-api-keystring
RootPay API key sent in the x-api-key header. Keys are environment-scoped: live_* for production, test_* for sandbox.
Path parameters
payee_id
payment_method_id
Response
Payment method deleted successfully (no content)