{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-receivables/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Issuing boletos","description":"Start today using our public API to power your next project."},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"issuing-boletos"},"children":["Issuing boletos"]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Create a boleto your customer pays, track it, and change course when they need more time."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"issue-the-boleto"},"children":["Issue the boleto"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /v1/boletos"]}," (scope ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["boletos:write"]},") creates a boleto available for immediate payment. ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["amount"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["dueDate"]},", and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payerData"]}," are required; ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["bolepixEnabled"]}," defaults to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["true"]},"."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl -X POST \\\n  'https://public-sandbox.tryjeeves.com/v1/boletos' \\\n  -H \"Authorization: Bearer $JEEVES_ACCESS_TOKEN\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"amount\": 5000,\n    \"dueDate\": \"2026-11-15\",\n    \"memo\": \"Payment for services\",\n    \"bolepixEnabled\": true,\n    \"payerData\": {\n      \"name\": \"Global Tech\",\n      \"personType\": \"legal\",\n      \"documentNumber\": \"12345678000195\",\n      \"email\": \"finance@globaltech.com\",\n      \"phone\": { \"countryCode\": \"055\", \"areaCode\": \"11\", \"number\": \"987654321\" },\n      \"address\": {\n        \"street\": \"101 High St.\",\n        \"number\": \"202\",\n        \"neighborhood\": \"Tech Park\",\n        \"postalCode\": \"01001000\",\n        \"city\": \"São Paulo\",\n        \"state\": \"SP\"\n      }\n    },\n    \"metadata\": { \"internalReference\": \"INV-789\" }\n  }'\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":"Field"},"children":["Field"]},{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":"Notes"},"children":["Notes"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["amount"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Payment amount, positive."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["dueDate"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["ISO 8601 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["YYYY-MM-DD"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["memo"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Optional note for the payer, shown on the boleto, max 320 chars."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payerData"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Your customer: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["personType"]}," is ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["natural"]}," (CPF, 11 digits) or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["legal"]}," (CNPJ, 14 digits); ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["email"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["phone"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["address"]}," are optional; when you send ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["address"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["state"]}," is a Brazilian UF code."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["bolepixEnabled"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["true"]}," (default) adds a Pix QR code — instant settlement, boleto marked paid directly."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["fine"]}," / ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["interest"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Optional late-payment fine and interest terms."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["metadata"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Your own key-value reference data."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"track-it"},"children":["Track it"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl 'https://public-sandbox.tryjeeves.com/v1/boletos?page=1&pageSize=20' \\\n  -H \"Authorization: Bearer $JEEVES_ACCESS_TOKEN\"\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl 'https://public-sandbox.tryjeeves.com/v1/boletos/123e4567-e89b-12d3-a456-426614174000' \\\n  -H \"Authorization: Bearer $JEEVES_ACCESS_TOKEN\"\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For boletos paid by barcode or digitable line, expect the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["early payment notice"]}," up to one day before final settlement — settlement is guaranteed once noticed. Bolepix payments settle instantly."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"give-the-payer-more-time"},"children":["Give the payer more time"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /v1/boletos/{id}/extend"]}," moves the due date without cancelling and reissuing:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl -X POST \\\n  'https://public-sandbox.tryjeeves.com/v1/boletos/123e4567-e89b-12d3-a456-426614174000/extend' \\\n  -H \"Authorization: Bearer $JEEVES_ACCESS_TOKEN\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{ \"newDueDate\": \"2026-12-15\" }'\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"cancel"},"children":["Cancel"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /v1/boletos/{id}/cancel"]}," voids an unpaid boleto:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl -X POST \\\n  'https://public-sandbox.tryjeeves.com/v1/boletos/123e4567-e89b-12d3-a456-426614174000/cancel' \\\n  -H \"Authorization: Bearer $JEEVES_ACCESS_TOKEN\"\n","lang":"bash"},"children":[]}]},"headings":[{"value":"Issuing boletos","id":"issuing-boletos","depth":1},{"value":"Issue the boleto","id":"issue-the-boleto","depth":2},{"value":"Track it","id":"track-it","depth":2},{"value":"Give the payer more time","id":"give-the-payer-more-time","depth":2},{"value":"Cancel","id":"cancel","depth":2}],"frontmatter":{"seo":{"title":"Issuing boletos"}},"lastModified":"2026-10-28T18:10:31.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/receivables/issuing-boletos","userData":{"isAuthenticated":false,"teams":["anonymous"]}}