API Reference

Payee Document Formats and Validation Rules

To ensure compliance with local regulations in supported countries, the PagSeguro Payout API requires that each payee includes a valid document number. This document must follow strict formatting rules depending on the country and whether the payee is an individual or a legal entity.

The API automatically validates the payee.document.value field based on the expected structure for the specified country and document type.

Supported Document Types

The table below outlines the accepted document types, their regular expressions (using ECMAScript / JavaScript syntax), and examples of valid values for Brazil and Colombia:

Document TypeValidation Pattern (RegEx)ExampleCountryDescription
CPF^[0-9]{11}$12345678901BRIndividual tax ID (Brazil)
CNPJ^[0-9]{14}$12345678901234BRLegal entity tax ID (Brazil)
CC^[0-9]{10}$1234567890COCédula de Ciudadanía (Colombia)
CE^[A-Za-z]{1}[0-9]{6}$A123456COCédula de Extranjería (Colombia)
TI^3[0-9]{9}$3123456789COTarjeta de Identidad (Colombia)
NIT^[0-9]{8,10}$123456789COLegal entity tax ID (Colombia)

📘

Legal Entities Must Use CNPJ or NIT

For business accounts:

  • Use CNPJ in Brazil.
  • Use NIT in Colombia.

These values are required to identify legal entities correctly.