Manage

Frequently asked questions

Find answers to frequently asked questions about UPS® Global Checkout.

Where can I get support for UPS® Global Checkout?

API or technology troubleshooting requests should go to globalcheckoutsupport@ups.com. All billing and product related questions go to globalcheckout@ups.com.

What are the hours of operation for UPS® Global Checkout support?

UPS® Global Checkout support is available Monday through Friday from 9AM to 5PM MST. Inquiries will be addressed with in 1-2 business days.

Are phone calls or virtual meetings available for support?

Yes, both options are available during operating hours, depending on representative availability.

What details expedite my support inquiry?

Please include the following in your request:

  • Request and response details: Provide payloads, headers, and error messages.
  • Timestamps: Note the date and time of the issue.
  • Environment: Specify if the issue occurred in production or testing.
  • Steps to reproduce: Detail the actions to replicate the issue.

Who can use the UPS® Global Checkout API?

This API is ideal for international commerce businesses that require precise landed cost calculations. Only authorized shippers can use this API.

What kind of API does UPS® Global Checkout use?

UPS® Global Checkout uses a GraphQL API, offering flexibility and efficiency. If you're new to GraphQL, see here for more details.

How do I get access to the UPS® Global Checkout API?

Generate a new API credential token specifically for the UPS® Global Checkout API. Existing credentials can be used as long as those credentials are authorized for UPS® Global Checkout.

Where can I find API documentation?

Visit the calculate a landed cost page for information about the API and examples. Or visit our developer API portal for detailed documentation.

What errors can be returned by the API?

path[0]messageextensions.errorType
partyCreateWorkflowLocation or person is requiredBAD_REQUEST
itemCreateWorkflowYou do not have a default country of origin setNOT_FOUND
itemCreateWorkflowYou do not have a default hsCode setNOT_FOUND
cartonsCreateWorkflowDimension must be a positive numberBAD_REQUEST
cartonsCreateWorkflowNo parties found with type PartyTypeFAILED_PRECONDITION
cartonsCreateWorkflowPartyType party location not foundFAILED_PRECONDITION
shipmentRatingCreateWorkflowThere are no cartons associated with the given rootBAD_REQUEST
shipmentRatingCreateWorkflowParty of type PartyType is missing for shipment ratingsBAD_REQUEST
shipmentRatingCreateWorkflowThe requested service level is not validNOT FOUND
landedCostCalculateWorkflowYou must have a valid state code for Country
landedCostCalculateWorkflowShipping and item totals cannot be less than zero
landedCostCalculateWorkflowShip-to country countryCode is not allowed
landedCostCalculateWorkflowThere are no qualified items to receive a quote

Was this page helpful?