getAmountRemainingforCheckout

Learn how to get the remaining amount available for checkout.

Use this global method to get the remaining customer credit amount that the shopper can contribute to the checkout.

Sending a request

This method accepts parameters in JSON string format. You need to pass the cartId with this method.

Parameter
Required/Optional
Description

cartId

Required

The Salesforce ID for the cart object.

Request body example
"{
    "cartId":CartId
}"

Receiving a response

You'll see the following parameters in the response.

Parameter
Description

isSuccess

This global method returns a Boolean value where:

  • true–indicates the call to Digital River to get the remaining amount was successful. This global method will also return the amount remaining to be be contributed and the currency code when successful.

  • false–indicates an error occurred while getting the remaining amount. The system returns an error message when an error occurs, and the Boolean value is false.

amountRemainingToBeContributed

The amount remaining to be contributed to the checkout. A customer credit source can be created for an amount less than or equal to this value.

currencyCode

The currency code of the checkout

errorMessage

If the system returns an error and the value for isSuccess is false, this parameter displays one of the following error messages:

  • Missing or invalid input parameters specified: One of the input parameters are missing or invalid.

  • Unable to retrieve Remaining Amount for checkout: An error message that comes from the Digital River API.

Response body example
{
   "isSuccess":{{Boolean_Value}},
   "amountRemainingToBeContributed":{{Remaining_Amount_To_Be_Contributed}},
   "currencyCode": {{Currency_Code}},
   "errorMessage": {{Error_Message}} // In case of error
}

Calling the global method from a custom component

Import the getAmountRemainingforCheckout method into your custom component javascript file with digialriverv3 as the namespace as shown below.

Import example
import getRemainingAmount from 
"@salesforce/apex/digitalriverv3.DRB2B_CustomerCreditService.getAmountRemainingforCheckout";

Call the global method from a custom JavaScript file by passing the cartId as shown below.

getRemainingAmount(){
        let input = {
            cartId:this.recordId
        };
        getRemainingAmount({inputData:JSON.stringify(input)})
        .then((data)=>{
         // implement logic here in case of success
        })
        .catch((error)=>{
         // implement logic here in case of error
        })
    }

Last updated