Search docs

Are you looking for test card numbers?

Would you like to contact support?

Start searching Adyen's documentation...


Retrieve stored details

After you store payment details along with an /authorisation call, you need the recurringDetailReference to refer to the stored details in other requests.


To retrieve the payment details and their reference number, use the /listRecurringDetails call. In this call, pass your merchant account and a reference of a shopper, whose payment details were previously stored.

For information on all available fields, see RecurringDetailsRequest.

The following example demonstrates how to get payment details stored with your TestMerchant account for a shopper 14194858.

curl \
 -d merchantAccount=TestMerchant \
 -d shopperReference=14194858
<?xml version="1.0"?>
<soap:Envelope xmlns:soap="" xmlns:xsd="" xmlns:xsi="">
    <ns1:listRecurringDetails xmlns:ns1=""> 


If there are payment details stored for the specified shopperReference, the response contains one or more RecurringDetail objects. In this object some fields may be missing or nil, depending on the payment method being used.

The response is different in the following scenarios:

  • If the shopperReference does not exist, the endpoint returns an empty object.
  • If the shopperReference exists but the request contains a specific contract type and a recurring detail for that contract does not exist, the details array is not included in the response.

For information on all fields available in a response, see RecurringDetailsResult.

The following example shows the response if a shopper 14194858 stored the details of their VISA Debit card with a number starting with 492179. In this case, the recurringDetailReference is equal to 8313147988756818. 

               "holderName":"John Doe",
            "contractTypes": [
            "name": "1132",
<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="" xmlns:xsd="" xmlns:xsi="">
        <ns1:listRecurringDetailsResponse xmlns:ns1="">
                <creationDate xmlns="">2015-07-30T22:54:13+02:00</creationDate>
                <details xmlns="">
                                <key xsi:type="xsd:string">cardBin</key>
                                <value xsi:type="xsd:string">492179</value>
                        <bank xsi:nil="true"/>
                        <billingAddress xsi:nil="true"/>
                            <billingAddress xmlns="" xsi:nil="true"/>
                            <cvc xmlns="" xsi:nil="true"/>
                            <expiryMonth xmlns="">2</expiryMonth>
                            <expiryYear xmlns="">2017</expiryYear>
                            <holderName xmlns="">John Doe</holderName>
                            <issueNumber xmlns="" xsi:nil="true"/>
                            <number xmlns="">0380</number>
                            <startMonth xmlns="" xsi:nil="true"/>
                            <startYear xmlns="" xsi:nil="true"/>
                        <elv xsi:nil="true"/>
                        <name xsi:nil="true"/>
                        <shopperName xsi:nil="true"/>
                        <socialSecurityNumber xsi:nil="true"/>
                        <tokenDetails xsi:nil="true"/>
                <lastKnownShopperEmail xmlns=""></lastKnownShopperEmail>
                <shopperReference xmlns="">14194858</shopperReference>

Next steps