Skip to main content

​
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.
successWhat it means
truePayment recovered ✓
falseAll strategies exhausted, see error field
202 statusQueued 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.