Data Types

This page describes the main data types used across Bamboo’s API for request and response parameters.

📘

These definitions apply primarily to Payins. Some data types (e.g. Amount, Timestamp) may differ in Payout operations. Always refer to the respective API guide for each product.

String

Represents a sequence of characters. Strings must be encoded in UTF-8. Maximum length is defined per field in the API reference.

Example values:

• "Juan"
• "Compra 001"
• "USD"

Numeric

Represents a positive integer. Length can be restricted using square brackets (e.g. Numeric[3] = max 3 digits).

Examples:

• 123 → ✅ Valid for Numeric[3]
• 1004 → ❌ Invalid for Numeric[3]

Amount

Special type of Numeric used to express monetary values.

Amounts must be sent without punctuation and include exactly two decimal places, even when zero.

Always express the amount in minor currency units (e.g. cents).

Timestamp

Represents a full date and time with milliseconds.

"YYYY-MM-DDTHH:mm:ss.ttt"

Where:

• YYYY indicates the year
• MM indicates the month
• DD indicates the day
• T indicates the beginning of the required time section
• hh indicates the hour (from 0 to 23)
• mm indicates the minutes
• ss indicates the seconds
• ttt indicates the milliseconds

Below are examples of how values should be codified:

Date

This data type contains an exact date. Unlike the TimeStamp data type, it does not include hours and is in the following format:

yyyyMMdd

Boolean

This data type is a logical value (true or false).

Enum

Represents a field with a restricted set of string values.

Example:

• Status: "APPROVED", "REJECTED", "PENDING"

Each enum is documented in the field description or API reference.

Object

Complex field containing nested subfields. Objects follow JSON structure and may contain other types (e.g. strings, booleans, or arrays).

Example:

"Customer": {
  "FirstName": "María",
  "Email": "[email protected]"
}

What’s Next?