List all payments

GET /api/incoming-payments
<?xml version="1.0" encoding="UTF-8"?>
<incoming-payments type="array" page="1" per_page="100" total="2">
    <incoming-payment>
        ...
    <incoming-payment>
    <incoming-payment>
        ...
    <incoming-payment>
</incoming-payments>

You can filter the result by parameters:

GET /api/incoming-payments?incoming_id=123

List all payments for the incoming with ID 123.
The following filter parameters are available:

Parameter Description
incoming_id ID of the incoming
from Only payments since this date (format YYYY-MM-DD)
to Only payments up to this date (format YYYY-MM-DD)
type Payment type (eg. CASH, BANK_TRANSFER, PAYPAL, …). More than one payment type could be given as a comma separated list. Theses payment types will be logically OR-connected.
user_id ID of the user

Get single payment

GET /api/incoming-payments/{id}
<?xml version="1.0" encoding="UTF-8"?>
<incoming-payment>
    <id type="integer">1</id>
    <created type="datetime">2007-12-13T12:12:00+01:00</created>
    <incoming_id type="integer">1</incoming_id>
    <user_id type="integer">1</user_id>
    <date type="date">2009-11-04</date>
    <amount type="float">12.34</amount>
    <comment>via bank transfer</comment>
    <transaction_purpose></transaction_purpose>
    <type>BANK_TRANSFER</type>
</incoming-payment>

type can have the following values:
– CREDIT_NOTE
– BANK_CARD
– BANK_TRANSFER
– DEBIT
– CASH
– CHECK
– PAYPAL
– CREDIT_CARD
– COUPON
– MISC

Create payment

POST /api/incoming-payments
XML element Description Type Default value Mandatory
incoming_id ID of the incoming INT yes
date Date of payment DATE today
amount Paid amount FLOAT yes
comment Comment text ALNUM
type Payment type ALNUM (“CREDIT_NOTE”, “BANK_CARD”, “BANK_TRANSFER”, “DEBIT”, “CASH”, “CHECK”, “PAYPAL”, “CREDIT_CARD”, “COUPON”, “MISC”)
mark_incoming_as_paid Indicates whether the associated incoming should be marked as paid (set status to PAID). BOOL 0 (false)
<incoming-payment>
    <incoming_id>1</incoming_id>
    <date>2009-11-03</date>
    <amount>12.34</amount>
    <comment>via bank transfer</comment>
    <type>BANK_TRANSFER</type>
</incoming-payment>
<?xml version="1.0" encoding="UTF-8"?>
<incoming-payment>
    <id type="integer">1</id>
    <created type="datetime">2007-12-13T12:12:00+01:00</created>
    <incoming_id type="integer">1</incoming_id>
    <user_id type="integer">1</user_id>
    <date type="date">2009-11-03</date>
    <amount type="float">12.34</amount>
    <comment>via bank transfer</comment>
    <transaction_purpose></transaction_purpose>
    <type>BANK_TRANSFER</type>
</incoming-payment>

Delete payment

DELETE /api/incoming-payments/{id}

Deletes a payment and set its status to OPEN or OVERDUE.