Pricing and currency units

Understand how to send amount fields across currencies.

All currency amount fields in the APIs use minor units.

Decimal currencies

For currencies with decimals (e.g. USD, EUR, GBP), send amounts in cents:

  • $45.00 USD -> 4500
  • $120.00 USD -> 12000

Non-decimal currencies

For currencies without decimals (e.g. JPY, CLP), send the amount as-is:

  • 45 JPY -> 45
  • 45 CLP -> 45

Exception for Trips Builder API*

When you create a full trip, we only support full amounts for the following fields, so values must be divisible by 100 (whole currency units) since:

  • Trip option price
  • Trip option deposit
  • Discount amount when type: amount

If the value is not divisible by 100 (e.g. 12099), the API returns a 400 validation error.

*Payment Links API doesn't have such validation, all amount fields support cents precision.

NOTE: The “must be divisible by 100” rule does NOT apply to non-decimal currencies.

Discounts and price adjustments

  • type: amount uses minor units. (e.g. 15000 for 150 USD discount)
  • type: percentage uses whole percent values (e.g.15 = 15%). Decimal point is NOT supported (e.g. 15.50%)

Scope of validation

The “must be divisible by 100” validation currently applies only to the following fields for the Trips Builder API:

  • Trip option price
  • Trip option deposit
  • Discount amount when type: amount

Other amount fields (installments, price adjustments) are not validated by this rule.