Skip to content

Amount

to_decimal_string 

to_decimal_string(
    amount: Decimal | int | float | str,
) -> str

Return a canonical decimal string (e.g. '19.99').

Suitable for providers like PayPal that accept decimal strings.

Source code in merchants/amount.py 
 8
 9
10
11
12
13
14
15
16
def to_decimal_string(amount: Decimal | int | float | str) -> str:
    """Return a canonical decimal string (e.g. '19.99').

    Suitable for providers like PayPal that accept decimal strings.
    """
    d = Decimal(str(amount))
    # Normalise: strip unnecessary trailing zeros but keep at least 2 dp
    formatted = d.quantize(Decimal("0.01"), rounding=ROUND_HALF_UP)
    return str(formatted)

to_minor_units 

to_minor_units(
    amount: Decimal | int | float | str, decimals: int = 2
) -> int

Convert a decimal amount to the smallest currency unit (e.g. cents).

Suitable for providers like Stripe that require integer minor-units.

to_minor_units("19.99") 1999 to_minor_units("1.005", decimals=2) 101 to_minor_units("100", decimals=0) 100

Source code in merchants/amount.py 
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
def to_minor_units(amount: Decimal | int | float | str, decimals: int = 2) -> int:
    """Convert a decimal amount to the smallest currency unit (e.g. cents).

    Suitable for providers like Stripe that require integer minor-units.

    >>> to_minor_units("19.99")
    1999
    >>> to_minor_units("1.005", decimals=2)
    101
    >>> to_minor_units("100", decimals=0)
    100
    """
    d = Decimal(str(amount))
    factor = Decimal(10) ** decimals
    return int((d * factor).quantize(Decimal("1"), rounding=ROUND_HALF_UP))

from_minor_units 

from_minor_units(minor: int, decimals: int = 2) -> Decimal

Convert minor-unit integer back to a Decimal amount.

from_minor_units(1999) Decimal('19.99')

Source code in merchants/amount.py 
36
37
38
39
40
41
42
43
44
45
46
def from_minor_units(minor: int, decimals: int = 2) -> Decimal:
    """Convert minor-unit integer back to a Decimal amount.

    >>> from_minor_units(1999)
    Decimal('19.99')
    """
    factor = Decimal(10) ** decimals
    return (Decimal(minor) / factor).quantize(
        Decimal("0." + "0" * decimals) if decimals > 0 else Decimal("1"),
        rounding=ROUND_HALF_UP,
    )