What Are The Decimal Precision And Rounding Limits In Recurly Pricing And Calculations?

Recurly's Decimal Precision Standard

Recurly adheres to the standard two decimal places for currency representations in billing, invoicing, and financial reports. This practice aligns with global banking, credit card network, and financial reporting standards.

Key Limitation in Recurly Commerce

Recurly does not natively support rounding to more than two decimal places for final transaction amounts.

• This limitation exists because higher precision rounding for transaction totals can lead to discrepancies during final payment gateway processing and bank settlement.

• For example, charging a customer $10.003 is not possible, as the gateway will typically only accept $10.00.

Handling High Precision Pricing Models

If your specific pricing model within Recurly Subscriptions requires a higher precision for unit prices (e.g., $0.0012 per unit), the following guidance applies:

• Unit Price: The unit price can be stored with a higher level of precision.

• Final Amount: When calculating the total amount due (unit price $\times$ quantity), the final amount presented to the payment gateway will be rounded to two decimal places.

• Workaround: If business or tax regulations require a different level of precision, you must consult your billing and tax regulations to determine acceptable workarounds that maintain financial accuracy outside of the standard two-decimal-place rounding.