Payments
Fee statements
List and download as PDF the monthly statements with the fees on your payments.
What a statement is
Every month we issue a statement with the fees we deducted from your payments.
- One line per paid order, with rate, fixed fee and fee.
- The issuing entity's details and the tax details you entered in the dashboard.
- It's issued on the 1st of the following month. A month without payments has no statement.
- Numbering is sequential per issuing entity and year.
Note
It's an accounting summary, not a tax invoice. It needs the
statements:read scope.List statements
GET /v1/statements returns your statements, newest first.
This endpoint isn't paginated: it returns up to 120 statements (ten years) in a single response, with hasMore: false.
curl "https://api.business.tucapi.com/v1/statements" \ -H "Authorization: Bearer $TUCAPI_KEY"Response
{ "object": "list", "data": [ { "object": "statement", "id": "5d2c7a10-3b4e-4f6a-9c8d-7e6f5a4b3c2d", "number": "CBI-2026-000003", "period": "2026-08", "periodStart": "2026-08-01T00:00:00Z", "periodEnd": "2026-09-01T00:00:00Z", "currency": "USDT", "orderCount": 12, "grossAmount": "1480.00", "feeAmount": "77.60", "issuer": { "entity": "CAIBO_INC", "name": "Caibo Inc." }, "issuedAt": "2026-09-01T06:00:12Z", "pdfUrl": "/v1/statements/5d2c7a10-3b4e-4f6a-9c8d-7e6f5a4b3c2d/pdf" } ], "hasMore": false, "nextCursor": null}See the details
GET /v1/statements/{id} returns the same object with lines, one per order:
| Field | What it is |
|---|---|
orderId, merchantOrderRef | The paid order. |
paymentMethod, paidAt | How and when it was paid. |
grossAmount | Gross amount. |
feeRate, fixedFee | Rate (a fraction: "0.035" is 3.5%) and fixed fee applied. |
feeAmount | Fee for that order. |
curl "https://api.business.tucapi.com/v1/statements/5d2c7a10-3b4e-4f6a-9c8d-7e6f5a4b3c2d" \ -H "Authorization: Bearer $TUCAPI_KEY"Response
{ "object": "statement", "id": "5d2c7a10-3b4e-4f6a-9c8d-7e6f5a4b3c2d", "number": "CBI-2026-000003", "period": "2026-08", "periodStart": "2026-08-01T00:00:00Z", "periodEnd": "2026-09-01T00:00:00Z", "currency": "USDT", "orderCount": 12, "grossAmount": "1480.00", "feeAmount": "77.60", "issuer": { "entity": "CAIBO_INC", "name": "Caibo Inc." }, "issuedAt": "2026-09-01T06:00:12Z", "pdfUrl": "/v1/statements/5d2c7a10-3b4e-4f6a-9c8d-7e6f5a4b3c2d/pdf", "lines": [ { "orderId": "c9227f9b-13f4-4e9c-8fe0-4644e62b83cd", "merchantOrderRef": "MO-k7x2m9qz-1a2b3c4d", "paymentMethod": "paypal", "paidAt": "2026-08-14T15:20:11Z", "grossAmount": "125.00", "feeRate": "0.035", "fixedFee": "0.30", "feeAmount": "4.68" } ]}Download the PDF
GET /v1/statements/{id}/pdf returns the PDF with Content-Type: application/pdf.
Each statement's pdfUrl field already has that path.
curl -o CBI-2026-000003.pdf "https://api.business.tucapi.com/v1/statements/5d2c7a10-3b4e-4f6a-9c8d-7e6f5a4b3c2d/pdf" \ -H "Authorization: Bearer $TUCAPI_KEY"