Quickstart - Revtain

1. Make a recovery call

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

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

{
  "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

Set up webhooks

Receive real-time notifications when async retries complete.

Integration checklist

Everything you need before going to production.

Using Chargebee, Recurly, Stripe Billing, Braintree, Zuora, or Shopify (ReCharge)? Skip the API entirely — use a zero-code connector and paste one webhook URL into your billing platform.