Great News! To offer you an even better invoicing experience, Invoice Machine is officially joining invoicely on June 22nd, 2019.
Please make sure to switch to invoicely as soon as possible to continue using our platform.

Hook up your own application with The Machine's functionality.


This method let you add a payment for the invoice with the given id.

You call this method with the following URL:


Parameters are the data you will pass with the call.


Your secret identifier. You find your API Token under Account Overview in the Account section.

Rules: Required


The ID of the invoice.

Rules: Required.

amount (optional)

The amount of the payment.

Rules: Can only include numeric characters.

get (optional)

If this parameter is set the result sent back will be the edited invoice in XML data rather than the success message.

Rules: If parameter is used it must be set to "true". Otherwise it will be ignored.

Return Values

This is the result that will be passed back to you when you have sent a call.


Success: Payment added.

The payment was successfully added.

If you have set the get parameter to "true" you will rather get the edited invoice in XML sent back to you. Like this:

<?xml version="1.0" encoding="utf-8"?>
<request method="invoice.get">
        <date>15 Jan 2009</date>
        <due_date>16 Feb 2009</due_date>
        <notes>Thank you!</notes>
        <download_link></download_link >
        <payment_link></payment_link >
        <client_name>Sample Contact</client_name>
        <client_email>[email protected]</client_email>
        <client_company>Sample Company, Inc.</client_company>
        <client_address_line_01>35181 Invoice Street</client_address_line_01>
        <client_city>Invoice City</client_city>
        <client_country>United States</client_country>
        <your_name>Your Name</your_name>
        <your_email>[email protected]</your_email>
        <your_company>Your Company</your_company>
        <your_address_line_01>Your Address</your_address_line_01>
        <your_city>Your City</your_city>
        <your_country>United States</your_country>
                <description>Web design</description>
                <description>Web development</description>

Error: No data passed.

No data was passed to the method.

Error: API Token is invalid.

The API Token parameter is missing or is incorrectly entered.

Error: ID is invalid.

The ID parameter is missing or is incorrectly entered.

Error: Amount is invalid.

The Amount parameter is incorrectly entered.


The example below is strictly a demonstration of the method and it's parameters. Methods should never be posted from a HTML form. They should be posted directly from your server script.

<form action="" method="post">
    <input type="hidden" name="api_token" value="c86cea54c71sbb05a5f8297bed641944">
    <input type="hidden" name="id" value="205092">
    <input type="hidden" name="amount" value="200">