---
title: MoneyV2 - Customer API
description: >-
  A precise monetary value and its associated currency. Combines a decimal
  amount with a three-letter currency code to express prices, costs, and other
  financial values throughout the API. For example, 12.99 USD.
api_version: 2026-01
api_name: customer
type: object
api_type: graphql
source_url:
  html: 'https://shopify.dev/docs/api/customer/latest/objects/MoneyV2'
  md: 'https://shopify.dev/docs/api/customer/latest/objects/MoneyV2.md'
---

# Money​V2

object

A precise monetary value and its associated currency. Combines a decimal amount with a three-letter currency code to express prices, costs, and other financial values throughout the API. For example, 12.99 USD.

## Fields

* amount

  [Decimal!](https://shopify.dev/docs/api/customer/latest/scalars/Decimal)

  non-null[Pre-auth accessible](https://shopify.dev/docs/apps/build/customer-accounts/order-status-page#customer-account-api)

  A monetary value in decimal format, allowing for precise representation of cents or fractional currency. For example, 12.99.

* currency​Code

  [Currency​Code!](https://shopify.dev/docs/api/customer/latest/enums/CurrencyCode)

  non-null[Pre-auth accessible](https://shopify.dev/docs/apps/build/customer-accounts/order-status-page#customer-account-api)

  The three-letter currency code that represents a world currency used in a store. Currency codes include standard [standard ISO 4217 codes](https://en.wikipedia.org/wiki/ISO_4217), legacy codes, and non-standard codes. For example, USD.

***

## Map

### Fields with this object

* [AdditionalFeeSale.totalAmount](https://shopify.dev/docs/api/customer/latest/objects/AdditionalFeeSale#field-AdditionalFeeSale.fields.totalAmount)
* [AdditionalFeeSale.totalDiscountAmountAfterTaxes](https://shopify.dev/docs/api/customer/latest/objects/AdditionalFeeSale#field-AdditionalFeeSale.fields.totalDiscountAmountAfterTaxes)
* [AdditionalFeeSale.totalDiscountAmountBeforeTaxes](https://shopify.dev/docs/api/customer/latest/objects/AdditionalFeeSale#field-AdditionalFeeSale.fields.totalDiscountAmountBeforeTaxes)
* [AdditionalFeeSale.totalTaxAmount](https://shopify.dev/docs/api/customer/latest/objects/AdditionalFeeSale#field-AdditionalFeeSale.fields.totalTaxAmount)
* [AdjustmentSale.totalAmount](https://shopify.dev/docs/api/customer/latest/objects/AdjustmentSale#field-AdjustmentSale.fields.totalAmount)
* [AdjustmentSale.totalDiscountAmountAfterTaxes](https://shopify.dev/docs/api/customer/latest/objects/AdjustmentSale#field-AdjustmentSale.fields.totalDiscountAmountAfterTaxes)
* [AdjustmentSale.totalDiscountAmountBeforeTaxes](https://shopify.dev/docs/api/customer/latest/objects/AdjustmentSale#field-AdjustmentSale.fields.totalDiscountAmountBeforeTaxes)
* [AdjustmentSale.totalTaxAmount](https://shopify.dev/docs/api/customer/latest/objects/AdjustmentSale#field-AdjustmentSale.fields.totalTaxAmount)
* [AppliedGiftCard.amountUsed](https://shopify.dev/docs/api/customer/latest/objects/AppliedGiftCard#field-AppliedGiftCard.fields.amountUsed)
* [AppliedGiftCard.balance](https://shopify.dev/docs/api/customer/latest/objects/AppliedGiftCard#field-AppliedGiftCard.fields.balance)
* [AppliedGiftCard.presentmentAmountUsed](https://shopify.dev/docs/api/customer/latest/objects/AppliedGiftCard#field-AppliedGiftCard.fields.presentmentAmountUsed)
* [Checkout.lineItemsSubtotalPrice](https://shopify.dev/docs/api/customer/latest/objects/Checkout#field-Checkout.fields.lineItemsSubtotalPrice)
* [Checkout.paymentDue](https://shopify.dev/docs/api/customer/latest/objects/Checkout#field-Checkout.fields.paymentDue)
* [Checkout.subtotalPrice](https://shopify.dev/docs/api/customer/latest/objects/Checkout#field-Checkout.fields.subtotalPrice)
* [Checkout.totalDuties](https://shopify.dev/docs/api/customer/latest/objects/Checkout#field-Checkout.fields.totalDuties)
* [Checkout.totalPrice](https://shopify.dev/docs/api/customer/latest/objects/Checkout#field-Checkout.fields.totalPrice)
* [Checkout.totalTax](https://shopify.dev/docs/api/customer/latest/objects/Checkout#field-Checkout.fields.totalTax)
* [CheckoutLineItem.price](https://shopify.dev/docs/api/customer/latest/objects/CheckoutLineItem#field-CheckoutLineItem.fields.price)
* [CheckoutLineItem.unitPrice](https://shopify.dev/docs/api/customer/latest/objects/CheckoutLineItem#field-CheckoutLineItem.fields.unitPrice)
* [DiscountAllocation.allocatedAmount](https://shopify.dev/docs/api/customer/latest/objects/DiscountAllocation#field-DiscountAllocation.fields.allocatedAmount)
* [DraftOrder.subtotalPrice](https://shopify.dev/docs/api/customer/latest/objects/DraftOrder#field-DraftOrder.fields.subtotalPrice)
* [DraftOrder.totalLineItemsPrice](https://shopify.dev/docs/api/customer/latest/objects/DraftOrder#field-DraftOrder.fields.totalLineItemsPrice)
* [DraftOrder.totalPrice](https://shopify.dev/docs/api/customer/latest/objects/DraftOrder#field-DraftOrder.fields.totalPrice)
* [DraftOrder.totalShippingPrice](https://shopify.dev/docs/api/customer/latest/objects/DraftOrder#field-DraftOrder.fields.totalShippingPrice)
* [DraftOrder.totalTax](https://shopify.dev/docs/api/customer/latest/objects/DraftOrder#field-DraftOrder.fields.totalTax)
* [DraftOrderAppliedDiscount.discountValue](https://shopify.dev/docs/api/customer/latest/objects/DraftOrderAppliedDiscount#field-DraftOrderAppliedDiscount.fields.discountValue)
* [DraftOrderDiscountInformation.totalDiscounts](https://shopify.dev/docs/api/customer/latest/objects/DraftOrderDiscountInformation#field-DraftOrderDiscountInformation.fields.totalDiscounts)
* [DraftOrderLineItem.discountedTotal](https://shopify.dev/docs/api/customer/latest/objects/DraftOrderLineItem#field-DraftOrderLineItem.fields.discountedTotal)
* [DraftOrderLineItem.discountedUnitPrice](https://shopify.dev/docs/api/customer/latest/objects/DraftOrderLineItem#field-DraftOrderLineItem.fields.discountedUnitPrice)
* [DraftOrderLineItem.originalTotal](https://shopify.dev/docs/api/customer/latest/objects/DraftOrderLineItem#field-DraftOrderLineItem.fields.originalTotal)

### Possible type in

* [Pricing​Value](https://shopify.dev/docs/api/customer/latest/unions/PricingValue)