SOsolvapay
Auto Recharge

Set or update auto-recharge config for a customer

Changed on

Persists the auto-recharge configuration for a customer. When no reusable card is on file, a Stripe SetupIntent client secret is returned so the caller can collect one.

put/v1/sdk/auto-recharge

Request

Request body

currencystring required
customerEmailstring email
customerNamestring
customerRefstring required
deferSetupIntentboolean
enabledboolean required
maxMonthlySpendMajornumber
thresholdAmountMajornumber
topupAmountMajornumber
triggerType'balance' required

Response

Saved auto-recharge config and optional SetupIntent details.

publishableKeystring

Stripe publishable key for the resolved environment

setupClientSecretstring

Stripe SetupIntent client secret for card collection

stripeAccountIdstring

Connected Stripe account ID

Example response

{
  "config": {
    "enabled": true,
    "maxMonthlySpendMinor": 10000,
    "monthlySpendMinor": 4500,
    "monthlySpendPeriod": "2026-07",
    "topup": {
      "amountMinor": 2000,
      "currency": "USD",
      "mode": "fixed"
    },
    "trigger": {
      "thresholdAmountMinor": 500,
      "type": "balance"
    }
  },
  "display": {
    "currency": "USD",
    "exchangeRate": 1,
    "formatted": {
      "threshold": "$5.00",
      "topup": "$20.00"
    },
    "rateSource": "db",
    "thresholdAmountMajor": 5,
    "topupAmountMajor": 20
  }
}

Changes

  • e356f6586bf2Revision changes
    • warning

      added the new db enum value to the / response property for the response status

    • warning

      added the new fallback enum value to the / response property for the response status

    • warning

      added the new parity enum value to the / response property for the response status

  • bbc2ff2bc849Revision changes
    • breaking

      removed the required property / from the response with the status

    • warning

      removed the request property

    • warning

      removed the optional property / from the response with the status

    • info

      added the new optional request property

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      removed the completed enum value from the / response property for the response status

    • info

      added the required property / to the response with the status