---
title: "Store payment details"
url: "https://docs.adyen.com/online-payments/classic-integrations/classic-api-integration/tokenization/store-payment-details"
source_url: "https://docs.adyen.com/online-payments/classic-integrations/classic-api-integration/tokenization/store-payment-details.md"
canonical: "https://docs.adyen.com/online-payments/classic-integrations/classic-api-integration/tokenization/store-payment-details"
last_modified: "2019-09-02T15:13:00+02:00"
language: "en"
---

# Store payment details

[View source](/online-payments/classic-integrations/classic-api-integration/tokenization/store-payment-details.md)

**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 [Tokenization](/online-payments/tokenization) integration. To use this newer integration, you must also [migrate to the Checkout API](/online-payments/upgrade-your-integration/migrate-to-checkout-api).

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](https://docs.adyen.com/api-explorer/#/Payment/latest/authorise__reqParam_recurringProcessingModel).

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](https://docs.adyen.com/api-explorer/#/Payment/authorise) endpoint in JSON, SOAP, and cURL.

#### JSON

```json
{
   "amount":{
      "value":2000,
      "currency":"EUR"
   },
   "card":{
      "number":"4111111111111111",
      "expiryMonth":"3",
      "expiryYear":"2030",
      "cvc":"737",
      "holderName":"John Smith"
   },
   "reference":"Your Reference Here",
   "merchantAccount":"TestMerchant",
   "shopperEmail":"s.hopper@test.com",
   "shopperIP":"61.294.12.12",
   "shopperReference":"YOUR_UNIQUE_SHOPPER_ID_IOfW3k9G2PvXFu2j",
   "recurring":{
      "contract":"RECURRING,ONECLICK"
   },
   "recurringProcessingModel": "Subscription"
}
```

#### Soap

```xml
<?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">
          <value xmlns="http://common.services.adyen.com">2000</value>
          <currency xmlns="http://common.services.adyen.com">EUR</currency>
        </amount>
        <card xmlns="http://payment.services.adyen.com">
          <cvc>737</cvc>
          <expiryMonth>03</expiryMonth>
          <expiryYear>2030</expiryYear>
          <holderName>Adyen Test</holderName>
          <number>4111111111111111</number>
        </card>
        <merchantAccount xmlns="http://payment.services.adyen.com" >SupportAdyenTest</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>
        <recurring>
          <contract>RECURRING,ONECLICK</contract>
        </recurring>
        <recurringProcessingModel xmlns="http://payment.services.adyen.com">Subscription</recurringProcessingModel>
      </ns1:paymentRequest>
    </ns1:authorise>
  </soap:Body>
</soap:Envelope>
```

#### curl

```bash
curl https://pal-test.adyen.com/pal/servlet/Payment/v46/authorise \
-H 'x-api-key: ADYEN_API_KEY' \
-H 'content-type: application/json' \
-d '{
 "amount": {
   "value": 2000,
   "currency": "EUR"
 },
 "card": {
   "number": "4111111111111111",
   "expiryMonth": "03",
   "expiryYear": "2030",
   "cvc": "737",
   "holderName": "John Smith"
 },
 "reference": "Your Reference Here",
 "merchantAccount": "TestMerchant",
 "shopperEmail": "s.hopper@test.com",
 "shopperIP": "61.294.12.12",
 "shopperReference": "YOUR_UNIQUE_SHOPPER_ID",
 "recurring": {
   "contract": ["RECURRING", "ONECLICK"]
 },
 "recurringProcessingModel": "Subscription"
}'
```

#### Java

```java
// Adyen Java API Library v25.0.0
import com.adyen.Client;
import com.adyen.enums.Environment;
import com.adyen.model.payment.*;
import java.time.OffsetDateTime;
import java.util.*;
import com.adyen.service.*;

Client client = new Client("ADYEN_API_KEY", Environment.TEST);

// Create the request object(s)
Amount amount = new Amount()
  .currency("EUR")
  .value(2000L);

Recurring recurring = new Recurring()
  .contract(Recurring.ContractEnum.["RECURRING","ONECLICK"]);

Card card = new Card()
  .number("4111111111111111")
  .cvc("737")
  .holderName("John Smith")
  .expiryMonth("03")
  .expiryYear("2030");

PaymentRequest paymentRequest = new PaymentRequest()
  .reference("Your Reference Here")
  .amount(amount)
  .merchantAccount("TestMerchant")
  .recurring(recurring)
  .recurringProcessingModel(PaymentRequest.RecurringProcessingModelEnum.SUBSCRIPTION)
  .shopperEmail("s.hopper@test.com")
  .shopperIP("61.294.12.12")
  .card(card)
  .shopperReference("YOUR_UNIQUE_SHOPPER_ID");

// Make the API call
paymentApi service = new paymentApi(client);
PaymentResult response = service.authorise(paymentRequest, null);
```

#### PHP

```php
// Adyen PHP API Library v17.4.0
use Adyen\Client;
use Adyen\Environment;
use Adyen\Model\Payments\Amount;
use Adyen\Model\Payments\Recurring;
use Adyen\Model\Payments\Card;
use Adyen\Model\Payments\PaymentRequest;
use Adyen\Service\Payments\PaymentsApi;

$client = new Client();
$client->setXApiKey("ADYEN_API_KEY");
$client->setEnvironment(Environment::TEST);


// Create the request object(s)
$amount = new Amount();
$amount
  ->setCurrency("EUR")
  ->setValue(2000);

$recurring = new Recurring();
$recurring
  ->setContract("["RECURRING","ONECLICK"]");

$card = new Card();
$card
  ->setNumber("4111111111111111")
  ->setCvc("737")
  ->setHolderName("John Smith")
  ->setExpiryMonth("03")
  ->setExpiryYear("2030");

$paymentRequest = new PaymentRequest();
$paymentRequest
  ->setReference("Your Reference Here")
  ->setAmount($amount)
  ->setMerchantAccount("TestMerchant")
  ->setRecurring($recurring)
  ->setRecurringProcessingModel("Subscription")
  ->setShopperEmail("s.hopper@test.com")
  ->setShopperIP("61.294.12.12")
  ->setCard($card)
  ->setShopperReference("YOUR_UNIQUE_SHOPPER_ID");

// Make the API call
$service = new PaymentsApi($client);
$response = $service->authorise($paymentRequest);
```

#### C\#

```cs
// Adyen .net API Library v14.4.0
using Adyen;
using Environment = Adyen.Model.Environment;
using Adyen.Model;
using Adyen.Model.Payment;
using Adyen.Service;

var config = new Config()
{
    XApiKey = "ADYEN_API_KEY",
    Environment = Environment.Test
};
var client = new Client(config);

// Create the request object(s)
Amount amount = new Amount
{
  Currency = "EUR",
  Value = 2000
};

Recurring recurring = new Recurring
{
  Contract = Recurring.ContractEnum.["RECURRING","ONECLICK"]
};

Card card = new Card
{
  Number = "4111111111111111",
  Cvc = "737",
  HolderName = "John Smith",
  ExpiryMonth = "03",
  ExpiryYear = "2030"
};

PaymentRequest paymentRequest = new PaymentRequest
{
  Reference = "Your Reference Here",
  Amount = amount,
  MerchantAccount = "TestMerchant",
  Recurring = recurring,
  RecurringProcessingModel = PaymentRequest.RecurringProcessingModelEnum.Subscription,
  ShopperEmail = "s.hopper@test.com",
  ShopperIP = "61.294.12.12",
  Card = card,
  ShopperReference = "YOUR_UNIQUE_SHOPPER_ID"
};

// Make the API call
var service = new PaymentService(client);
var response = service.Authorise(paymentRequest);
```

#### NodeJS (JavaScript)

```js
// Adyen Node API Library v16.2.0
// Require the parts of the module you want to use
const { Client, PaymentAPI } = require('@adyen/api-library');
// Initialize the client object
const client = new Client({apiKey: "ADYEN_API_KEY", environment: "TEST"});

// Create the request object(s)
const paymentRequest = {
  amount: {
    value: 2000,
    currency: "EUR"
  },
  card: {
    number: "4111111111111111",
    expiryMonth: "03",
    expiryYear: "2030",
    cvc: "737",
    holderName: "John Smith"
  },
  reference: "Your Reference Here",
  merchantAccount: "TestMerchant",
  shopperEmail: "s.hopper@test.com",
  shopperIP: "61.294.12.12",
  shopperReference: "YOUR_UNIQUE_SHOPPER_ID",
  recurring: {
    contract: [ "RECURRING", "ONECLICK" ]
  },
  recurringProcessingModel: "Subscription"
}

// Make the API call
const paymentAPI = new PaymentAPI(client);
const response = paymentAPI.authorise(paymentRequest);
```

#### Go

```go
// Adyen Go API Library v9.3.0
import (
  "context"
  "github.com/adyen/adyen-go-api-library/v9/src/common"
  "github.com/adyen/adyen-go-api-library/v9/src/adyen"
  "github.com/adyen/adyen-go-api-library/v9/src/payments"
)
client := adyen.NewClient(&common.Config{
  ApiKey:      "ADYEN_API_KEY",
  Environment: common.TestEnv,
})

// Create the request object(s)
amount := payments.Amount{
  Currency: "EUR",
  Value: 2000,
}

recurring := payments.Recurring{
  Contract: common.PtrString("["RECURRING","ONECLICK"]"),
}

card := payments.Card{
  Number: common.PtrString("4111111111111111"),
  Cvc: common.PtrString("737"),
  HolderName: common.PtrString("John Smith"),
  ExpiryMonth: common.PtrString("03"),
  ExpiryYear: common.PtrString("2030"),
}

paymentRequest := payments.PaymentRequest{
  Reference: "Your Reference Here",
  Amount: amount,
  MerchantAccount: "TestMerchant",
  Recurring: &recurring,
  RecurringProcessingModel: common.PtrString("Subscription"),
  ShopperEmail: common.PtrString("s.hopper@test.com"),
  ShopperIP: common.PtrString("61.294.12.12"),
  Card: &card,
  ShopperReference: common.PtrString("YOUR_UNIQUE_SHOPPER_ID"),
}

// Make the API call
service := client.Payments()
req := service.PaymentsApi.AuthoriseInput().PaymentRequest(paymentRequest)
res, httpRes, err := service.PaymentsApi.Authorise(context.Background(), req)
```

#### Python

```py
# Adyen Python API Library v12.2.0
import Adyen

adyen = Adyen.Adyen()
adyen.client.xapikey = "ADYEN_API_KEY"
adyen.client.platform = "test" # The environment to use library in.

# Create the request object(s)
json_request = {
  "amount": {
    "value": 2000,
    "currency": "EUR"
  },
  "card": {
    "number": "4111111111111111",
    "expiryMonth": "03",
    "expiryYear": "2030",
    "cvc": "737",
    "holderName": "John Smith"
  },
  "reference": "Your Reference Here",
  "merchantAccount": "TestMerchant",
  "shopperEmail": "s.hopper@test.com",
  "shopperIP": "61.294.12.12",
  "shopperReference": "YOUR_UNIQUE_SHOPPER_ID",
  "recurring": {
    "contract": [ "RECURRING", "ONECLICK" ]
  },
  "recurringProcessingModel": "Subscription"
}

# Make the API call
result = adyen.payment.payments_api.authorise(request=json_request)
```

#### Ruby

```rb
# Adyen Ruby API Library v9.3.0
require "adyen-ruby-api-library"

adyen = Adyen::Client.new
adyen.api_key = 'ADYEN_API_KEY'
adyen.env = :test # Set to "live" for live environment

# Create the request object(s)
request_body = {
  :amount => {
    :value => 2000,
    :currency => 'EUR'
  },
  :card => {
    :number => '4111111111111111',
    :expiryMonth => '03',
    :expiryYear => '2030',
    :cvc => '737',
    :holderName => 'John Smith'
  },
  :reference => 'Your Reference Here',
  :merchantAccount => 'TestMerchant',
  :shopperEmail => 's.hopper@test.com',
  :shopperIP => '61.294.12.12',
  :shopperReference => 'YOUR_UNIQUE_SHOPPER_ID',
  :recurring => {
    :contract => [ 'RECURRING', 'ONECLICK' ]
  },
  :recurringProcessingModel => 'Subscription'
}

# Make the API call
result = adyen.payment.payments_api.authorise(request_body)
```

#### NodeJS (TypeScript)

```ts
// Adyen Node API Library v16.2.0
// Require the parts of the module you want to use
import { Client, PaymentAPI, Types } from "@adyen/api-library";
// Initialize the client object
const client = new Client({apiKey: "ADYEN_API_KEY", environment: "TEST"});

// Create the request object(s)
const amount: Types.payment.Amount = {
  currency: "EUR",
  value: 2000
};

const recurring: Types.payment.Recurring = {
  contract: Types.payment.Recurring.ContractEnum.["RECURRING","ONECLICK"]
};

const card: Types.payment.Card = {
  number: "4111111111111111",
  cvc: "737",
  holderName: "John Smith",
  expiryMonth: "03",
  expiryYear: "2030"
};

const paymentRequest: Types.payment.PaymentRequest = {
  reference: "Your Reference Here",
  amount: amount,
  merchantAccount: "TestMerchant",
  recurring: recurring,
  recurringProcessingModel: Types.payment.PaymentRequest.RecurringProcessingModelEnum.Subscription,
  shopperEmail: "s.hopper@test.com",
  shopperIP: "61.294.12.12",
  card: card,
  shopperReference: "YOUR_UNIQUE_SHOPPER_ID"
};

// Make the API call
const paymentAPI = new PaymentAPI(client);
const response = paymentAPI.authorise(paymentRequest);
```

When you are ready to process a subsequent payment, set the value of the `selectedRecurringDetailReference` to either:

* The `recurringDetailReference` returned from the list of all stored recurring details based on the `shopperReference` provided 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**.