Tamio
Type to search all API docs, webhooks, and appendix pages
↑↓ Navigate ↵ Open Esc Close
Accounting API Invoices & Orders

Mark an invoice as paid

POST https://api.tamio.com/v2/invoices/mark-paid/{uuid}

Manually marks an invoice as paid without processing through payment gateways. Useful for offline payments, bank transfers, or cash payments. Optionally specify which products to mark as fulfilled.

Path Parameters

uuid string*

UUID of the invoice to mark as paid

Body Parameters

products array of object

Specific products to mark as fulfilled (all products if omitted)

JSON
{ "products": [ { "id": "00000000-0000-0000-0000-000000000000", "invoice_item_id": "00000000-0000-0000-0000-000000000000", "variation_id": "00000000-0000-0000-0000-000000000000" } ] }
id string

Product UUID from catalog

invoice_item_id string

Specific invoice line item UUID

variation_id string

Product variation UUID

Responses

200 Invoice marked as paid successfully

Invoice marked as paid successfully

status integer
invoice Invoice
400 Validation or business-logic error.
401 Missing or invalid API key
Previous
Retrieve an invoice
Next
Mark an invoice as shipped
/invoices/mark-paid/{uuid} 
1const response = await fetch("https://api.tamio.com/v2/invoices/mark-paid/{uuid}", {
2  method: "POST",
3  headers: {
4    "Authorization": "Bearer YOUR_API_KEY",
5    "Content-Type": "application/json"
6  },
7  body: JSON.stringify({
8    "products": [
9      {
10        "id": "00000000-0000-0000-0000-000000000000",
11        "invoice_item_id": "00000000-0000-0000-0000-000000000000",
12        "variation_id": "00000000-0000-0000-0000-000000000000"
13      }
14    ]
15  })
16});
17const data = await response.json();
Responses 
{
  "status": 200,
  "invoice": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "object": "invoice",
    "currency": "EUR",
    "paid": true,
    "processing_payment": false,
    "prefix": "INV-",
    "number": 1001,
    "total": 5000,
    "payment": "stripe_creditcard",
    "date": 1700000000,
    "status": "paid",
    "subscription": "660e8400-e29b-41d4-a716-446655440001",
    "locale": "en",
    "payment_retried": false,
    "payment_charge_date": 1700100000,
    "3d_secure_failure": false,
    "authorization_expiry": 1700604800,
    "affiliate_program": "770e8400-e29b-41d4-a716-446655440002",
    "affiliate": "880e8400-e29b-41d4-a716-446655440003",
    "late_failure": false,
    "has_subscriptions": false,
    "is_instalment": false,
    "fortnox_submitted": false,
    "start_date": 1700000000,
    "end_date": 1702592000,
    "has_notes": false,
    "customer_information": {
      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "name": "John Doe",
      "country": "NL",
      "email": "[email protected]",
      "stripe_customer_id": "cus_OxR5p8k3nM2qYz",
      "client_id": null,
      "billing_information": {
        "name": "John Doe",
        "country": "NL",
        "email": "[email protected]",
        "phone": "+31612345678",
        "address": "Keizersgracht 123",
        "postcode": "1015 CJ",
        "city": "Amsterdam",
        "ip": "203.0.113.42",
        "state": "Noord-Holland",
        "vat": "NL123456789B01",
        "company": "Acme B.V."
      },
      "shipping_information": {
        "address": "Prinsengracht 456",
        "postcode": "1016 HN",
        "country": "NL",
        "city": "Amsterdam",
        "state": "Noord-Holland",
        "name": "John Doe",
        "email": "[email protected]",
        "phone": "+31612345678",
        "company": "Acme B.V."
      }
    },
    "products": [
      {
        "id": "550e8400-e29b-41d4-a716-446655440000",
        "name": "Premium Widget",
        "quantity": 2,
        "type": "physical_product",
        "classification": "Tangible Goods",
        "currency": "EUR",
        "discount_allowed": true,
        "is_moss_product": false,
        "is_oss_product": false,
        "billing_cycle": null,
        "interval": null,
        "is_metered": false,
        "stripe_price_id": "price_1O2p3Q4r5S6t7U8v",
        "stripe_product_id": "prod_A1b2C3d4E5f6G7",
        "stripe_metered_id": null,
        "invoice_item_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
        "variation_id": "660e8400-e29b-41d4-a716-446655440001",
        "variation_label": "Large / Blue",
        "is_variant": false,
        "delivered": false,
        "cancelled": false,
        "sku": "WDG-PRM-001",
        "has_shipping": true,
        "weight": 2.5,
        "height": 10,
        "width": 20,
        "length": 30,
        "detailed_description": "string",
        "nshift_parcel_amount": 1,
        "nshift_quick_id": "string",
        "parcels": [],
        "trial_period": 14,
        "charge_shipping_during_trial": false,
        "taxes": {
          "inclusive": true,
          "eu_tax": true,
          "tax_rates": [],
          "shipping_tax_rates": []
        },
        "totals": {
          "unit_price": 2999,
          "item_total": 5998,
          "total": 7258,
          "discount": 0,
          "tax": 1260,
          "subtotal": 5998,
          "item_total_with_tax": 7258,
          "shipping": 500,
          "shipping_subtotal": 500,
          "shipping_discount": 0,
          "shipping_tax": 105,
          "shipping_total": 605,
          "exchange_rate": null,
          "price_conversion": false,
          "moss_taxable_amount": 0,
          "moss_tax_total": 0,
          "oss_taxable_amount": 0,
          "oss_tax_total": 0,
          "full_price": 0,
          "amount_paid": 7258,
          "amount_refunded": 0,
          "amount_cancelled": 0,
          "recurring_shipping_discount": 0,
          "recurring_shipping_cost": 500
        },
        "discounts": [
          {
            "id": "880e8400-e29b-41d4-a716-446655440003",
            "code": "SUMMER20",
            "discount": 600,
            "applies_to": []
          }
        ],
        "reservations": []
      }
    ],
    "shipping": {
      "has_shipping": true,
      "method": "Standard Delivery",
      "tracking": "3SXYZ1234567890",
      "shipped": false,
      "nshift_shipment_prepared": false,
      "nshift_shipment_stored": false,
      "is_nshift_shipment": false
    },
    "totals": {
      "total": 5000,
      "gateway_fees": 145,
      "affiliate_revenue": 0,
      "refunded_total": 0,
      "amount_paid": 5000,
      "amount_cancelled": 0,
      "subtotal": 4132,
      "discount": 0,
      "item_count": 2,
      "tax": 868,
      "shipping": 0,
      "shipping_total": 0,
      "shipping_discount": 0,
      "shipping_tax": 0,
      "moss_tax_total": 0,
      "moss_taxable_amount": 0,
      "item_total": 4132,
      "item_total_with_tax": 5000,
      "oss_taxable_amount": 0,
      "oss_tax_total": 0,
      "interest": 0,
      "amount_due": 0
    },
    "taxes": {
      "tax_rates": [
        {
          "id": "770e8400-e29b-41d4-a716-446655440002",
          "rate_percent": 21,
          "rate_amount": null,
          "label": "VAT 21%",
          "tax": 868,
          "moss": false,
          "jurisdiction": "de",
          "inclusive": true,
          "vat_tax": true,
          "applies_to": [
            "Premium Widget"
          ]
        }
      ],
      "shipping_tax_rates": [],
      "has_vat": true
    },
    "discounts": [
      {
        "id": "880e8400-e29b-41d4-a716-446655440003",
        "code": "SUMMER20",
        "discount": 600
      }
    ],
    "licenses": [
      {
        "key": "XXXX-YYYY-ZZZZ-1111",
        "product_id": "00000000-0000-0000-0000-000000000000"
      }
    ],
    "refunds": [
      {
        "amount": 5000,
        "date": "2024-01-15T14:30:00+00:00",
        "reason": "requested_by_customer"
      }
    ],
    "consents": {},
    "appendix": null,
    "transaction_id": "adf5c33d-3799-4d84-bf62-3b724c073ccf"
  }
}