Customers
The Customers resource is designed to manage customer data effectively by providing endpoints for various operations. It enables you to create new customer records, retrieve a list of existing customers, update details for specific customers, and remove customer records when necessary. This API is essential for maintaining accurate and up-to-date customer information within your application, ensuring seamless integration and efficient data handling.
Get all customers
A cursor for use in pagination. The endingBefore parameter is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with xyz your subsequent calls can include endingBefore=xyz in order to fetch the previous page of the list.
A cursor for use in pagination. The startingAfter parameter is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with xyz, your subsequent calls can include startingAfter=xyz in order to fetch the next page of the list.
A limit on the number of objects returned. Limit can range between 1 and 100, and the default is 10.
Only return customers with the given email
Only return customers with the given IDs
Only return customers where requestToBeForgotten is true or false
GET /customers HTTP/1.1
Host: api.digitalriver.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
"hasMore": true,
"data": [
{
"id": "5823594809",
"createdTime": "2025-06-30T21:27:17.613Z",
"email": "[email protected]",
"shipping": {
"address": {
"line1": "10380 Bren Rd W",
"line2": "text",
"city": "Minnetonka",
"postalCode": "55129",
"state": "MN",
"country": "US"
},
"name": "John Smith",
"phone": "952-111-1111",
"email": "[email protected]",
"organization": "Digital River",
"additionalAddressInfo": {
"neighborhood": "Centro",
"division": "営業部",
"phoneticName": "ヤマダ タロ"
}
},
"defaultSourceId": "123e4567-e89b-12d3-a456-426614174000",
"sources": [
{
"id": "a6809a63-e6a9-4016-abbc-f33d19fccb5b",
"clientSecret": "52199c06-b261-4786-8609-d0a84185a0d2_2b72614b-77f6-4801-bd48-8982e314fdd5",
"createdTime": "2025-06-30T21:27:17.613Z",
"type": "creditCard",
"currency": "USD",
"amount": 1180.26,
"reusable": true,
"owner": {
"firstName": "John",
"lastName": "Smith",
"email": "[email protected]",
"organization": "Digital River",
"upstreamId": "55129-54673",
"address": {
"line1": "10380 Bren Rd W",
"line2": "text",
"city": "Minnetonka",
"postalCode": "55129",
"state": "MN",
"country": "US"
},
"additionalAddressInfo": {
"neighborhood": "Centro",
"division": "営業部",
"phoneticName": "ヤマダ タロ"
}
},
"creditCard": {
"lastFourDigits": "3119",
"expirationMonth": 3,
"expirationYear": 2023,
"brand": "Visa"
},
"googlePay": {
"lastFourDigits": "3119",
"expirationMonth": 2,
"expirationYear": 2022,
"brand": "Visa"
},
"payPal": {
"redirect": {
"redirectUrl": "https://api.digitalriver.com:443/payments/redirects/e626ec65-24d6-46fb-b632-10b90f4c4912?apiKey=pk_test_6cb0fe9ce3124093a9ad906f6c589e2d",
"returnUrl": "https://mypage.com/success",
"cancelUrl": "https://mypage.com/cancel"
},
"directDebit": {
"token": "EC-53H39048EL439164J"
}
},
"payPalBilling": {
"redirect": {
"redirectUrl": "https://api.digitalriver.com:443/payments/redirects/e626ec65-24d6-46fb-b632-10b90f4c4912?apiKey=pk_test_6cb0fe9ce3124093a9ad906f6c589e2d",
"returnUrl": "https://mypage.com/success",
"cancelUrl": "https://mypage.com/cancel"
},
"directDebit": {
"token": "EC-53H39048EL439164J"
}
},
"payPalCredit": {
"redirect": {
"redirectUrl": "https://api.digitalriver.com:443/payments/redirects/e626ec65-24d6-46fb-b632-10b90f4c4912?apiKey=pk_test_6cb0fe9ce3124093a9ad906f6c589e2d",
"returnUrl": "https://mypage.com/success",
"cancelUrl": "https://mypage.com/cancel"
},
"directDebit": {
"token": "EC-53H39048EL439164J"
}
},
"directDebit": {
"redirect": {
"redirectUrl": "https://api.digitalriver.com:443/payments/redirects/75743f60-1023-470e-be48-b761260317af?apiKey=pk_test_6cb0fe9ce3124093a9ad906f6c589e2d",
"returnUrl": "https://mypage.com/success"
}
},
"wireTransfer": {
"accountHolder": "Netgiro Payments AB",
"bankName": "ABN AMRO Bank N.V.",
"city": "Prague",
"country": "ES",
"referenceId": "DR1651067521",
"accountNumber": "0100037259",
"additionalBankInformation": "Codigo de oficina: 0001 Codigo de entidad: 0156 Digitos de control: 09",
"iban": "ES35 0156 0001 0901 0003 7259"
},
"payCo": {
"redirectUrl": "https://api.digitalriver.com:443/payments/redirects/75743f60-1023-470e-be48-b761260317af?apiKey=pk_test_6cb0fe9ce3124093a9ad906f6c589e2d",
"returnUrl": "https://mypage.com/success",
"payCo": {}
},
"alipay": {},
"applePay": {},
"bPay": {
"accountHolder": "Global Collect BV",
"bankName": "Commonwealth Bank",
"city": "Sydney",
"country": "Australia",
"referenceId": "12345678",
"accountNumber": "87654321",
"billId": "112233",
"customerPaymentReference": "443322",
"swiftCode": "CTBAAU2S"
},
"onlineBanking": {
"bankCode": "86"
},
"codJapan": {},
"klarnaCredit": {
"shipping": {
"recipient": "John Doe",
"phoneNumber": "5559895326",
"address": {
"line1": "10380 Bren Road West",
"city": "Minnetonka",
"state": "MN",
"country": "US",
"postalCode": "55343"
},
"email": "[email protected]"
},
"token": "1111222233334444"
},
"klarnaCreditRecurring": {
"returnUrl": "https://example.org/return",
"cancelUrl": "https://example.org/cancel"
},
"konbini": {
"storeId": "33334444",
"receiptNumber": "8675309",
"printableInvoiceUrl": "https://printableinvoice.com",
"storeName": "Seven Eleven",
"localizedStoreName": "セブン‐イレブン",
"storeLogoUrl": "https://storelogo.com"
},
"bankTransfer": {},
"flow": "standard",
"state": "chargeable",
"metadata": {
"coupon": "iOS"
},
"customerId": "5823594809",
"paymentSessionId": "8cecaa32-f692-44cc-b103-4cf24dc93913",
"liveMode": false
}
],
"taxIdentifiers": [
{
"id": "5774321009",
"createdTime": "2025-06-30T21:27:17.613Z",
"customerId": "5774321009",
"type": "de",
"value": "DE123456789",
"state": "pending",
"stateTransitions": {
"pending": "2025-06-30T21:27:17.613Z",
"verified": "2025-06-30T21:27:17.613Z",
"not_valid": "2025-06-30T21:27:17.613Z"
},
"verifiedName": ".",
"verifiedAddress": ".",
"updatedTime": "2025-06-30T21:27:17.613Z",
"applicability": [
{
"country": "FR",
"entity": "DR_Ireland-Entity",
"customerType": "business"
}
]
}
],
"taxCertificates": [
{
"companyName": "Digital River Inc.",
"taxAuthority": "MN",
"startDate": "2025-06-30T21:27:17.613Z",
"endDate": "2025-06-30T21:27:17.613Z",
"fileId": "file_8fd2f808-bbb4-49bc-aa41-c960a1447331"
}
],
"requestToBeForgotten": true,
"type": "individual",
"metadata": {
"coupon": "iOS"
},
"locale": "en_US",
"enabled": true,
"liveMode": false,
"updatedTime": "2025-06-30T21:27:17.613Z"
}
]
}
Creates a new customer object
The unique identifier of a customer.
5823594808
The identifier of the default source attached to this customer.
fd74a5c5-0163-469a-ae8e-031f0259b576
A locale designator that combines the two-letter ISO 639-1 language code with the ISO 3166-1 alpha-2 country code.
en_US
The type of customer.
individual
Possible values: Usually used to disable the customer. The default is true. If false, attempts to create orders for the customer will fail.
true
POST /customers HTTP/1.1
Host: api.digitalriver.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 743
{
"id": "5823594808",
"email": "[email protected]",
"shipping": {
"address": {
"line1": "10380 Bren Rd W",
"line2": "text",
"city": "Minnetonka",
"postalCode": "55129",
"state": "MN",
"country": "US"
},
"name": "John Smith",
"phone": "952-111-1111",
"email": "[email protected]",
"organization": "Digital River",
"additionalAddressInfo": {
"neighborhood": "Centro",
"division": "営業部",
"phoneticName": "ヤマダ タロ"
}
},
"defaultSourceId": "fd74a5c5-0163-469a-ae8e-031f0259b576",
"taxCertificate": {
"companyName": "Digital River Inc.",
"taxAuthority": "MN",
"startDate": "2025-06-30T21:27:17.613Z",
"endDate": "2025-06-30T21:27:17.613Z",
"fileId": "file_8fd2f808-bbb4-49bc-aa41-c960a1447331"
},
"metadata": {
"coupon": "iOS"
},
"locale": "en_US",
"type": "individual",
"enabled": true
}
{
"id": "5823594809",
"createdTime": "2025-06-30T21:27:17.613Z",
"email": "[email protected]",
"shipping": {
"address": {
"line1": "10380 Bren Rd W",
"line2": "text",
"city": "Minnetonka",
"postalCode": "55129",
"state": "MN",
"country": "US"
},
"name": "John Smith",
"phone": "952-111-1111",
"email": "[email protected]",
"organization": "Digital River",
"additionalAddressInfo": {
"neighborhood": "Centro",
"division": "営業部",
"phoneticName": "ヤマダ タロ"
}
},
"defaultSourceId": "123e4567-e89b-12d3-a456-426614174000",
"sources": [
{
"id": "a6809a63-e6a9-4016-abbc-f33d19fccb5b",
"clientSecret": "52199c06-b261-4786-8609-d0a84185a0d2_2b72614b-77f6-4801-bd48-8982e314fdd5",
"createdTime": "2025-06-30T21:27:17.613Z",
"type": "creditCard",
"currency": "USD",
"amount": 1180.26,
"reusable": true,
"owner": {
"firstName": "John",
"lastName": "Smith",
"email": "[email protected]",
"organization": "Digital River",
"upstreamId": "55129-54673",
"address": {
"line1": "10380 Bren Rd W",
"line2": "text",
"city": "Minnetonka",
"postalCode": "55129",
"state": "MN",
"country": "US"
},
"additionalAddressInfo": {
"neighborhood": "Centro",
"division": "営業部",
"phoneticName": "ヤマダ タロ"
}
},
"creditCard": {
"lastFourDigits": "3119",
"expirationMonth": 3,
"expirationYear": 2023,
"brand": "Visa"
},
"googlePay": {
"lastFourDigits": "3119",
"expirationMonth": 2,
"expirationYear": 2022,
"brand": "Visa"
},
"payPal": {
"redirect": {
"redirectUrl": "https://api.digitalriver.com:443/payments/redirects/e626ec65-24d6-46fb-b632-10b90f4c4912?apiKey=pk_test_6cb0fe9ce3124093a9ad906f6c589e2d",
"returnUrl": "https://mypage.com/success",
"cancelUrl": "https://mypage.com/cancel"
},
"directDebit": {
"token": "EC-53H39048EL439164J"
}
},
"payPalBilling": {
"redirect": {
"redirectUrl": "https://api.digitalriver.com:443/payments/redirects/e626ec65-24d6-46fb-b632-10b90f4c4912?apiKey=pk_test_6cb0fe9ce3124093a9ad906f6c589e2d",
"returnUrl": "https://mypage.com/success",
"cancelUrl": "https://mypage.com/cancel"
},
"directDebit": {
"token": "EC-53H39048EL439164J"
}
},
"payPalCredit": {
"redirect": {
"redirectUrl": "https://api.digitalriver.com:443/payments/redirects/e626ec65-24d6-46fb-b632-10b90f4c4912?apiKey=pk_test_6cb0fe9ce3124093a9ad906f6c589e2d",
"returnUrl": "https://mypage.com/success",
"cancelUrl": "https://mypage.com/cancel"
},
"directDebit": {
"token": "EC-53H39048EL439164J"
}
},
"directDebit": {
"redirect": {
"redirectUrl": "https://api.digitalriver.com:443/payments/redirects/75743f60-1023-470e-be48-b761260317af?apiKey=pk_test_6cb0fe9ce3124093a9ad906f6c589e2d",
"returnUrl": "https://mypage.com/success"
}
},
"wireTransfer": {
"accountHolder": "Netgiro Payments AB",
"bankName": "ABN AMRO Bank N.V.",
"city": "Prague",
"country": "ES",
"referenceId": "DR1651067521",
"accountNumber": "0100037259",
"additionalBankInformation": "Codigo de oficina: 0001 Codigo de entidad: 0156 Digitos de control: 09",
"iban": "ES35 0156 0001 0901 0003 7259"
},
"payCo": {
"redirectUrl": "https://api.digitalriver.com:443/payments/redirects/75743f60-1023-470e-be48-b761260317af?apiKey=pk_test_6cb0fe9ce3124093a9ad906f6c589e2d",
"returnUrl": "https://mypage.com/success",
"payCo": {}
},
"alipay": {},
"applePay": {},
"bPay": {
"accountHolder": "Global Collect BV",
"bankName": "Commonwealth Bank",
"city": "Sydney",
"country": "Australia",
"referenceId": "12345678",
"accountNumber": "87654321",
"billId": "112233",
"customerPaymentReference": "443322",
"swiftCode": "CTBAAU2S"
},
"onlineBanking": {
"bankCode": "86"
},
"codJapan": {},
"klarnaCredit": {
"shipping": {
"recipient": "John Doe",
"phoneNumber": "5559895326",
"address": {
"line1": "10380 Bren Road West",
"city": "Minnetonka",
"state": "MN",
"country": "US",
"postalCode": "55343"
},
"email": "[email protected]"
},
"token": "1111222233334444"
},
"klarnaCreditRecurring": {
"returnUrl": "https://example.org/return",
"cancelUrl": "https://example.org/cancel"
},
"konbini": {
"storeId": "33334444",
"receiptNumber": "8675309",
"printableInvoiceUrl": "https://printableinvoice.com",
"storeName": "Seven Eleven",
"localizedStoreName": "セブン‐イレブン",
"storeLogoUrl": "https://storelogo.com"
},
"bankTransfer": {},
"flow": "standard",
"state": "chargeable",
"metadata": {
"coupon": "iOS"
},
"customerId": "5823594809",
"paymentSessionId": "8cecaa32-f692-44cc-b103-4cf24dc93913",
"liveMode": false
}
],
"taxIdentifiers": [
{
"id": "5774321009",
"createdTime": "2025-06-30T21:27:17.613Z",
"customerId": "5774321009",
"type": "de",
"value": "DE123456789",
"state": "pending",
"stateTransitions": {
"pending": "2025-06-30T21:27:17.613Z",
"verified": "2025-06-30T21:27:17.613Z",
"not_valid": "2025-06-30T21:27:17.613Z"
},
"verifiedName": ".",
"verifiedAddress": ".",
"updatedTime": "2025-06-30T21:27:17.613Z",
"applicability": [
{
"country": "FR",
"entity": "DR_Ireland-Entity",
"customerType": "business"
}
]
}
],
"taxCertificates": [
{
"companyName": "Digital River Inc.",
"taxAuthority": "MN",
"startDate": "2025-06-30T21:27:17.613Z",
"endDate": "2025-06-30T21:27:17.613Z",
"fileId": "file_8fd2f808-bbb4-49bc-aa41-c960a1447331"
}
],
"requestToBeForgotten": true,
"type": "individual",
"metadata": {
"coupon": "iOS"
},
"locale": "en_US",
"enabled": true,
"liveMode": false,
"updatedTime": "2025-06-30T21:27:17.613Z"
}
Retrieves the details of a customer by supplying the unique identifier of the customer
Customer ID
GET /customers/{id} HTTP/1.1
Host: api.digitalriver.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
"id": "5823594809",
"createdTime": "2025-06-30T21:27:17.613Z",
"email": "[email protected]",
"shipping": {
"address": {
"line1": "10380 Bren Rd W",
"line2": "text",
"city": "Minnetonka",
"postalCode": "55129",
"state": "MN",
"country": "US"
},
"name": "John Smith",
"phone": "952-111-1111",
"email": "[email protected]",
"organization": "Digital River",
"additionalAddressInfo": {
"neighborhood": "Centro",
"division": "営業部",
"phoneticName": "ヤマダ タロ"
}
},
"defaultSourceId": "123e4567-e89b-12d3-a456-426614174000",
"sources": [
{
"id": "a6809a63-e6a9-4016-abbc-f33d19fccb5b",
"clientSecret": "52199c06-b261-4786-8609-d0a84185a0d2_2b72614b-77f6-4801-bd48-8982e314fdd5",
"createdTime": "2025-06-30T21:27:17.613Z",
"type": "creditCard",
"currency": "USD",
"amount": 1180.26,
"reusable": true,
"owner": {
"firstName": "John",
"lastName": "Smith",
"email": "[email protected]",
"organization": "Digital River",
"upstreamId": "55129-54673",
"address": {
"line1": "10380 Bren Rd W",
"line2": "text",
"city": "Minnetonka",
"postalCode": "55129",
"state": "MN",
"country": "US"
},
"additionalAddressInfo": {
"neighborhood": "Centro",
"division": "営業部",
"phoneticName": "ヤマダ タロ"
}
},
"creditCard": {
"lastFourDigits": "3119",
"expirationMonth": 3,
"expirationYear": 2023,
"brand": "Visa"
},
"googlePay": {
"lastFourDigits": "3119",
"expirationMonth": 2,
"expirationYear": 2022,
"brand": "Visa"
},
"payPal": {
"redirect": {
"redirectUrl": "https://api.digitalriver.com:443/payments/redirects/e626ec65-24d6-46fb-b632-10b90f4c4912?apiKey=pk_test_6cb0fe9ce3124093a9ad906f6c589e2d",
"returnUrl": "https://mypage.com/success",
"cancelUrl": "https://mypage.com/cancel"
},
"directDebit": {
"token": "EC-53H39048EL439164J"
}
},
"payPalBilling": {
"redirect": {
"redirectUrl": "https://api.digitalriver.com:443/payments/redirects/e626ec65-24d6-46fb-b632-10b90f4c4912?apiKey=pk_test_6cb0fe9ce3124093a9ad906f6c589e2d",
"returnUrl": "https://mypage.com/success",
"cancelUrl": "https://mypage.com/cancel"
},
"directDebit": {
"token": "EC-53H39048EL439164J"
}
},
"payPalCredit": {
"redirect": {
"redirectUrl": "https://api.digitalriver.com:443/payments/redirects/e626ec65-24d6-46fb-b632-10b90f4c4912?apiKey=pk_test_6cb0fe9ce3124093a9ad906f6c589e2d",
"returnUrl": "https://mypage.com/success",
"cancelUrl": "https://mypage.com/cancel"
},
"directDebit": {
"token": "EC-53H39048EL439164J"
}
},
"directDebit": {
"redirect": {
"redirectUrl": "https://api.digitalriver.com:443/payments/redirects/75743f60-1023-470e-be48-b761260317af?apiKey=pk_test_6cb0fe9ce3124093a9ad906f6c589e2d",
"returnUrl": "https://mypage.com/success"
}
},
"wireTransfer": {
"accountHolder": "Netgiro Payments AB",
"bankName": "ABN AMRO Bank N.V.",
"city": "Prague",
"country": "ES",
"referenceId": "DR1651067521",
"accountNumber": "0100037259",
"additionalBankInformation": "Codigo de oficina: 0001 Codigo de entidad: 0156 Digitos de control: 09",
"iban": "ES35 0156 0001 0901 0003 7259"
},
"payCo": {
"redirectUrl": "https://api.digitalriver.com:443/payments/redirects/75743f60-1023-470e-be48-b761260317af?apiKey=pk_test_6cb0fe9ce3124093a9ad906f6c589e2d",
"returnUrl": "https://mypage.com/success",
"payCo": {}
},
"alipay": {},
"applePay": {},
"bPay": {
"accountHolder": "Global Collect BV",
"bankName": "Commonwealth Bank",
"city": "Sydney",
"country": "Australia",
"referenceId": "12345678",
"accountNumber": "87654321",
"billId": "112233",
"customerPaymentReference": "443322",
"swiftCode": "CTBAAU2S"
},
"onlineBanking": {
"bankCode": "86"
},
"codJapan": {},
"klarnaCredit": {
"shipping": {
"recipient": "John Doe",
"phoneNumber": "5559895326",
"address": {
"line1": "10380 Bren Road West",
"city": "Minnetonka",
"state": "MN",
"country": "US",
"postalCode": "55343"
},
"email": "[email protected]"
},
"token": "1111222233334444"
},
"klarnaCreditRecurring": {
"returnUrl": "https://example.org/return",
"cancelUrl": "https://example.org/cancel"
},
"konbini": {
"storeId": "33334444",
"receiptNumber": "8675309",
"printableInvoiceUrl": "https://printableinvoice.com",
"storeName": "Seven Eleven",
"localizedStoreName": "セブン‐イレブン",
"storeLogoUrl": "https://storelogo.com"
},
"bankTransfer": {},
"flow": "standard",
"state": "chargeable",
"metadata": {
"coupon": "iOS"
},
"customerId": "5823594809",
"paymentSessionId": "8cecaa32-f692-44cc-b103-4cf24dc93913",
"liveMode": false
}
],
"taxIdentifiers": [
{
"id": "5774321009",
"createdTime": "2025-06-30T21:27:17.613Z",
"customerId": "5774321009",
"type": "de",
"value": "DE123456789",
"state": "pending",
"stateTransitions": {
"pending": "2025-06-30T21:27:17.613Z",
"verified": "2025-06-30T21:27:17.613Z",
"not_valid": "2025-06-30T21:27:17.613Z"
},
"verifiedName": ".",
"verifiedAddress": ".",
"updatedTime": "2025-06-30T21:27:17.613Z",
"applicability": [
{
"country": "FR",
"entity": "DR_Ireland-Entity",
"customerType": "business"
}
]
}
],
"taxCertificates": [
{
"companyName": "Digital River Inc.",
"taxAuthority": "MN",
"startDate": "2025-06-30T21:27:17.613Z",
"endDate": "2025-06-30T21:27:17.613Z",
"fileId": "file_8fd2f808-bbb4-49bc-aa41-c960a1447331"
}
],
"requestToBeForgotten": true,
"type": "individual",
"metadata": {
"coupon": "iOS"
},
"locale": "en_US",
"enabled": true,
"liveMode": false,
"updatedTime": "2025-06-30T21:27:17.613Z"
}
Updates an existing customer
Customer ID
The identifier of the default source attached to this customer.
fd74a5c5-0163-469a-ae8e-031f0259b576
If true, indicates this customer has submitted a request to be forgotten.
true
The type of customer.
individual
Possible values: A locale designator that combines the two-letter ISO 639-1 language code with the ISO 3166-1 alpha-2 country code.
en_US
Usually used to disable the customer. The default is true. If false, attempts to create orders for the customer will fail.
true
POST /customers/{id} HTTP/1.1
Host: api.digitalriver.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 753
{
"email": "[email protected]",
"shipping": {
"address": {
"line1": "10380 Bren Rd W",
"line2": "text",
"city": "Minnetonka",
"postalCode": "55129",
"state": "MN",
"country": "US"
},
"name": "John Smith",
"phone": "952-111-1111",
"email": "[email protected]",
"organization": "Digital River",
"additionalAddressInfo": {
"neighborhood": "Centro",
"division": "営業部",
"phoneticName": "ヤマダ タロ"
}
},
"defaultSourceId": "fd74a5c5-0163-469a-ae8e-031f0259b576",
"taxCertificate": {
"companyName": "Digital River Inc.",
"taxAuthority": "MN",
"startDate": "2025-06-30T21:27:17.613Z",
"endDate": "2025-06-30T21:27:17.613Z",
"fileId": "file_8fd2f808-bbb4-49bc-aa41-c960a1447331"
},
"requestToBeForgotten": true,
"type": "individual",
"metadata": {
"coupon": "iOS"
},
"locale": "en_US",
"enabled": true
}
{
"id": "5823594809",
"createdTime": "2025-06-30T21:27:17.613Z",
"email": "[email protected]",
"shipping": {
"address": {
"line1": "10380 Bren Rd W",
"line2": "text",
"city": "Minnetonka",
"postalCode": "55129",
"state": "MN",
"country": "US"
},
"name": "John Smith",
"phone": "952-111-1111",
"email": "[email protected]",
"organization": "Digital River",
"additionalAddressInfo": {
"neighborhood": "Centro",
"division": "営業部",
"phoneticName": "ヤマダ タロ"
}
},
"defaultSourceId": "123e4567-e89b-12d3-a456-426614174000",
"sources": [
{
"id": "a6809a63-e6a9-4016-abbc-f33d19fccb5b",
"clientSecret": "52199c06-b261-4786-8609-d0a84185a0d2_2b72614b-77f6-4801-bd48-8982e314fdd5",
"createdTime": "2025-06-30T21:27:17.613Z",
"type": "creditCard",
"currency": "USD",
"amount": 1180.26,
"reusable": true,
"owner": {
"firstName": "John",
"lastName": "Smith",
"email": "[email protected]",
"organization": "Digital River",
"upstreamId": "55129-54673",
"address": {
"line1": "10380 Bren Rd W",
"line2": "text",
"city": "Minnetonka",
"postalCode": "55129",
"state": "MN",
"country": "US"
},
"additionalAddressInfo": {
"neighborhood": "Centro",
"division": "営業部",
"phoneticName": "ヤマダ タロ"
}
},
"creditCard": {
"lastFourDigits": "3119",
"expirationMonth": 3,
"expirationYear": 2023,
"brand": "Visa"
},
"googlePay": {
"lastFourDigits": "3119",
"expirationMonth": 2,
"expirationYear": 2022,
"brand": "Visa"
},
"payPal": {
"redirect": {
"redirectUrl": "https://api.digitalriver.com:443/payments/redirects/e626ec65-24d6-46fb-b632-10b90f4c4912?apiKey=pk_test_6cb0fe9ce3124093a9ad906f6c589e2d",
"returnUrl": "https://mypage.com/success",
"cancelUrl": "https://mypage.com/cancel"
},
"directDebit": {
"token": "EC-53H39048EL439164J"
}
},
"payPalBilling": {
"redirect": {
"redirectUrl": "https://api.digitalriver.com:443/payments/redirects/e626ec65-24d6-46fb-b632-10b90f4c4912?apiKey=pk_test_6cb0fe9ce3124093a9ad906f6c589e2d",
"returnUrl": "https://mypage.com/success",
"cancelUrl": "https://mypage.com/cancel"
},
"directDebit": {
"token": "EC-53H39048EL439164J"
}
},
"payPalCredit": {
"redirect": {
"redirectUrl": "https://api.digitalriver.com:443/payments/redirects/e626ec65-24d6-46fb-b632-10b90f4c4912?apiKey=pk_test_6cb0fe9ce3124093a9ad906f6c589e2d",
"returnUrl": "https://mypage.com/success",
"cancelUrl": "https://mypage.com/cancel"
},
"directDebit": {
"token": "EC-53H39048EL439164J"
}
},
"directDebit": {
"redirect": {
"redirectUrl": "https://api.digitalriver.com:443/payments/redirects/75743f60-1023-470e-be48-b761260317af?apiKey=pk_test_6cb0fe9ce3124093a9ad906f6c589e2d",
"returnUrl": "https://mypage.com/success"
}
},
"wireTransfer": {
"accountHolder": "Netgiro Payments AB",
"bankName": "ABN AMRO Bank N.V.",
"city": "Prague",
"country": "ES",
"referenceId": "DR1651067521",
"accountNumber": "0100037259",
"additionalBankInformation": "Codigo de oficina: 0001 Codigo de entidad: 0156 Digitos de control: 09",
"iban": "ES35 0156 0001 0901 0003 7259"
},
"payCo": {
"redirectUrl": "https://api.digitalriver.com:443/payments/redirects/75743f60-1023-470e-be48-b761260317af?apiKey=pk_test_6cb0fe9ce3124093a9ad906f6c589e2d",
"returnUrl": "https://mypage.com/success",
"payCo": {}
},
"alipay": {},
"applePay": {},
"bPay": {
"accountHolder": "Global Collect BV",
"bankName": "Commonwealth Bank",
"city": "Sydney",
"country": "Australia",
"referenceId": "12345678",
"accountNumber": "87654321",
"billId": "112233",
"customerPaymentReference": "443322",
"swiftCode": "CTBAAU2S"
},
"onlineBanking": {
"bankCode": "86"
},
"codJapan": {},
"klarnaCredit": {
"shipping": {
"recipient": "John Doe",
"phoneNumber": "5559895326",
"address": {
"line1": "10380 Bren Road West",
"city": "Minnetonka",
"state": "MN",
"country": "US",
"postalCode": "55343"
},
"email": "[email protected]"
},
"token": "1111222233334444"
},
"klarnaCreditRecurring": {
"returnUrl": "https://example.org/return",
"cancelUrl": "https://example.org/cancel"
},
"konbini": {
"storeId": "33334444",
"receiptNumber": "8675309",
"printableInvoiceUrl": "https://printableinvoice.com",
"storeName": "Seven Eleven",
"localizedStoreName": "セブン‐イレブン",
"storeLogoUrl": "https://storelogo.com"
},
"bankTransfer": {},
"flow": "standard",
"state": "chargeable",
"metadata": {
"coupon": "iOS"
},
"customerId": "5823594809",
"paymentSessionId": "8cecaa32-f692-44cc-b103-4cf24dc93913",
"liveMode": false
}
],
"taxIdentifiers": [
{
"id": "5774321009",
"createdTime": "2025-06-30T21:27:17.613Z",
"customerId": "5774321009",
"type": "de",
"value": "DE123456789",
"state": "pending",
"stateTransitions": {
"pending": "2025-06-30T21:27:17.613Z",
"verified": "2025-06-30T21:27:17.613Z",
"not_valid": "2025-06-30T21:27:17.613Z"
},
"verifiedName": ".",
"verifiedAddress": ".",
"updatedTime": "2025-06-30T21:27:17.613Z",
"applicability": [
{
"country": "FR",
"entity": "DR_Ireland-Entity",
"customerType": "business"
}
]
}
],
"taxCertificates": [
{
"companyName": "Digital River Inc.",
"taxAuthority": "MN",
"startDate": "2025-06-30T21:27:17.613Z",
"endDate": "2025-06-30T21:27:17.613Z",
"fileId": "file_8fd2f808-bbb4-49bc-aa41-c960a1447331"
}
],
"requestToBeForgotten": true,
"type": "individual",
"metadata": {
"coupon": "iOS"
},
"locale": "en_US",
"enabled": true,
"liveMode": false,
"updatedTime": "2025-06-30T21:27:17.613Z"
}
Permanently deletes a customer by supplying the unique identifier of the customer
Customer ID
DELETE /customers/{id} HTTP/1.1
Host: api.digitalriver.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
No content
Attaches a source to a customer
Customer ID
Source ID
POST /customers/{id}/sources/{sourceId} HTTP/1.1
Host: api.digitalriver.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
"id": "a6809a63-e6a9-4016-abbc-f33d19fccb5b",
"clientSecret": "52199c06-b261-4786-8609-d0a84185a0d2_2b72614b-77f6-4801-bd48-8982e314fdd5",
"createdTime": "2025-06-30T21:27:17.613Z",
"type": "creditCard",
"currency": "USD",
"amount": 1180.26,
"reusable": true,
"owner": {
"firstName": "John",
"lastName": "Smith",
"email": "[email protected]",
"organization": "Digital River",
"upstreamId": "55129-54673",
"address": {
"line1": "10380 Bren Rd W",
"line2": "text",
"city": "Minnetonka",
"postalCode": "55129",
"state": "MN",
"country": "US"
},
"additionalAddressInfo": {
"neighborhood": "Centro",
"division": "営業部",
"phoneticName": "ヤマダ タロ"
}
},
"creditCard": {
"lastFourDigits": "3119",
"expirationMonth": 3,
"expirationYear": 2023,
"brand": "Visa"
},
"googlePay": {
"lastFourDigits": "3119",
"expirationMonth": 2,
"expirationYear": 2022,
"brand": "Visa"
},
"payPal": {
"redirect": {
"redirectUrl": "https://api.digitalriver.com:443/payments/redirects/e626ec65-24d6-46fb-b632-10b90f4c4912?apiKey=pk_test_6cb0fe9ce3124093a9ad906f6c589e2d",
"returnUrl": "https://mypage.com/success",
"cancelUrl": "https://mypage.com/cancel"
},
"directDebit": {
"token": "EC-53H39048EL439164J"
}
},
"payPalBilling": {
"redirect": {
"redirectUrl": "https://api.digitalriver.com:443/payments/redirects/e626ec65-24d6-46fb-b632-10b90f4c4912?apiKey=pk_test_6cb0fe9ce3124093a9ad906f6c589e2d",
"returnUrl": "https://mypage.com/success",
"cancelUrl": "https://mypage.com/cancel"
},
"directDebit": {
"token": "EC-53H39048EL439164J"
}
},
"payPalCredit": {
"redirect": {
"redirectUrl": "https://api.digitalriver.com:443/payments/redirects/e626ec65-24d6-46fb-b632-10b90f4c4912?apiKey=pk_test_6cb0fe9ce3124093a9ad906f6c589e2d",
"returnUrl": "https://mypage.com/success",
"cancelUrl": "https://mypage.com/cancel"
},
"directDebit": {
"token": "EC-53H39048EL439164J"
}
},
"directDebit": {
"redirect": {
"redirectUrl": "https://api.digitalriver.com:443/payments/redirects/75743f60-1023-470e-be48-b761260317af?apiKey=pk_test_6cb0fe9ce3124093a9ad906f6c589e2d",
"returnUrl": "https://mypage.com/success"
}
},
"wireTransfer": {
"accountHolder": "Netgiro Payments AB",
"bankName": "ABN AMRO Bank N.V.",
"city": "Prague",
"country": "ES",
"referenceId": "DR1651067521",
"accountNumber": "0100037259",
"additionalBankInformation": "Codigo de oficina: 0001 Codigo de entidad: 0156 Digitos de control: 09",
"iban": "ES35 0156 0001 0901 0003 7259"
},
"payCo": {
"redirectUrl": "https://api.digitalriver.com:443/payments/redirects/75743f60-1023-470e-be48-b761260317af?apiKey=pk_test_6cb0fe9ce3124093a9ad906f6c589e2d",
"returnUrl": "https://mypage.com/success",
"payCo": {}
},
"alipay": {},
"applePay": {},
"bPay": {
"accountHolder": "Global Collect BV",
"bankName": "Commonwealth Bank",
"city": "Sydney",
"country": "Australia",
"referenceId": "12345678",
"accountNumber": "87654321",
"billId": "112233",
"customerPaymentReference": "443322",
"swiftCode": "CTBAAU2S"
},
"onlineBanking": {
"bankCode": "86"
},
"codJapan": {},
"klarnaCredit": {
"shipping": {
"recipient": "John Doe",
"phoneNumber": "5559895326",
"address": {
"line1": "10380 Bren Road West",
"city": "Minnetonka",
"state": "MN",
"country": "US",
"postalCode": "55343"
},
"email": "[email protected]"
},
"token": "1111222233334444"
},
"klarnaCreditRecurring": {
"returnUrl": "https://example.org/return",
"cancelUrl": "https://example.org/cancel"
},
"konbini": {
"storeId": "33334444",
"receiptNumber": "8675309",
"printableInvoiceUrl": "https://printableinvoice.com",
"storeName": "Seven Eleven",
"localizedStoreName": "セブン‐イレブン",
"storeLogoUrl": "https://storelogo.com"
},
"bankTransfer": {},
"flow": "standard",
"state": "chargeable",
"metadata": {
"coupon": "iOS"
},
"customerId": "5823594809",
"paymentSessionId": "8cecaa32-f692-44cc-b103-4cf24dc93913",
"liveMode": false
}
Detaches a source from a customer
Customer ID
Source ID
DELETE /customers/{id}/sources/{sourceId} HTTP/1.1
Host: api.digitalriver.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
No content
Attaches a tax identifier to a customer
Customer ID
Tax ID
POST /customers/{id}/tax-identifiers/{taxId} HTTP/1.1
Host: api.digitalriver.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
"id": "5774321009",
"createdTime": "2025-06-30T21:27:17.613Z",
"customerId": "5774321009",
"type": "de",
"value": "DE123456789",
"state": "pending",
"stateTransitions": {
"pending": "2025-06-30T21:27:17.613Z",
"verified": "2025-06-30T21:27:17.613Z",
"not_valid": "2025-06-30T21:27:17.613Z"
},
"verifiedName": ".",
"verifiedAddress": ".",
"updatedTime": "2025-06-30T21:27:17.613Z"
}
Last updated