LogoLogo
System Status
  • Commerce API
    • Test and use cases
    • Roles and permissions
    • Sending API calls
  • Shopper APIs
    • Shopper basics
      • Common use cases
        • Creating a customer
        • Applying store credit
        • Private store workflow
        • Guest checkout
    • OAuth
      • Authentication
      • OAuth 2.0 APIs
      • Token
      • Access tokens
      • Session-aware access tokens
      • Authorizing a shopper
    • Shoppers
      • Managing shoppers
        • User management
        • Single sign-on (SSO)
        • Data validation
        • Bulk user management
        • Bulk user account export
      • Managing a shopper's account
      • Managing a shopper's address
      • Managing payment options
    • Product discovery
      • Categories
      • Products
      • Product variations
      • Pricing
      • Inventory status
      • Financing
      • Offers
        • Understanding offers
        • How to use point of promotions (POPs)
          • Retrieving all point of promotion offers for a specific product
          • Retrieving all offers for a specific point of promotion
        • How to use offers
      • Private stores
        • Managing private stores
        • Submitting an order for a private store
        • Useful APIs
      • Fulfillment
        • Electronic Fulfillment Service (OFI)
        • Digital rights
        • Digital rights revocation
        • Physical fulfillment
          • EDI X12 832 definition data elements
          • EDI X12 846 definition data elements
          • EDI X12 850 definition data elements
          • EDI X12 855 definition data elements
          • EDI X12 856 definition data elements
          • EDI X12 180-1 definition data elements
          • EDI X12 180-2 definition of data elements
          • EDI X12 180-3 definition of data elements
    • Cart
      • Applying a shopper to a cart
      • Getting the current cart
      • Creating or updating a cart
        • Adding a product to a cart
          • Gifting
        • Capturing the customer's IP address
        • Providing address information
        • Managing the shipping or billing address
        • Providing subscription information
        • Managing payment methods
        • Capturing the Terms of Sale (TOS) acceptance
      • Managing offers in a cart
        • Applying an offer
        • Applying a coupon or promo code
        • Getting all applied offers
        • Removing an applied offer
        • Removing eligible offers
        • Reconciling conflicting offers
        • Dynamic offers/personalization
          • Skipping Global Commerce merchandising offer arbitration
          • Triggering a promotional URL offer
          • Overriding a promotional URL offer discount
      • Pricing
        • Landed cost
          • Mixed cart support
          • Tax-included pretty price
      • Redirecting to a Digital River-hosted cart
      • Configuring taxes
        • Managing tax identifiers
      • Managing shipping options
        • Getting shipping options
        • Providing a shipping discount
      • Managing line items
      • Applying a price override
      • Managing payment sessions
      • Managing web checkout
      • Submitting a cart
        • Initiating a charge
        • Authorization declines
      • Resuming cart submission
      • HGOP2
    • Orders
      • Getting orders
      • Selling entities
      • Retrieving addresses from an order
      • Retrieving line items from an order
      • Order lookup
      • Returns
        • Initiate an authenticated session
        • Setting up returns in Global Commerce
        • Managing returns
    • Subscriptions
      • Retrieve the subscription
        • Getting all orders for a subscription
        • Getting a subscription's pending actions
        • Getting all subscriptions for a shopper
        • Getting a subscription by identifier
      • Update subscription at the next renewal
        • Changing the subscription renewal type
        • Changing the subscription renewal quantity
        • Adding or updating a perpetual unit price
        • Changing the subscription's payment option
        • Changing the subscription's payment source
      • Immediately change the subscription
        • Updating the subscription's shipping address
        • Updating a subscription's billing and shipping email address
        • Cancelling a subscription
      • Immediately apply a midterm subscription change
        • Reducing the subscription renewal quantity
  • Admin APIs
    • Admin basics
      • Available Admin API calls
    • Order management
      • Getting the order's details
      • Downloading the invoice
    • Offer management
    • Refund management
      • Authorization
      • Refund reason codes
      • Creating a satisfaction refund
      • Getting the available refunds for a specific order
      • Getting refunds for a specific order
      • Getting refunds available for a shopper's order
      • Getting the JSON schema for an order refund
      • Managing a refund for a delayed payment method
      • Refund error scenarios
    • Subscription management
      • Retrieve the subscription
        • Getting all orders for a subscription
        • Getting a subscription's pending actions
        • Getting all subscriptions for a shopper
        • Getting a subscription by identifier
      • Update the subscription at the next renewal
        • Changing the subscription renewal type
        • Changing the subscription renewal product
        • Changing the subscription renewal price
        • Changing the subscription renewal quantity
        • Adding or updating a perpetual unit price
        • Changing the subscription's payment option
        • Changing the subscription's payment source
      • Immediately change the subscription
        • Activating a subscription
        • Changing the subscription's external reference identifier
        • Updating a subscription's billing and shipping email address
        • Cancelling a subscription
        • Updating the subscription's expiration date
      • Immediately apply a midterm subscription change
        • Applying a midterm change with price override
        • Reducing the subscription renewal quantity
      • Subscription notifications
        • Updating the subscriber's email address
        • Card Account Updater
        • Sending a payment information change notification
        • Sending an expired credit card notification
        • Sending an invalid payment account notification
        • Sending a payment failure notification
        • Sending a subscription renewal reminder notification
        • Setting up subscription renewal reminders
        • Setting up trial subscription renewal reminders
        • Setting up marketing reminders
      • Using the Expired Card Optimizer
    • Customer management
      • Retrieving customer details
      • Requesting PII removal for a customer
    • Site management
      • Configuring authorized shipping and billing countries
      • Getting a site's authorized billing countries
      • Getting a site's authorized shipping countries
    • Product management
      • Getting started
      • Manage products (asynchronous API)
        • Creating or updating a product
        • Adding or updating a product variation
        • Deploying a product
        • Applying live changes
        • Retiring a product
        • Deleting a product variation
        • Deleting a base or individual product's locale
      • Retrieve products (synchronous API)
        • Getting a product by locale
        • Getting a product variation
        • Getting a product variation by locale
      • Get the task status for a product (synchronous API)
        • Getting the latest information on a product task
        • Retrieving the tasks for a specific product
        • Retrieving the tasks for products
      • Bulk operation
        • Asynchronous bulk operations
          • Creating products in bulk
          • Updating products in bulk
          • Deploying products in bulk
          • Deleting product variations in bulk
        • Bulk product upload (BPU)
        • Bulk Product Export (BPE)
          • Line-item level satisfaction refund
          • Order-level satisfaction refund
          • Auto-created line-item level return product
          • Line-item level return product
    • File management
      • Downloading a file
  • Payments
    • Payments solutions
      • Drop-in payments
        • How Drop-in payments work
        • Drop-in payments integration guide
      • DigitalRiver.js with Elements
        • Elements integration guide
        • Configuring payment methods
          • Configuring Afterpay
          • Configuring Alipay+ (cross-border)
          • Configuring Alipay (domestic)
          • Configuring Amazon Pay
          • Configuring Apple Pay
          • Configuring Bancontact
          • Configuring BLIK
          • Configuring Boleto
          • Configuring CCAvenue
          • Configuring Clearpay
          • Configuring Credit Cards
          • Configuring FPX Online Banking
          • Configuring Google Pay
          • Configuring iDEAL
          • Configuring Klarna
          • Configuring Konbini
          • Configuring Online Banking (IBP)
          • Configuring Online Banking (Korea Bank Transfer)
          • Configuring PayCo
          • Configuring PayPal
          • Configuring SEPA Direct Debit
          • Configuring Trustly
          • Configuring Wire Transfer
          • Common payment sources
          • Common payment objects
    • Supported payment methods
      • Afterpay
      • Alipay (domestic)
      • Alipay+ (cross-border)
      • Amazon Pay
      • Apple Pay
      • Bancontact
      • BLIK
      • Boleto
      • CCAvenue
      • Clearpay
      • Credit Cards
      • FPX Online Banking
      • Google Pay
      • iDEAL
      • Klarna
      • Konbini
      • Korea Bank Transfer (Online Banking)
      • Online Banking (IBP)
      • PayCo
      • PayPal
      • PayPal Billing Agreement
      • PayPal Credit
      • PayPal Pay in 3
      • PayPal Pay in 4
      • PayPal RatenZahlung (Installment Payment)
      • SEPA Direct Debit
      • Trustly
      • Wire Transfer
    • Source basics
      • Managing sources
      • Handling credit card sources
      • Retrieving sources
    • Building payment workflows
      • Flows by payment type
      • Handling redirect payment methods
    • PSD2 and SCA
    • Payment testing scenarios
      • Testing standard payment methods
      • Testing redirect payment methods
      • Testing receiver payment methods
      • Testing the CCAvenue payment method
  • Events
    • Events overview
    • Responding to events
    • Event types
      • Delayed payment event types
        • Delayed payment expired event
          • Boleto
          • Konbini
          • Wire Transfer
        • Delayed payment reminder event
          • Boleto
          • Konbini
          • Wire Transfer
      • Subscription event types
        • Subscription created event
        • Subscription updated event
        • Subscription action processed event
        • Subscription cancelled event
        • Subscription credit card expired event
        • Subscription payment information changed event
        • Subscription renewal reminder event
        • Subscription renewed event
        • Subscription trial converted event
        • Subscription trial renewal reminder event
        • Subscription payment failed event
      • Post-order event types
        • Invoice created event
        • Refund credit memo event
      • Inventory event types
        • Inventory out of stock event
        • Inventory source and management
        • Inventory self-managed updated event
        • Inventory fulfiller-managed updated event
      • Post-order Notification Integration Guide
    • Webhooks
      • Commerce API safelist
      • Searching for a webhook
      • Creating a webhook
      • Using webhooks
      • Editing a webhook
      • Turning webhooks on or off
      • Revealing a webhook's secret
      • Rotating a webhook's secret
      • Viewing the webhook details
      • Deleting a webhook
  • Developer Resources
    • Postman collection
    • Commerce API references
    • Shopper APIs reference
    • Admin APIs reference
    • DigitalRiver.js reference
      • Including DigitalRiver.js
      • Initializing DigitalRiver.js
      • DigitalRiver object
      • Elements
        • Amazon Pay element
        • Apple Pay elements
        • Google Pay elements
        • IBAN element
        • iDEAL element
        • Konbini elements
        • Compliance element
        • Offline refund element
        • Online Banking elements
        • Tax Identifier element
        • Delayed payment instructions element
        • PayPal elements
      • Guidelines for capturing payment details
      • Security
      • Digital River payment objects
      • Error types, codes, and objects
  • General resources
    • Global Commerce
    • Global Commerce
      • Company hierarchy
      • Categories
        • Getting a list of categories
      • Products
        • Product scenarios
        • Individual products
          • Creating an individual product
        • Base product with variants
          • Creating a base product with variants
        • Bundle offers
          • Creating a prorated bundle offer with a subscription
        • Product combination
          • Creating a product combination
        • Gifting
        • Inventory status
      • Customer service
        • Log a shopper's request to remove PII
      • Customers
        • Creating a customer
        • Digital River-maintained customer login
        • Client-maintained customer login
      • Transparent Commerce purchase flow
    • eCompass
    • eCompass documentation
    • Release notes
      • 2024
      • 2024 latest
      • 2023
      • 2022
      • 2021
      • 2020
