PUT /admin/billing/dunning-settings/{tenant_id}

Create or update the failed payment dunning policy for a tenant, including: retry schedule, grace period days, auto-cancel days and email template. Supports upsert—updates if configuration exists, creates if not.

Request Parameters

Name	In	Type	Required	Default	Example	Constraints	Description
tenant_id	path	string	Yes				Tenant ID

Request Body

Schema: dto.DunningSettingsRequest

Field	Type	Required	Example	Constraints	Description
auto_cancel_days	integer	No	30
email_templates	string	No
grace_period_days	integer	No	7
retry_schedule	string	No	[1,3,7,14]

Responses

Status	Description	Schema
200	Dunning configuration update successful	dto.DunningSettingsDetailResponse
400	Invalid request parameters	object
401	Unauthorized	object
403	No permission	object
500	Internal server error	object

Referenced Schemas

dto.DunningSettingsDetailResponse

Field	Type	Required	Example	Constraints	Description
code	integer	No
data	dto.DunningSettingsResponse	No
message	string	No
timestamp	string	No

dto.DunningSettingsResponse

Field	Type	Required	Example	Constraints	Description
auto_cancel_days	integer	No	30
created_at	string	No	2026-05-12T10:00:00Z
email_templates	string	No
grace_period_days	integer	No	7
retry_schedule	string	No	[1,3,7,14]
status	string	No	active
tenant_id	string	No	tnt_xyz789
updated_at	string	No	2026-05-12T10:00:00Z