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_idstringRequiredformat: "uuid"
payment_method_idstringRequiredformat: "uuid"

Response

Payment method deleted successfully (no content)