Update Dunning Settings
Update the merchant division's dunning (failed payment recovery) settings. This replaces the full configuration; omitted fields are not merged with the previous settings.
Authorization
X-API-Key Admins and Developers can obtain their Bolt API key from the Bolt Merchant Dashboard.
In: header
Query Parameters
For Bolt Connect marketplace integrations, the seller's external ID. When provided, the request acts on the seller's division rather than the caller's own division. Takes precedence over the X-Bolt-Connect-Seller-Id header if both are set.
Header Parameters
The publicly viewable identifier used to identify a merchant division. This key is found in the Developer > API section of the Bolt Merchant Dashboard.
For Bolt Connect marketplace integrations, the seller's external ID. When provided, the request acts on the seller's division rather than the caller's own division. Ignored if the seller_id query parameter is also set.
Request Body
application/json
Dunning Settings
TypeScript Definitions
Use the request body type in TypeScript.
A merchant division's dunning (failed payment recovery) configuration.
Response Body
application/json
application/json
application/json
curl -X PUT "https://example.com/v1/subscriptions/dunning_settings" \ -H "X-Publishable-Key: string" \ -H "Content-Type: application/json" \ -d '{ "retry_schedule_hours": [ 24, 72, 168, 336 ], "reminder_lead_days": [ 30, 7, 3 ], "final_action": "cancel", "sms_enabled": false }'{ "retry_schedule_hours": [ 24, 72, 168, 336 ], "reminder_lead_days": [ 30, 7, 3 ], "final_action": "cancel", "sms_enabled": false}Get Dunning Settings GET
Get the merchant division's dunning (failed payment recovery) settings. If the division has never configured these settings, Bolt's defaults are returned.
Get Account Details GET
Fetch a shopper's account details to pre-fill checkout fields. This request must come from your backend for security purposes, as it requires the use of your private key to authenticate. For PCI compliance, only limited information is returned for each credit card available in the shopper’s wallet.