> ## Documentation Index
> Fetch the complete documentation index at: https://docs.revtain.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Quickstart

> Your first recovery call in under 60 seconds.

## 1. Make a recovery call

Replace `rev_YOUR_API_KEY` with the key from your onboarding email and run:

```bash theme={null}
curl -X POST https://api.revtain.com/api/recovery/execute \
  -H "Content-Type: application/json" \
  -H "X-API-KEY: rev_YOUR_API_KEY" \
  -d '{
    "paymentMethodToken": "pm_1234567890",
    "amount": 5000,
    "currency": "USD",
    "originalDeclineCode": "do_not_honor",
    "idempotencyKey": "order_12345_retry_1"
  }'
```

## 2. Read the response

```json theme={null}
{
  "success": true,
  "message": "Revenue Recovered",
  "transactionId": "01KKZ14FEZK152ZBXEM2XK1B0C",
  "strategyUsed": "primary",
  "gatewaysAttempted": 1
}
```

That's it — the payment was recovered.

| `success`    | What it means                               |
| ------------ | ------------------------------------------- |
| `true`       | Payment recovered ✓                         |
| `false`      | All strategies exhausted, see `error` field |
| `202` status | Queued for retry — you'll get a webhook     |

## Next Steps

<CardGroup cols={2}>
  <Card title="Set up webhooks" icon="webhook" href="/guides/webhooks">
    Receive real-time notifications when async retries complete.
  </Card>

  <Card title="Integration checklist" icon="list-check" href="/guides/integration-checklist">
    Everything you need before going to production.
  </Card>
</CardGroup>

<Tip>
  **Using Chargebee, Recurly, Stripe Billing, Braintree, Zuora, or Shopify (ReCharge)?** Skip the API entirely — use a [zero-code connector](/guides/connectors) and paste one webhook URL into your billing platform.
</Tip>