MagicDoorAPI
SupportOpen MagicDoor
Deposit slips

Create deposit slips

Groups transactions onto deposit slips — one slip per bank account represented in the list — and claims each transaction so it cannot be grouped again. Requires the deposit_slips:write permission.

POST
https://services.magicdoor.com/accounting/company-portal/deposit-slips

Authorization

Authorizationstringrequired
Bearer token — Send your API token in the Authorization header as Bearer <token>. Requests without a valid token are rejected with 401 Unauthorized.

Body

application/json

Send transactions from several bank accounts and you get several slips back, one per account. It is all-or-nothing: if any transaction is ineligible or already claimed, nothing is created.

transactionIdsstring[]required

The transactions to group, at least one and with no duplicates. Every one must be a candidate.

example: ["1830472847398407201","1830472847398407202"]
depositedstring · date

The date the money was taken to the bank, read in the company's timezone. Defaults to today.

Response

200 · The slips that were created, as summaries. The envelope reports the slips as a single page: `page` is 1, `totalPages` is 1, and `pageSize` equals the number of slips.

itemsDepositSlip[]

One slip per bank account represented in transactionIds.

totalCountinteger

How many slips were created.

totalPagesinteger

Always 1.

pageinteger

Always 1.

pageSizeinteger

The same number as totalCount.

400 · `transactionIds` is empty or contains duplicates.

401 · The access token is missing, expired, or not for this company.

403 · The caller does not hold the `deposit_slips:write` permission.

404 · At least one transaction is not in the caller's company or is not eligible — wrong direction, not `success`, not an offline payment, zero or negative, or deleted. The response does not say which.

What can go on a deposit slip

Only a transaction that is money coming in (direction: "in"), has status success, has an amount greater than zero, was recorded as an offline payment rather than one taken through a processor, is not deleted, and is not already claimed by another deposit slip. Anything else is not a candidate and cannot be added.