Factuarea APIDevelopers
Contract

A receipt for every payment

Payment receipts are issued per payment, partial payments included: the receipt operations of invoices and expenses accept an optional payment_id, and their MCP tools return the receipt number. Document PDFs show the issuer's IBAN only with bank payment methods and use a 9 pt base size by default. Two operations and two MCP tools updated.

15 October 2026 — Every active payment of an invoice or an expense has its own receipt, partial payments and advances included. The receipt shows the invoice as it stood right after that payment: the payments up to it, the amount collected and the amount still pending.

Receipts

  • Choose the payment — Download the receipt PDF of a payment and Download the receipt PDF of an expense payment accept the optional query parameter payment_id, the ID of a payment of that invoice or expense. Without it you get the receipt of the most recent active payment.
  • From the first payment — an invoice does not have to be fully paid to have a receipt: an advance already has one. A reversed payment has no receipt.
  • Number and file name — each receipt is numbered JC- (sales) or JP- (expenses), followed by the invoice number and the last six characters of the payment ID, for example JC-F-2026-014-282633. Content-Disposition names the file justificante-<number>.pdf.
  • Errors — 422 when the invoice or expense has no active payments or when payment_id is a reversed payment (business_rule_violation for invoices, receipt_not_available for expenses, with subcode no_active_payments or payment_reversed), and 404 resource_not_found when payment_id is not a payment of that invoice or expense.
  • MCP tools — get_invoice_payment_receipt and get_purchase_invoice_payment_receipt accept payment_id and return receipt_number together with the PDF.

The receipt follows the company's PDF branding (logo, colour, font and base size), writes the amount in words and is issued in the company's invoice language. It is not an invoice and carries no VERI*FACTU data.

Calls without payment_id keep working and return the receipt of the latest payment.

Document PDFs

  • The issuer's IBAN appears only when the payment method is a bank transfer or a direct debit, or when the document has no payment method.
  • Companies that have not chosen a base font size get their PDFs at 9 pt.

Updated endpoints2

EndpointDescription
GET/v1/invoices/{invoice}/payment-receiptDownload the receipt PDF of a payment
GET/v1/purchase_invoices/{purchase_invoice}/payment-receiptDownload the receipt PDF of an expense payment

On this page

Need a hand?Contact support