Powered by GitBook
On this page

Was this helpful?

  1. Shopper APIs
  2. Cart

Resuming cart submission

Learn how to resume cart submission after completing a redirect payment method.

PreviousAuthorization declinesNextHGOP2

Last updated 4 months ago

Was this helpful?

When customers select a when they submit the cart, they are redirected to the payment provider, where they can authorize the payment. Once the payment is authorized, you can .

curl --location -g --request POST ' https://api.digitalriver.com/v1/shoppers/me/carts/active/resume-cart' \
--header 'Authorization: Basic {{access_token}}' \
...
{
    "resumeCart": {
        "order": {
            "uri": "https://api.digitalriver.com/v1/shoppers/me/orders/1077950780082",
            "id": 1077950780082,
            "submissionDate": "2023-03-28T10:38:55.082Z",
            "displayName": "New Order",
            "locale": "en_US",
            "optIn": "false",
            "testOrder": "false",
            "taxExempt": "false",
            "businessEntityCode": "DR_INC-ENTITY",
            "orderState": "Submitted",
            "orderStateDetails": {
                "description": null,
                "settled": {
                    "currency": "USD",
                    "value": 0
                },
                "refunded": {
                    "currency": "USD",
                    "value": 0
                }
            },
            "customAttributes": {
                "attribute": [
                    {
                        "name": "orderSubmittedByShopperApiFlag",
                        "type": "string",
                        "value": "shopperApiV1Submitted"
                    },
                    {
                        "name": "DPL_SERVICE_PROVIDER",
                        "type": "string",
                        "value": "ComplianceService"
                    },
                    {
                        "name": "isLandedCostPrettyPrice",
                        "type": "string",
                        "value": "false"
                    },
                    {
                        "name": "feeJurisdiction",
                        "type": "string",
                        "value": "US.MN"
                    },
                    {
                        "name": "DPL_SCREENING_URL",
                        "type": "string",
                        "value": "http://compliance-sys.digitalriverws.net/compliance/resource/screening/VDC3-55916946"
                    },
                    {
                        "name": "orderGeneratedByFlag",
                        "type": "string",
                        "value": "systemGenerated"
                    },
                    {
                        "name": "DPLResult",
                        "type": "string",
                        "value": "Accept"
                    },
                    {
                        "name": "PURCHASEPLAN_INCENTIVE_TOTAL",
                        "type": "string",
                        "value": "0"
                    },
                    {
                        "name": "orderGeneratedByShopperApiFlag",
                        "type": "string",
                        "value": "shopperApiV1Generated"
                    },
                    {
                        "name": "feeShippingJurisdiction",
                        "type": "string",
                        "value": "US.MN"
                    }
                ]
            }
        },
        "lineItems": {
            "lineItem": [
                {
                    "id": 50587290082,
                    "quantity": 1,
                    "product": {
                        "uri": "https://api.digitalriver.com/v1/shoppers/me/products/5303832100",
                        "id": 5303832100,
                        "name": "Physical Product - 2",
                        "displayName": "Physical Product - 2",
                        "shortDescription": "Short Description:",
                        "longDescription": "Long Description:",
                        "productType": "PHYSICAL",
                        "sku": "Physical Product - 2",
                        "externalReferenceId": "234",
                        "companyId": "shopx1",
                        "displayableProduct": "true",
                        "purchasable": "true",
                        "manufacturerName": "345",
                        "manufacturerPartNumber": "456",
                        "thumbnailImage": "https://drhods-sysaws.drextenv.net/DRHM/Storefront/Company/shopx1/images/product/thumbnail/lake.png",
                        "productImage": "https://drhods-sysaws.drextenv.net/DRHM/Storefront/Company/shopx1/images/product/detail/lake.png",
                        "keywords": "Keywords:",
                        "customAttributes": {
                            "attribute": [
                                {
                                    "name": "clonedFromStaging",
                                    "type": "Boolean",
                                    "value": "false"
                                },
                                {
                                    "name": "landedCost",
                                    "type": "Boolean",
                                    "value": "false"
                                },
                                {
                                    "name": "nonSolr",
                                    "type": "Boolean",
                                    "value": "false"
                                },
                                {
                                    "name": "needsRestrictedShippingOption",
                                    "type": "Boolean",
                                    "value": "false"
                                },
                                {
                                    "name": "originalIsOrderable",
                                    "type": "Boolean",
                                    "value": "true"
                                },
                                {
                                    "name": "length",
                                    "type": "Quantity",
                                    "value": "10.000 in"
                                },
                                {
                                    "name": "upc",
                                    "type": "String",
                                    "value": "34"
                                },
                                {
                                    "name": "weight",
                                    "type": "Quantity",
                                    "value": "10.000 lb"
                                },
                                {
                                    "name": "unit",
                                    "type": "String",
                                    "value": "666"
                                },
                                {
                                    "name": "shippingID",
                                    "type": "String",
                                    "value": "345"
                                },
                                {
                                    "name": "width",
                                    "type": "Quantity",
                                    "value": "10.000 in"
                                },
                                {
                                    "name": "privateStoreOnly",
                                    "type": "Boolean",
                                    "value": "false"
                                },
                                {
                                    "name": "originalIsViewable",
                                    "type": "Boolean",
                                    "value": "true"
                                }
                            ]
                        }
                    },
                    "lineItemState": "Submitted",
                    "lineItemStateDetails": {
                        "description": null,
                        "backOrdered": 0,
                        "shipped": 0,
                        "returned": 0,
                        "pendingReturn": 0
                    },
                    "pricing": {
                        "listPrice": {
                            "currency": "USD",
                            "value": 100
                        },
                        "listPriceWithQuantity": {
                            "currency": "USD",
                            "value": 100
                        },
                        "salePrice": {
                            "currency": "USD",
                            "value": 100
                        },
                        "salePriceWithQuantity": {
                            "currency": "USD",
                            "value": 100
                        },
                        "formattedListPrice": "100.00USD",
                        "formattedListPriceWithQuantity": "100.00USD",
                        "formattedSalePrice": "100.00USD",
                        "formattedSalePriceWithQuantity": "100.00USD",
                        "totalDiscountWithQuantity": {
                            "currency": "USD",
                            "value": 0
                        },
                        "formattedTotalDiscountWithQuantity": "0.00USD",
                        "productTax": {
                            "currency": "USD",
                            "value": 7.38
                        },
                        "shippingTax": {
                            "currency": "USD",
                            "value": 0.73
                        },
                        "feeTax": {
                            "currency": "USD",
                            "value": 0
                        },
                        "taxRate": 0.07375,
                        "discountDescription": "empty",
                        "importTax": {
                            "currency": "USD",
                            "value": 0
                        },
                        "formattedImportTax": "0.00USD",
                        "importDuty": {
                            "currency": "USD",
                            "value": 0
                        },
                        "formattedImportDuty": "0.00USD"
                    },
                    "downloads": {},
                    "digitalRights": {},
                    "customAttributes": {
                        "attribute": [
                            {
                                "name": "isTaxExempt",
                                "type": "string",
                                "value": "false"
                            }
                        ]
                    }
                }
            ]
        },
        "billingAddress": {
            "id": "billingAddress",
            "firstName": "firstName",
            "lastName": "lastName",
            "companyName": null,
            "line1": "line1",
            "line2": "line2",
            "line3": null,
            "city": "Minnetonka",
            "countrySubdivision": "MN",
            "postalCode": "55410",
            "country": "US",
            "countryName": "United States",
            "phoneNumber": "9522253720",
            "countyName": null,
            "emailAddress": "hold1@fraud.com",
            "phoneticFirstName": null,
            "phoneticLastName": null,
            "division": null,
            "title": null
        },
        "shippingAddress": {
            "id": "shippingAddress",
            "firstName": "darren",
            "lastName": "tang",
            "companyName": "DR",
            "line1": "10381 Bren Road West",
            "line2": "4321",
            "line3": "Suite Line 3",
            "city": "Waconia",
            "countrySubdivision": "MN",
            "postalCode": "05387",
            "country": "US",
            "countryName": "United States",
            "phoneNumber": "952-253-1234",
            "countyName": null,
            "emailAddress": "hold1@fraud.com",
            "phoneticFirstName": null,
            "phoneticLastName": null,
            "division": null
        },
        "shippingMethod": {
            "code": 265200,
            "description": "Standard"
        },
        "taxInclusive": "false",
        "landedCostState": "NOT_ELIGIBLE",
        "pricing": {
            "subtotal": {
                "currency": "USD",
                "value": 100
            },
            "subtotalWithDiscount": {
                "currency": "USD",
                "value": 100
            },
            "discount": {
                "currency": "USD",
                "value": 0
            },
            "shippingAndHandling": {
                "currency": "USD",
                "value": 9.9
            },
            "importTaxAndDuty": {
                "currency": "USD",
                "value": 0
            },
            "tax": {
                "currency": "USD",
                "value": 8.11
            },
            "orderTotal": {
                "currency": "USD",
                "value": 118.01
            },
            "formattedSubtotal": "100.00USD",
            "formattedSubtotalWithDiscount": "100.00USD",
            "formattedDiscount": "0.00USD",
            "formattedShippingAndHandling": "9.90USD",
            "formattedImportTaxAndDuty": "0.00USD",
            "formattedTax": "8.11USD",
            "formattedOrderTotal": "118.01USD"
        },
        "paymentMethod": {
            "type": "klarnaCredit",
            "sourceId": "33ead2d9-55ef-4ee8-a532-961fb70effb0",
            "sourceClientSecret": "33ead2d9-55ef-4ee8-a532-961fb70effb0_695c8a26-2431-4552-80a3-c5c07f00525e",
            "klarnaCredit": {
                "shipping": "{recipient=darren tang, phoneNumber=952-253-1234, address={line1=10381 Bren Road West, line2=4321, city=Waconia, state=MN, country=US, postalCode=05387}, email=ttang@digitalriver.com}",
                "clientSecret": "33ead2d9-55ef-4ee8-a532-961fb70effb0_695c8a26-2431-4552-80a3-c5c07f00525e",
                "flow": "redirect",
                "token": "17570312550000000000000575239905",
                "paymentType": "2023-03-30T09:44:01.295Z",
                "reusable": "false"
            },
            "amountContributed": {
                "currency": "USD",
                "value": 68.01
            },
            "supplementaryPaymentMethods": [
                {
                    "type": "customerCredit",
                    "sourceId": "202bb87b-e393-4ef4-a4d0-6fad5970ebd0",
                    "sourceClientSecret": "202bb87b-e393-4ef4-a4d0-6fad5970ebd0_0a5d5f4f-1bd2-4fcf-b96f-b7127ebbe35f",
                    "customerCredit": {
                        "clientSecret": "202bb87b-e393-4ef4-a4d0-6fad5970ebd0_0a5d5f4f-1bd2-4fcf-b96f-b7127ebbe35f",
                        "flow": "standard",
                        "reusable": "false"
                    },
                    "amountContributed": {
                        "currency": "USD",
                        "value": 50
                    }
                }
            ]
        },
        "paymentCompletionResources": {},
        "termsOfSalesAcceptance": null,
        "paymentSession": {
            "id": "6a92bfac-072b-4e2c-8066-9bd2e4ab4fa0",
            "clientSecret": "6a92bfac-072b-4e2c-8066-9bd2e4ab4fa0_21ed1510-c504-47ae-a345-f7d5d17a1944",
            "status": "complete"
        }
    }
}
redirect payment method
resume submitting the cart