Classic-integration icon

Authorise using details stored with a third party

Adyen is no longer developing the Classic API integration

This page is for the Classic API (/authorise) integration, which we no longer accept new integrations with.

We strongly recommend migrating to the newer Network tokenization integration. To use this newer integration, you must also migrate to the Checkout API.

When you store payment details with a third party, you can use these details to authorise payments. 

Initial Card on file/Subscription payments

The following fields must be passed in a Card-on-File/Subscription payment request:

  • amount
  • shopperInteraction: set to Ecommerce for the initial payment or set to ContAuth for subsequent payments.
  • recurringProcessingModel: set to Subscription for payments that recur on a fixed schedule, and Card On File for payments that do not occur on a fixed schedule.
Copy code
{
"card":{
"number":"4111111111111111",
"expiryMonth":"8",
"expiryYear":"2018",
"cvc":"737",
"holderName":"John Smith"
},
"amount":{
"value":2000,
"currency":"EUR"
},
"reference":"Your Reference Here",
"merchantAccount":"YOUR_MERCHANT_ACCOUNT",
"shopperEmail":"s.hopper@test.com",
"shopperInteraction":"Ecommerce",
"shopperIP":"61.294.12.12",
"recurringProcessingModel":"Subscription"
}

Subsequent payments

Copy code
{
"card":{
"number":"4111111111111111",
"expiryMonth":"8",
"expiryYear":"2018",
"cvc":"737",
"holderName":"John Smith"
},
"amount":{
"value":2000,
"currency":"EUR"
},
"reference":"Your Reference Here",
"merchantAccount":"YOUR_MERCHANT_ACCOUNT",
"shopperEmail":"s.hopper@test.com",
"shopperInteraction":"ContAuth",
"shopperIP":"61.294.12.12",
"recurringProcessingModel":"Subscription"
}