Are you looking for test card numbers?

Would you like to contact support?

No momento, esta página não está disponível em português
Classic-integration icon

Authorise a recurring payment

This page is for our Classic API (/authorise) integration. If you are integrating using our Checkout APIs, refer to the Tokenization documentation instead.

After you successfully stored payment details during the first /authorise call, you can refer to these details in subsequent calls every time a recurring payment should take place.

One-click payments

For one-click payments, include in your /authorise request:

  • card.cvc: the card CVC that you collected from the shopper.
  • recurring.contract: ONECLICK
  • shopperReference: The shopperReference that you specified when storing the payment details.
  • shopperInteraction: ContAuth
  • selectedRecurringDetailReference: Either the recurringDetailReference returned from the list of all stored details based on the shopperReference, or LATEST to use the most recent recurring detail.

The following code examples show the request of a one-click payment in JSON, SOAP, and FORM.

{
   "amount":{
      "value":2000,
      "currency":"EUR"
   },
   "card":{
      "cvc":"737"
   },
   "reference":"Your Reference Here",
   "merchantAccount":"TestMerchant",
   "shopperEmail":"s.hopper@test.com",
   "shopperIP":"61.294.12.12",
   "shopperReference":"YOUR_UNIQUE_SHOPPER_ID_IOfW3k9G2PvXFu2j",
   "selectedRecurringDetailReference":"LATEST",
   "recurring":{
      "contract":"ONECLICK"
   },
   "shopperInteraction":"ContAuth"
}
<?xml version="1.0"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema- instance">
  <soap:Body>
    <ns1:authorise xmlns:ns1="http://payment.services.adyen.com">
      <ns1:paymentRequest>
        <amount xmlns="http://payment.services.adyen.com">
          <currency xmlns="http://common.services.adyen.com">EUR</currency>
          <value xmlns="http://common.services.adyen.com">2000</value>
        </amount>
        <card xmlns="http://payment.services.adyen.com">
          <cvc xmlns="http://payment.services.adyen.com">737</cvc>
        </card>
        <merchantAccount xmlns="http://payment.services.adyen.com">TestMerchant</merchantAccount>
        <reference xmlns="http://payment.services.adyen.com">Your Reference Here</reference>
        <shopperEmail xmlns="http://payment.services.adyen.com">s.hopper@test.com</shopperEmail>
        <shopperIP xmlns="http://payment.services.adyen.com">61.294.12.12</shopperIP>
        <shopperReference xmlns="http://payment.services.adyen.com">YOUR_UNIQUE_SHOPPER_ID_IOfW3k9G2PvXFu2j</shopperReference>
        <selectedRecurringDetailReference xmlns="http://payment.services.adyen.com">LATEST</selectedRecurringDetailReference>
        <recurring xmlns="http://payment.services.adyen.com">
          <contract xmlns="http://payment.services.adyen.com">ONECLICK</contract>
        </recurring>
        <shopperInteraction xmlns="http://payment.services.adyen.com">ContAuth</shopperInteraction>
       </ns1:paymentRequest>
    </ns1:authorise>
  </soap:Body>
</soap:Envelope>
merchantAccount=TestMerchant&amount.value=2000&amount.currency=EUR&card.cvc=737&reference=Your+Reference+Here&shopperReference=YOUR_UNIQUE_SHOPPER_ID_IOfW3k9G2PvXFu2j&shopperEmail=s.hopper%40test.com&shopperIP=61.294.12.12&recurring.contract=ONECLICK&selectedRecurringDetailReference=LATEST&shopperInteraction=ContAuth

If you are hosting the CSE library, include the encrypted card CVC in additionalData:

{
   "amount":{
      "value":2000,
      "currency":"EUR"
   },
   "additionalData":{
      "card.encrypted.json":"adyenjs_0_1_18$*******"
   },
   "reference":"Your Reference Here",
   "merchantAccount":"YOUR_MERCHANT_ACCOUNT",
   "shopperEmail":"s.hopper@test.com",
   "shopperIP":"61.294.12.12",
   "shopperReference":"YOUR_UNIQUE_SHOPPER_ID_IOfW3k9G2PvXFu2j",
   "selectedRecurringDetailReference":"LATEST",
   "recurring":{
      "contract":"ONECLICK"
   },
   "shopperInteraction":"ContAuth"
} 

Recurring payments

For recurring payments, include in your /authorise request:

  • recurring.contract: RECURRING
  • shopperReference: The shopperReference that you specified when storing the payment details.
  • shopperInteraction: ContAuth
  • selectedRecurringDetailReference: Either the recurringDetailReference returned from the list of all stored details based on the shopperReference, or LATEST to use the most recent recurring detail.

The following code examples show the request of a recurring payment in JSON, SOAP, and cURL.

{
   "amount":{
      "value":2000,
      "currency":"EUR"
   },
   "reference":"Your Reference Here",
   "merchantAccount":"TestMerchant",
   "shopperEmail":"s.hopper@test.com",
   "shopperIP":"61.294.12.12",
   "shopperReference":"YOUR_UNIQUE_SHOPPER_ID_IOfW3k9G2PvXFu2j",
   "selectedRecurringDetailReference":"LATEST",
   "recurring":{
      "contract":"RECURRING"
   },
   "shopperInteraction":"ContAuth"
}
<?xml version="1.0"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema- instance">
  <soap:Body>
    <ns1:authorise xmlns:ns1="http://payment.services.adyen.com">
      <ns1:paymentRequest>
        <amount xmlns="http://payment.services.adyen.com">
          <currency xmlns="http://common.services.adyen.com">EUR</currency>
          <value xmlns="http://common.services.adyen.com">2000</value>
        </amount>
        <merchantAccount xmlns="http://payment.services.adyen.com">TestMerchant</merchantAccount>
        <reference xmlns="http://payment.services.adyen.com">Your Reference Here</reference>
        <shopperEmail xmlns="http://payment.services.adyen.com">s.hopper@test.com</shopperEmail>
        <shopperIP xmlns="http://payment.services.adyen.com">61.294.12.12</shopperIP>
        <shopperReference xmlns="http://payment.services.adyen.com">YOUR_UNIQUE_SHOPPER_ID_IOfW3k9G2PvXFu2j</shopperReference>
        <selectedRecurringDetailReference xmlns="http://payment.services.adyen.com">LATEST</selectedRecurringDetailReference>
        <recurring xmlns="http://payment.services.adyen.com">
          <contract xmlns="http://payment.services.adyen.com">RECURRING</contract>
        </recurring>
        <shopperInteraction xmlns="http://payment.services.adyen.com">ContAuth</shopperInteraction>
       </ns1:paymentRequest>
    </ns1:authorise>
  </soap:Body>
</soap:Envelope>
curl https://pal-test.adyen.com/pal/servlet/Payment/v46/authorise \
 -d amount.value=2000 \
 -d amount.currency=EUR \
 -d reference=Your+Reference+Here \
 -d merchantAccount=TestMerchant \
 -d shopperEmail=s.hopper%40test.com \
 -d shopperIP=61.294.12.12 \
 -d shopperReference=YOUR_UNIQUE_SHOPPER_ID_IOfW3k9G2PvXFu2j \
 -d selectedRecurringDetailReference=LATEST \
 -d recurring.contract=RECURRING \
 -d shopperInteraction=ContAuth

Next steps