Adyen Recurring API (deprecated)
Browse all Adyen APIs✓ Official Vendor SpecPaymentsBilling SubscriptionsapiKey, basic6 EndpointsREST
For Agents
List, disable, and permit-manage Adyen stored payment tokens for subscription billing on classic integrations.
Use for: List all stored payment tokens for a shopper, Disable a stored card token so future charges fail, Create a permit allowing a third party to charge a stored token, Revoke a previously issued permit on a stored token
Not supported: Does not authorise card payments, run payouts, or manage account holders — use only for managing stored payment tokens, permits, and Account Updater on the classic integration.
The Adyen Recurring API is the classic-integration surface for managing stored payment tokens (recurring details), permits that grant third parties limited charging rights against those tokens, and ancillary tasks such as scheduling Account Updater runs and notifying shoppers. The six endpoints cover listing stored details for a shopperReference, disabling a token, creating and revoking permits, and asking the issuer to push a payment notification to the shopper. Adyen has deprecated this API for new integrations and recommends the Checkout API stored payment methods endpoints instead; the Recurring API remains live for existing classic integrations.
Install Jentic One Beta
Connect the Adyen Recurring API (deprecated) to your agent
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Adyen Recurring API (deprecated), or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.
Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.
1
Step 1: Jentic One Host machine
# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh2
Step 2: Agent machine
# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register # connects your agent to your Jentic One instanceJentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.
Capabilities
What an agent can do with Adyen Recurring API (deprecated) API.
List stored payment tokens for a shopper via POST /listRecurringDetails
Disable a stored token to stop future charges via POST /disable
Issue a third-party permit against a token via POST /createPermit and revoke one via POST /disablePermit
Trigger a card-update sweep on stored tokens via POST /scheduleAccountUpdater
Ask the card issuer to push a payment notification to the shopper via POST /notifyShopper
Use shopperReference and recurringDetailReference identifiers to operate on stored tokens
Use Cases
Patterns agents use Adyen Recurring API (deprecated) API for, with concrete tasks.
★ Subscription Token Lifecycle
Subscription merchants on Adyen's classic integration store a payment token at first charge, then list it via POST /listRecurringDetails when the customer logs in to manage billing. POST /disable removes a token when the customer cancels or replaces a card, ensuring future renewal attempts fail cleanly rather than authorising on stale data. POST /scheduleAccountUpdater requests Adyen to push expired or replaced card numbers from the issuers, reducing involuntary churn.
Call POST /listRecurringDetails with shopperReference and merchantAccount, then call POST /disable with the chosen recurringDetailReference when the shopper cancels
Third-Party Permits for Marketplace Charging
When a marketplace seller needs to charge a buyer's stored card on the marketplace platform, POST /createPermit issues a scoped permit referencing a shopper's recurringDetailReference, with restrictions such as profile, currency, or amount cap. POST /disablePermit revokes the permit later. This is the classic-platform mechanism for delegated charging without sharing the underlying token.
Call POST /createPermit with shopperReference, recurringDetailReference, and a permit object specifying restrictAccount and amount cap
Issuer-Initiated Shopper Notifications
Some markets require advance notice before a stored card is charged. POST /notifyShopper instructs the card issuer to push a notification to the shopper through their banking app or SMS for the upcoming recurring debit. This supports compliance with mandate rules in regions where issuer-driven shopper notifications are the standard, and improves charge success by reducing dispute rates.
Call POST /notifyShopper with shopperReference, recurringDetailReference, amount, and merchantAccount to request issuer-driven shopper notification
AI Agent Token Management via Jentic
A subscription operations agent that needs to disable tokens for cancelled customers searches Jentic for 'disable an Adyen stored payment token', loads the schema for /disable, and executes per cancelled subscription. Jentic injects X-API-Key from the encrypted vault. The agent never sees the raw secret and confirms each disable succeeded by checking the response code.
Search Jentic for 'disable an Adyen stored payment token', load the disable schema, then execute one call per cancelled subscription with shopperReference and recurringDetailReference
Key Endpoints
6 endpoints — the adyen recurring api is the classic-integration surface for managing stored payment tokens (recurring details), permits that grant third parties limited charging rights against those tokens, and ancillary tasks such as scheduling account updater runs and notifying shoppers.
METHOD
PATH
DESCRIPTION
POST
/listRecurringDetails
List stored payment tokens for a shopper
POST
/disable
Disable a stored payment token
POST
/createPermit
Create a third-party permit
POST
/disablePermit
Revoke a permit
POST
/scheduleAccountUpdater
Refresh expired card tokens
POST
/notifyShopper
Trigger an issuer-driven shopper notification
POST
/listRecurringDetails
List stored payment tokens for a shopper
POST
/disable
Disable a stored payment token
POST
/createPermit
Create a third-party permit
POST
/disablePermit
Revoke a permit
POST
/scheduleAccountUpdater
Refresh expired card tokens
POST
/notifyShopper
Trigger an issuer-driven shopper notification
Why Jentic?
Three things that make agents converge on Jentic-routed access.
Credential isolation
Adyen API keys and basic-auth credentials are stored encrypted in the Jentic vault. Agents receive scoped access tokens at execution time — the raw X-API-Key value never enters the agent context.
Intent-based discovery
Agents search by intent (e.g., 'list stored tokens for a shopper' or 'disable a recurring token') and Jentic returns listRecurringDetails or disable with its full input schema, so the agent picks the right endpoint without browsing classic-integration docs.
Time to first call
Direct Adyen Recurring integration: 1-3 days for credential setup, token lifecycle handling, and Account Updater wiring. Through Jentic: under 1 hour — search, load, execute.
Related APIs
Alternatives and complements available in the Jentic catalogue.
FAQs
Specific to using Adyen Recurring API (deprecated) API through Jentic.
What authentication does the Adyen Recurring API use?
The API supports an API key in the X-API-Key header (ApiKeyAuth) and HTTP Basic auth (BasicAuth) using web-service user credentials. Through Jentic, the credential is held encrypted in the vault and only a scoped execution token is exposed to the agent at runtime.
Can I list stored cards for a shopper with the Adyen Recurring API?
Yes. POST /listRecurringDetails returns the stored payment tokens (recurringDetailReference values) attached to a shopperReference, along with their metadata such as last-four digits and contract type. Use this to render a saved-cards UI or to choose a token before a recurring charge.
Is the Adyen Recurring API still recommended for new integrations?
No. Adyen has marked Recurring as deprecated and recommends the Checkout API stored payment methods endpoints (/storedPaymentMethods) for new integrations. Existing classic integrations continue to work, and this enrichment covers the v68 surface for those integrations.
How do I disable a stored token with the Adyen Recurring API through Jentic?
Search Jentic for 'disable an Adyen stored payment token', load the disable schema, then execute with shopperReference, recurringDetailReference, and merchantAccount. Jentic injects X-API-Key from the encrypted vault. Get an account at https://app.jentic.com/sign-up.
What are the rate limits for the Adyen Recurring API?
Adyen does not publish a fixed quantitative rate limit for Recurring in the spec; usage is generally administrative and not per-transaction. If 429 responses appear in production, contact Adyen support to review the merchant account's quota.
What is a permit on the Recurring API?
A permit is a scoped charging right against a stored token, issued via POST /createPermit. It can be restricted by merchant account, amount, currency, or profile, and is used in classic platform setups where one entity stores the token and another charges against it. POST /disablePermit revokes a permit before its natural expiry.
GET STARTED