UnblockPayGuideReference

Conventions & standards

This section outlines the standardized format for handling monetary and datetime values in our API, ensuring consistency across all transactions.

Date and time zone formatCopied!

All API date responses are in UTC ISO format. Regardless of your location, you'll receive UTC timestamps and will need to handle any conversions to local time in your application.

Here's how it works:

  • Format: YYYY-MM-DDThh:mm:ssZ

  • Where:

    • YYYY = four-digit year

    • MM = two-digit month (01-12)

    • DD = two-digit day (01-31)

    • T = separator between date and time

    • hh = hours in 24-hour format

    • mm = minutes

    • ss = seconds

    • Z = indicates UTC timezone

Example:

created_at: "2025-03-14T16:06:24.642Z"

Monetary amounts format Copied!

All monetary values in our API must follow strict formatting guidelines to ensure accurate processing and prevent any potential errors in transactions. Key formatting requirements include decimal precision and proper separators.

Below are the specific requirements for both fiat and cryptocurrency value formatting:

Fiat amountsCopied!

  • Always use 2 decimal places (e.g., 100.00, 1500.50)

  • Use period (.) as decimal separator

  • Do not use thousand separators

  • Do not include currency symbols ($, R$, €) in API payloads

  • Values should be provided as either strings or numbers

Stablecoin amountsCopied!

  • Use up to 6 decimal places (e.g., 100.000000)

  • Use period (.) as decimal separator

  • Do not use thousand separators

  • Values should be provided as either strings or numbers

Currency symbols formatCopied!

Our API uses standard three-letter currency codes for fiat currencies and four-letter currency codes for stablecoins:

  • Fiat currencies: BRL (Brazilian Real), USD (US Dollar), EUR (Euro)

  • Stablecoins: USDC (USD Coin), USDT (Tether)

© 2025 UnblockPay