search
System Status

Retrieving sources

Learn how to retrieve a single Source as well as all the Source objects attached to a Customer.

hashtag
Get a Source object by identifier

The following GET /sources/{id} request retrieves a source by supplying its unique identifier as a path parameter.

circle-info

This identifier was returned when you used the DigitalRiver.js library to create the source.

curl --location --request GET 'https://api.digitalriver.com/sources/e59c8303-139a-4077-bd26-78d20b43d52b' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer '<API_key>' \

The response returns a Source object if a valid identifier and API key are provided in the request. The following sample response shows a credit card type Source in a chargeable state.

circle-exclamation

Only the last four digits of credit card numbers are returned by a GET Source request.

{
    "id": "e59c8303-139a-4077-bd26-78d20b43d52b",
    "createdTime": "2020-06-17T19:54:54Z",
    "type": "creditCard",
    "currency": "USD",
    "amount": 24.89,
    "reusable": true,
    "state": "chargeable",
    "customerId": "517796760336",
    "owner": {
        "firstName": "William",
        "lastName": "Brown",
        "email": "[email protected]",
        "address": {
            "line1": "10380 Bren Road West",
            "city": "Minnetonka",
            "postalCode": "55343",
            "state": "MN",
            "country": "US"
        }
    },
    "paymentSessionId": "8ff5840f-b0ec-44f2-8e88-647627a0ba0d",
    "clientSecret": "e59c8303-139a-4077-bd26-78d20b43d52b_5e943931-e4e7-4537-8ae4-f7ff991f463c",
    "creditCard": {
        "brand": "MasterCard",
        "expirationMonth": 5,
        "expirationYear": 2025,
        "lastFourDigits": "0008"
    },
    "liveMode": false
}

hashtag
Obtain a customer's sources

You can retrieve the Sources associated with a Customer by making a get Customer by identifier request and then parsing the sources array contained in the response.

The following GET /customers/{id} request supplies the identifier as a path parameter:

In the response, each element of the sources array consists of a Source object attached to the Customer. In this particular response, the array contains two elements, which means the customer has two saved payment methods, both reusable and chargeable.

hashtag
Display a customer's sources

The data contained in the sources array can display a customer's saved payment methods on your website or app. To do this, parse the response and extract the values in the creditCard, owner, and address hash tables. You can then use these values to present the card's brand name, last four digits, expiration date, and the customer's billing information.

PreviousHandling credit card sourcesNextAuthorization declines

Last updated