Credit Cards

The Credit Cards payment method is a fast and secure shopping experience where the consumer can purchase goods or services on credit.

Credit cards supported: American Express, Diners, Discover, JCB, Maestro, MasterCard, and Visa

You can find an example of integration here.

Create a Credit Card payment method for your app or website in three easy steps:

Supported geographies

Supported Geographies

Andorra

UAE

Argentina

American Samoa

Austria

Australia

Bangladesh

Belgium

Bulgaria

Bahrain

Brazil

Bouvet Islands

Canada

Cocos Islands

Switzerland

Cook Islands

Chile

China

Colombia

Christmas Island

Cyprus

Czech Republic

Germany

Denmark

Ecuador

Estonia

Egypt

Spain

Ethiopia

Finland

Micronesia

Faroe Islands

France

United Kingdom

French Guiana

Greenland

Greece

South Georgia & South Sandwich Islands

Guam

Hong Kong

Heard Island & McDonald Islands

Croatia (Hrvatska)

Indonesia

Ireland

Israel

India

British Indian Ocean Territory

Italy

Jordan

Japan

Kiribati

S. Korea

Kuwait

Lebanon

Liechtenstein

Lithuania

Luxembourg

Latvia

Monaco

Marshall Islands

Northern Mariana Islands Malta Mexico

East Malaysia

East Malaysia

Norfolk Island

Netherlands

Norway

Niue

N Zealand

Oman

Panama

Peru

Philippines

Poland

Saint Pierre & Miquelon

Pitcairn Islands

Puerto Rico

Portugal

Qatar

Reunion

Romania

Russia

Saudi Arabia

Sweden

Singapore

Slovenia

Svalbard & Jan Mayen Islands

Slovakia

San Marino

El Salvador

Tristan da Cunha

Turks & Caicos Islands

Thailand

Tokelau

Turkey

Tuvalu

Taiwan

Ukraine

US Minor Outlying Islands

US

Vatican

Venezuela

S. Africa

Supported Currencies

AED

ARS

AUD

BHD

BRL

CAD

CHF

CLP

CNY

COP

CZK

DKK

EGP

ETB

EUR

GBP

HKD

IDR

ILS

INR

JOD

JPY

KRW

KWD

LBP

MXN

MYR

NOK

NZD

OMR

PHP

PLN

QAR

RUB

SAR

SEK

SGD

THB

TRY

TWD

UAH

USD

ZAR

Step 1. Build a Credit Card Source Request object

Build a Credit Card Source Request object. The Credit Card Source Request object requires the following fields.

Field

Value

type

creditCard

owner

An Owner object.

Step 2. Create a Credit Card source using DigitalRiver.js

Create the elements

To create a credit card payment source, you must use the createSource method exposed via DigitalRiver.js.

var options = {
style: {
base: {
color: "#fff",
fontFamily: "Arial, Helvetica, sans-serif",
fontSize: "16px",
}
}
}
//Create your elements
var cardNumber = digitalriver.createElement('cardnumber', options);
var cardExpiration = digitalriver.createElement("cardexpiration", options);
var cardCVV = digitalriver.createElement("cardcvv", options);
//Place the created elements on the page.
cardNumber.mount('card-number');
cardExpiration.mount('card-expiration');
cardCVV.mount('card-cvv');

Create the source

To create a credit card payment source, you must reference the created element and the supplemental data in your createSource request. DigitalRiver.js will retrieve and assemble the request on your behalf.

var payload = {
"type": "creditCard",
"owner": {
firstName: "John",
lastName: "Doe",
email: "john.doe@digitalriver.com",
phoneNumber: "000-000-0000",
address: {
line1: "10380 Bren Road West",
line2: "Suite 123",
city: "Minnetonka",
state: "MN",
postalCode: "55343",
country: "US"
}
}
}
digitalriver.createSource(cardCVV,payload).then(function(result) {
if(result.error) {
//handle errors
} else {
var source = result.source;
//send source to back end
sendToBackend(source);
}
});

Credit Card source example

{
"clientId": "gc",
"channelId": "drdod15",
"liveMode": false,
"id": "b9914aea-d045-4160-8bd9-12277ee333b1",
"clientSecret": "b9914aea-d045-4160-8bd9-12277ee333b1_a2214aea-d045-4160-8bd9-12277ee333b1",
"type": "creditCard",
"reusable": false,
"owner": {
"firstName": "Destany",
"lastName": "Hackett",
"email": "Jimmy.Trantow63@gmail.com",
"phoneNumber": "000-000-0000",
"address": {
"line1": "1283 Cummings Squares",
"line2": "Suite 917",
"city": "Russelview",
"state": "CO",
"country": "US",
"postalCode": "85501-4084"
}
},
"state": "chargeable",
"creationIp": "209.87.178.4",
"createdTime": "2019-05-22T01:41:59.241Z",
"updatedTime": "2019-05-22T01:41:59.241Z",
"flow": "standard",
"creditCard": {
"brand": "Visa",
"expirationMonth": 2,
"expirationYear": 2022,
"lastFourDigits": "1111",
"paymentIdentifier": "13159976250000000000000500658101"
}
}

Step 3. Use the authorized source

Once authorized, you can use the source by either attaching it to a checkout.or attaching it to a customer for multiple uses.

Option 1. Attach the source to a checkout

POST /checkouts/{id}
{
"customerId": "5774321008",
"sourceId": "src_a78cfeae-f7ae-4719-8e1c-d05ec04e4d37"
}

Option 2. Attach the source to a customer

POST /customers/{id}/sources/{sourcesId}
{
"id": "5774321008",
"sourceId": "src_a78cfeae-f7ae-4719-8e1c-d05ec04e4d37"
}