PIX · Card · Boleto
Charging, reconciling and paying out, in one place.
Every section below describes what the API does today — with its exact limits and defaults.
methods: ["PIX"]
PIX
Dynamic QR and copy-paste string generated at charge creation, settling to your balance same-day.
- Configurable expiry from 5 minutes to 7 days — 60-minute default
- Full or partial refund via API, once per charge
- MED disputes tracked on the platform, with MED_RECEIVED and MED_RESOLVED events
- endToEndId available for bank reconciliation
methods: ["CARD"]
Credit card
Direct single-payment charges, with optional two-step pre-authorization.
- authorizeOnly holds the amount; capture or void in a dedicated call
- Brand and last four digits in the response, never the full number
- R$ 5.00 minimum amount
- No installments: single-payment transactions
methods: ["BOLETO"]
Boleto
Payment line, barcode and PDF in the creation response.
- Due date configurable up to 1 year out
- Late fine, interest and early-payment discount, per boleto
- A boleto paid after its due date still settles to your balance
- R$ 5.00 minimum amount
mode: "hosted"
Hosted checkout
mode: hosted returns a ready payment URL; the payer picks the method and the charge advances on its own.
- A dedicated URL per charge on checkout.yuvexpay.com
- Offered methods set per charge in the methods field
- returnUrl and completionUrl to bring the payer back
- PENDING_METHOD_SELECTION status until the payer chooses
dashboard
Payment links
A link with its own slug, created in the dashboard, no code.
- Fixed or open amount, with min and max
- Payment methods enabled per link
- Expiry plus success and cancel URLs
- Optional fee pass-through to the payer
/v1/products
Product catalog
Products with price and image, referenced on charges by productId.
- Full CRUD via API and dashboard
- externalId to match your own catalog
- Available in the sandbox too
ledger
Ledger and reports
Every entry records the resulting balance — the ledger closes by construction, and you can prove it.
- Ledger with balance after each entry and on-demand integrity verification
- Exports of payments, payouts and ledger in CSV, XLSX, PDF and OFX
- Fee breakdowns and settlement forecast by period
- Filters by status, method, dates and amounts on every listing
HMAC-SHA256
Webhooks
Every status change becomes a signed event at your endpoint.
- Twelve events, from PAYMENT_CONFIRMED to WITHDRAWAL_FAILED
- HMAC-SHA256 signature with timestamp and a 300-second anti-replay window
- Retries with exponential backoff — 3 by default, up to 10
- Delivery headers with unique event, attempt and delivery ids