Skip to main content

Delete Manual Payment (v1)

Method & Path

DELETE /api/v1/admin/payments/:paymentId

Description

Delete an existing manual payment record. Only manual payments (payments with isManual: true) can be deleted. Automatic payments created by the system cannot be deleted.

Authentication

Required: Admin authentication with payments.manage permission.

Headers

Authorization: Bearer <admin_token>

Path Parameters

ParameterTypeRequiredDescription
paymentIdstringYesID of the payment to delete

Response 204 No Content

The payment has been successfully deleted. No response body is returned.

Common Errors

400 Bad Request: Invalid payment ID

401 Unauthorized: Missing or invalid authentication token

403 Forbidden:

  • Admin does not have payments.manage permission
  • Payment is not a manual payment (automatic payments cannot be deleted)

404 Not Found: Payment not found

500 Internal Server Error: Server error occurred while deleting the payment