Concepts

Invoise gives your customer a payment address and sends the received funds to your wallet, minus the service fee.

Concept	Meaning
Account	A user who signs in to the platform and receives access to merchants and shops.
Merchant	A business in Invoise with its own shops, team and terms.
Shop	Where invoices and deposits are created. It has its own recipient settings, API keys and operation history.
Invoice	A request for a one-time payment of a fixed amount. Created through /invoices.
Deposit	A reusable address for top-ups without a fixed amount. Created through /deposits.
Incoming transfer	Funds sent by the payer to an invoice or deposit address. Several transfers can pay one invoice.
Payout	Received funds transferred to the shop’s recipient, minus the service fee.

issuance is the API resource name shared by invoices and deposits. Save the creation response’s id as issuance_id for subsequent requests.

Link an order in your own system to an invoice through external_id. The Invoise entity is always an invoice.

How a payment works

1. Create an invoice or deposit.
2. Wait for its address, then give the customer the returned payment_url.
3. The customer sends the selected token on the selected network.
4. Invoise confirms the incoming transfer. Once enough funds are available, it sends the payout to your recipient.

You can check progress with a GET request or receive webhooks. See Invoice and deposit status.

An invoice becomes funded when enough confirmed funds have arrived. Payout completion is confirmed separately by payout.confirmed.

Where payouts go

Setting	Purpose
Recipient address	The wallet that receives EVM payouts. Check that it supports your selected networks.
Invoise wallet	Instead of an address, a shop can pay into the Invoise wallet of an account member.
Delegate	An optional wallet you control that can settle EVM invoices independently and pay for gas. An exchange address is not suitable.

You can change the recipient, the delegate and the choice between an address and the Invoise wallet later with PATCH /shops/{shop_id}. Every invoice and deposit keeps the recipient and delegate it was created with, so a change reaches only invoices and addresses created afterwards.

Solana and Tron have their own recipients. See Solana and Tron.

Fees and small payments

The service fee is deducted from the payout. Read your shop’s current fees and limits; do not calculate them from a copied price list.

For deposits, small payments accumulate until the payout threshold is reached. For invoices, partial payments accumulate until the invoice amount is reached. An invoice overpayment goes to Invoise with the fee, not to your recipient.

Use a sandbox shop to try the integration without real funds.