One account per store, operated through the API: Pix charges, withdrawals, Pix copy-and-paste payments, transfers and statement.
Each credential operates a single account: no route takes accountId. To operate two accounts, use two credentials.
| Item | Rule |
|---|
| Base URL | https://api.hub.payzu.com.br/api/v1 |
| Amounts | Integers, in cents: 1500 is R$ 15.00. |
| Percentages | In basis points: 150 is 1.5%. |
| Dates | ISO 8601 in UTC, such as 2026-10-05T14:32:05.123Z. |
| Lists | Paginated by cursor: send the nextCursor from the response in the cursor parameter of the next call. It does not come on the last page. |
| Errors | { "message", "code", "details" }. Handle them by code; message is text for display. |
| Operation | The balance changes |
|---|
| Charge | When the customer pays. The PAYMENT_PAID webhook arrives. |
| Withdrawal and Pix copy-and-paste payment | At the time of the request: the amount and the fee leave the available balance. If the operation fails, they come back. |
| Transfer between accounts | Right away: the response already carries the result. |
| Pix received without a charge | When the Pix lands in the account. The DEPOSIT_RECEIVED webhook arrives. |
| Refund and deposit return | At the time of the request: the amount and the fee leave the available balance. If the refund fails, they come back. |
- Boleto and card. The API does not issue boletos or charge cards. For cards, see the Cards API.
- Respond to a MED dispute. The API shows the dispute; the response is given in the dashboard.
- Create or change a credential. Done by the account holder, in the dashboard at hub.payzu.com.br.
