This endpoint is inactive and is no longer supported for new integrations.
- If you are building a new integration, build an online payments integration with Checkout API instead.
- If you have an existing integration using this endpoint, reach out to your Adyen contact and migrate to Checkout API.
The Checkout API enables your online payments integration to accept all supported payment methods, use latest features, and access more benefits.
A recurring contract is created along with a payment request, similar to a regular payment request, except the below fields to be provided in the payment session HPP form or in the API request. If the payment is successful, the details are stored, and the recurringDetailReference is created. Set the recurringProcessingModel to:
- Subscription for payments that recur on a fixed schedule.
- CardOnFile for payments that do not occur on a fixed schedule.
- UnscheduledCardOnFile for payments that occur on a non-fixed schedule using stored card details. For example, automatic top-ups when a cardholder's balance drops below certain amount.
For more information on available fields, refer to API Explorer.
Always provide a unique shopperReference parameter for every shopper. Note that you can store maximum 100 card details associated with the same shopperReference value.
Request
The following code examples show the creation of recurring contracts together with a payment request using /authorise endpoint in JSON, SOAP, and cURL.
When you are ready to process a subsequent payment, set the value of the selectedRecurringDetailReference to either:
-
The
recurringDetailReferencereturned from the list of all stored recurring details based on theshopperReferenceprovided during the recurring contract. -
The word "LATEST", which uses a recent recurring detail.
On AUTHORISATION you receive a webhook event with success set to true.