Configuring CCAvenue

Learn how to configure CCAvenue for DigitalRiver.js with Elements.

CCAvenue is an auto-settle payment method offering locale India payment options such as Credit Card, Wallet, Net Banking, and UPI.

Configuring CCAvenue for DigitalRiver.js

Create a method for your app or website in four easy steps:

Step 1: Build a CCAvenue Source Request and Details object

Build the CCAvenue Source Request and Details objects.

CCAvenue Source Request object

The CCAvenue Source Request object requires the following fields.

FieldValue

type

ccavenue

sessionId

The payment session identifier.

owner

ccavenue

CCAvenue Source Details object

The CCAvenue Source Details object requires the following fields.

{
    "returnUrl": "https://example.com/return",
    "cancelUrl": "https://example.com/cancel"
}

The CCAvenue Source Details object requires the following field.

FieldRequired/OptionalDescription

returnUrl

Required

Where you will redirect your customer after the customer authorizes within the CCAvenue experience.

cancelUrl

Required

Where you will redirect your customer after the customer cancels within the CCAvenue experience.

Step 2: Create a CCAvenue source using DigitalRiver.js

Use the DigitalRiver.js library to create and mount elements to the HTML container.

Note the following requirements when configuring CCAvenue:

  • The address object must contain postal code and state/province data that adhere to a standardized format.

  • CCAvenue's risk policy requires the shopper's phone number (a ten-digit numeric value) in the address object, which cannot be empty. However, Digital River does not validate the phone number.

let ccavenueSourceData = {
    "type": "ccavenue",
    "sessionId": "3c9473b0-630d-4f20-af61-63d3aa8acb35",
    "owner": {
        "firstName": "John",
        "lastName": "Doe",
        "email": "john.doe@digitalriver.com",
        "phoneNumber": "1306372509",
        "address":{
            "line1":"34th Floor, Promod Industrial Estate, Western X-highway, B/h Kohinoor Ind Est, Goregaon (e)",
            "line2":"",
            "city":"Mumbai",
            "state":"Maharashtra",
            "postalCode":"400063",
            "country":"IN"
        }
    },
    "ccavenue": {
        "returnUrl": "https://example.com/return",
        "cancelUrl": "https://example.com/cancel"
    }
}
 
digitalriver.createSource(ccavenueSourceData).then(function(result) {
    if (result.error) {
        //handle errors as something went wrong
    } else {
        var source = result.source;
     
        //do something with the created source
    }
});

CCAvenue source example

{
    "clientId": "gc",
    "channelId": "drdod15",
    "liveMode": false,
    "id": "5ce08114-143b-4bf6-ae0e-6fc501ee0c24",
    "clientSecret": "5ce08114-143b-4bf6-ae0e-6fc501ee0c24_a468b08e-2c47-4531-82af-d48d80ff6dcc",
    "type": "ccavenue",
    "reusable": false,
    "owner": {
        "firstName": "John",
        "lastName": "Doe",
        "email": "john.doe@digitalriver.com",
        "phoneNumber": "13063725095",
        "address":{
            "line1":"34th Floor, Promod Industrial Estate, Western X-highway, B/h Kohinoor Ind Est, Goregaon (e)",
            "line2":"",
            "city":"Mumbai",
            "state":"Maharashtra",
            "postalCode":"400063",
            "country":"IN"
        }
    },
    "amount": "10.00",
    "currency": "INR",
    "state": "pending_redirect",
    "creationIp": "10.81.3.92",
    "createdTime": "2020-02-26T02:48:11.508Z",
    "updatedTime": "2020-02-26T02:48:11.508Z",
    "flow": "redirect",
    "redirect": {
        "redirectUrl": "https://api.digitalriverws.com:443/payments/redirects/51314834-9bf9-483f-b3a7-4b36a14d3f5c?apiKey=pk_hc_e03ee62c0d964bb3ac75595b1203d13c",
        "returnUrl": "https://example.com/return",
        "cancelUrl": "https://example.com/cancel"
    },
    "ccavenue": {}
}

Payment options

CCAvenue offers multiple payment options. The bankCode identifies the payment options and determines the value of the subType field.

The bankCode value will be used as the subType value unless the bankCode is "Credit Card", then the bankName will be used as the subType.

Credit Card
"ccavenue": {

    "bankReferenceNumber": "1634229024157",
    "accountToken": "71826934100000000000000575766005",
    "trackingId": "310007639563",
    "subType": "Visa",
    "bankName": "Visa",
    "bankCode": "Credit Card",
    "orderStatus": "Success"
}
Net Banking
"ccavenue": {
    "bankReferenceNumber": "1634229110338",
    "accountToken": "71826934100000000000000575766005",
    "trackingId": "310007639565",
    "subType": "Net Banking",
    "bankName": "AvenuesTest",
    "bankCode": "Net Banking",
    "orderStatus": "Success"
}
Wallet
"ccavenue": {
    "bankReferenceNumber": "1634229189578",
    "accountToken": "71826934100000000000000575766005",
    "trackingId": "310007639569",
    "subType": "Wallet",
    "bankName": "AvenuesTest",
    "bankCode": "Wallet",
    "orderStatus": "Success"
UPI
"ccavenue": {
    "bankReferenceNumber": "377494",
    "accountToken": "71826934100000000000000575766005",
    "trackingId": "310007639571",
    "subType": "Unified Payments",
    "bankName": "UPI",
    "bankCode": "Unified Payments",
    "orderStatus": "Success"
}
FieldOptional/RequiredDescription

bankReferenceNumber

Required

The bank reference nubmer for the shopper's account.

accountToken

Required

The shopper's account token.

trackingId

Required

The tracking identifier for the order.

Step 3: Authorize the CCAvenue source

When you create a CCAvenue source, the customer must authorize the charge through their payment provider. You can accomplish this by redirecting the customer to their payment provider.

Redirecting the customer for CCAvenue authorization

Use the redirectUrl parameter in your createSource response to redirect your customer to the payment provider for authorization.

window.location.href = sourceResponse.redirect.redirectUrl;

The payment provider will present the customer with the transaction details, and the customer can authorize or cancel the transaction. A successful authorization redirects the customer to the CCAvenue Return URL parameter specified when you created the source.

Once authorized, the source state will change to chargeable.

Step 4: Use the authorized source

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

Option 1: Attach the source to a checkout

POST /checkouts/{id}
{
  "customerId": "5774321008",
  "sourceId": "src_5ce08114-143b-4bf6-ae0e-6fc501ee0c24"
}

Option 2: Attach the source to a customer

POST /customers/{id}/sources/{sourcesId}
{
  "id": "5774321008",
  "sourceId": "src_5ce08114-143b-4bf6-ae0e-6fc501ee0c24"
}

Testing CCAvenue

See Testing the CCAvenue payment method for testing instructions.

Last updated