To comply with local regulations and internal policies, the amount.value field in the Payout API must respect country-specific transaction limits. These constraints help ensure that each payout meets the required minimum and maximum thresholds based on your business model and destination country.
Transaction Limits by Country
| Country | Business Model | Minimum Limit | Maximum Limit |
|---|---|---|---|
| Brazil | Cross-border | BRL 0.01 | BRL 50,000 |
| Brazil | Gateway | Contact support | Contact support |
| Colombia | Cross-border | COP 1,000 | COP 20,000,000 |
Gateway Mode Limitations
Transaction limits in Gateway mode are not fixed and may depend on custom arrangements. Please contact your PagSeguro account manager for details.
Decimal Restrictions
Colombia
Colombian payouts must use whole values only. Decimal fractions (centavos) are not supported. You may include .0 or .00 for format compatibility, but any value with a non-zero fraction will be rejected.
| Accepted values | Invalid values |
|---|---|
50000 | 50000.23 |
50000.0 | 50000.12 |
50000.00 | 50000.2 |
Using fractional amounts will return a
422 Unprocessable Entityerror from the API.