Saasco logoSaasco logo
Saasco logoSaasco logo

Introduction

OverviewGetting startedWhat is Saasco?

SDK

Quick startTrackingIdentifyConfigurationWidgetsProperties

MCP

Quick startHow it worksAuthorizationTool reference

REST API

Quick start
getList DisputesgetGet DisputegetGet Dispute StatsgetGet Dispute SettingsputUpdate Dispute SettingspostPreview Dispute EvidencepostRegenerate Dispute EvidencepostSubmit Dispute EvidencepostProvision Dispute WebhookdelDelete Dispute WebhookpostSync Disputes
Disputes

Update Dispute Settings

Updates dispute settings. Omitted fields stay as they are. Send null to clear a text field.

PUT
/projects/{projectId}/dispute-settings

Authorization

Authorization
AuthorizationBearer <token>

In: header

Path Parameters

projectIdrequiredstring

ID of the project.

Request Body

application/json

changesrequiredobject

Settings to change. Omitted fields stay as they are.

aiContextstring | null

Extra instructions included when drafting dispute evidence. Null clears them.

aiContextEnabledboolean

Whether the evidence draft uses aiContext.

autoSubmitboolean

Whether evidence is submitted to Stripe as soon as it is ready.

cancellationPolicyDisclosurestring | null

Cancellation-policy text sent with evidence. Null clears it.

checkoutTermsImageLabelstring | null

Caption for the checkout-terms screenshot. Null clears it.

checkoutTermsImageUrlstring | null

HTTPS URL of the checkout-terms screenshot. Null clears it.

customDataEndpointSecretstring | null

Shared secret sent when Saasco calls customDataEndpointUrl. Null clears it.

customDataEndpointUrlstring | null

HTTPS URL Saasco calls for extra evidence before drafting. Null clears it.

customEndpointEnabledboolean

Whether the custom evidence endpoint is called.

notificationEmailOverridestring | null

Address that receives dispute outcome mail instead of the project default. Null clears the override.

policiesEnabledboolean

Whether refund and cancellation policy text is included in evidence.

productDescriptionOverridestring | null

Product description sent with evidence instead of the Stripe charge text. Null clears it.

refundPolicyDisclosurestring | null

Refund-policy text sent with evidence. Null clears it.

stripeWebhookEndpointIdstring | null

Stripe webhook endpoint id that delivers dispute events. Set by provisioning; send null only to clear a stale id.

stripeWebhookEndpointUrlstring | null

URL Stripe calls for dispute events. Set by provisioning; send null only to clear a stale URL.

webhookSigningSecretstring

Stripe webhook signing secret for the dispute endpoint. Omit to leave the stored secret unchanged.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X PUT "https://www.saasco.com/api/v2/projects/string/dispute-settings" \  -H "Content-Type: application/json" \  -d '{    "changes": {}  }'
{
  "aiContext": null,
  "aiContextEnabled": false,
  "autoSubmit": true,
  "cancellationPolicyDisclosure": null,
  "checkoutTermsImageLabel": null,
  "checkoutTermsImageUrl": null,
  "customDataEndpointSecret": null,
  "customDataEndpointUrl": null,
  "customEndpointEnabled": false,
  "notificationEmailOverride": null,
  "policiesEnabled": false,
  "productDescriptionOverride": null,
  "refundPolicyDisclosure": null,
  "stripeWebhookEndpointId": null,
  "stripeWebhookEndpointUrl": null
}
{
  "code": "BAD_REQUEST",
  "message": "Invalid input data",
  "issues": []
}
{
  "code": "UNAUTHORIZED",
  "message": "Authorization not provided",
  "issues": []
}
{
  "code": "FORBIDDEN",
  "message": "Insufficient access",
  "issues": []
}
{
  "code": "NOT_FOUND",
  "message": "Not found",
  "issues": []
}
{
  "code": "INTERNAL_SERVER_ERROR",
  "message": "Internal server error",
  "issues": []
}

Get Dispute Settings

Reads dispute settings and whether a webhook signing secret is stored. The secret itself is not returned.

Preview Dispute Evidence

Drafts the evidence that would be submitted for a dispute, without sending it to Stripe or uploading files.