Product
Solutions
Pricing
Resources
Company
Talk to sales Install for Shopify
Integrations

API docs

Every alert, decision and refund available as JSON. Bearer-token auth, cursor pagination, idempotency keys on writes, and a sandbox that fires synthetic alerts at your endpoints.

OpenAPI 3.1 Node and Python SDKs 120 req/min per key 
curl https://api.chargebackify.com/v1/alerts \
  -H "Authorization: Bearer sk_live_…" \
  -G -d limit=2 -d status=prevented

{
  "data": [
    {
      "id": "alrt_9Kd2m",
      "network": "visa_rdr",
      "reason": "fraud",
      "amount": 12900,
      "currency": "usd",
      "order": { "id": "18429", "platform": "shopify" },
      "action": "refund_full",
      "status": "prevented",
      "resolved_in_ms": 1412
    }
  ],
  "has_more": true,
  "next_cursor": "cur_8Ha2p"
}

Authentication

Keys are issued per store and per environment. Sandbox keys are free, unlimited, and never touch real money.

Bearer tokens
Send the key as an Authorization header. Keys are scoped to one store and one environment, and can be rotated without downtime by issuing a second key before revoking the first.
Sandbox and live
Keys prefixed sk_test_ hit the sandbox, sk_live_ hits production. The sandbox has the same shape, the same webhooks and no real refunds.
Idempotency
Send an Idempotency-Key header on any write. Repeating a request with the same key returns the original response rather than acting twice.
Rate limits
120 requests a minute per key, burst to 300. Exceeding it returns 429 with a Retry-After header rather than dropping the request silently.

Endpoints

GET /v1/alerts List alerts, filterable by status, network, reason and date range.
GET /v1/alerts/:id One alert with its matched order and full decision trail.
POST /v1/alerts/:id/resolve Act on an alert manually: refund, cancel or dismiss.
GET /v1/rules List the rules active on a store.
POST /v1/rules Create a rule from conditions and an action.
PATCH /v1/rules/:id Update or disable an existing rule.
GET /v1/ratio Current and projected dispute ratio per processor.
GET /v1/invoices Success-fee invoices with a line per prevented dispute.

Webhooks

Signed with HMAC-SHA256, retried with exponential backoff for 24 hours, and replayable from the dashboard for any event in the last 30 days.

alert.received A network published a pre-dispute for one of your orders.
alert.matched The alert resolved to a Shopify order, with confidence score.
alert.prevented A rule ran and the dispute was stopped in time.
alert.missed The window closed before action was possible. Never billed.
ratio.threshold_warning You crossed 60% of a network threshold.
invoice.finalized The monthly success-fee invoice is ready.

Errors and limits

400 Malformed request. The response body names the field and what was expected.
401 Missing or revoked key. Check the environment prefix before anything else.
404 The object does not exist on this store. Keys are store-scoped, so a valid id from another store returns 404, not 403.
409 Idempotency conflict. The same key was used with a different payload.
429 Rate limited. Retry-After tells you how long to wait.

Sandbox keys are free.

Fire synthetic Visa and Mastercard alerts at your own endpoints and watch the whole flow resolve before you connect a real store.

Get a sandbox key Help center

Chargeback prevention infrastructure, starting with Shopify. Alerts, refunds and ratio monitoring in one place.

The Prevention Brief

Network rule changes, threshold updates and merchant teardowns. Once a month.

No spam. Unsubscribe anytime.

PRODUCT
How it worksChargeback alertsAutomatic refundsOrder matchingRatio monitoringChargebackify vs ChargeflowChargebackify vs DisputifierChargebackify vs SignifydChargebackify vs NoFraudChargebackify vs JusttPricing
SOLUTIONS
High-risk merchantsSubscriptionsDropshippingHigh-volume DTCAgenciesEnterprise
RESOURCES
BlogHelp centerFAQGlossaryAPI docsCustomer storiesIntegrations
FREE TOOLS Savings calculatorRatio checkerDescriptor checkerReason code lookupDeadline calculatorVendor comparison
INTEGRATIONS
ShopifyStripePayPalSlackKlaviyoREST API
COMPANY
AboutCareersContactBook a demoPressLog in
LEGAL
Terms of servicePrivacy policySecurityComplianceDPACookie settings
© 2026 Chargebackify
Built for Shopify English (US)