Declined.io Developer Documentation

Integrate payment recovery automation into your billing stack. Send events when payments fail, mark recoveries when customers pay, and receive outbound webhooks as sequences progress.

Quick start

Create an API key in the dashboard under Webhooks & SDK, then send your first event:

curl
curl -X POST https://dev.declined.io/api/v1/events \
  -H "Authorization: Bearer decl_live_sk_..." \
  -H "Content-Type: application/json" \
  -d '{
    "event_id": "evt_001",
    "type": "payment_failed",
    "customer_id": "cus_123",
    "invoice_id": "inv_456",
    "amount": 24900,
    "currency": "usd",
    "provider": "stripe"
  }'

Official SDKs

Each language is published from its own GitHub repository under the declined-io organization:

  • Node.js — npm install declined
  • Python — pip install declined
  • Ruby — gem install declined
  • PHP — composer require declined/sdk
  • Go — go get github.com/Enoros/declined-sdk/declined-go
  • Java — Maven: io.declined:declined

Core concepts

  • Authentication — Bearer API keys for live and sandbox
  • Events — Ingest billing signals (failures, recoveries, subscription changes)
  • Recoveries — Mark payments as recovered when customers pay outside Declined
  • Webhooks — Receive outbound notifications from Declined
  • REST API — Full endpoint reference