Identification
RUT as Identifiers
APIO uses the RUT (Rol Único Tributario) as a primary identifier for customers and payers within the Chilean ecosystem.
Using the RUT as an identifier allows APIO to uniquely and consistently identify individuals and organizations across payments, subscriptions, invoicing, and reconciliation processes.
RUT Format Examples
RUT values must be sent without points and using a hyphen to separate the verification digit.
| Example | Format Type | Reason |
|---|---|---|
12345678-9 | ✅ Correct | No points, includes hyphen and verification digit |
12.345.678-9 | ❌ Incorrect | Contains points |
123456789 | ❌ Incorrect | Missing hyphen |
12345678_9 | ❌ Incorrect | Uses invalid separator |
12345678 - 9 | ❌ Incorrect | Contains spaces |
12345678-k | ❌ Incorrect | Verification digit must be uppercase |
1234567-89 | ❌ Incorrect | Invalid RUT structure |
Usage in APIO
RUTs are commonly used in:
- Customer creation and updates
- Payer identification
- Invoice generation
- Subscription ownership
- Payment reconciliation
Providing a valid RUT ensures compliance with Chilean regulations and improves data consistency across financial operations.
Best Practices
- Always send the RUT as a string
- Do not include points or spaces
- Use uppercase
Kwhen applicable - Validate the RUT before sending it to the API
Following this format guarantees that RUTs are correctly processed and stored by APIO.