For the complete documentation index, see llms.txt. This page is also available as Markdown.

Payments

Overview

Payouts and Invoices now appear together in one table. You create new records from two buttons at the top of the page:

  • Make a Payment

  • Receive a Payment

Button

Action

Description

Make a Payment

Send funds out

Creates a payout to a counterparty (previously the "Payouts" tab).

Receive a Payment

Request funds in

Creates a payment link / invoice for a customer to pay (previously the "Invoicing" tab).

Legacy Bill rows appear only for select legacy clients. Users can't create new Bills.

Payments table

This table lists every payment record created from "Make a Payment" and "Receive a Payment" into one unified view.

Columns: Name, Nickname/Client Reference, Payment Type, Status, Currency, Amount, Created At.

Search, filter, and group

Control
Behavior

Search Payments

Dynamic search — matches against any field in the table (name, reference, currency, etc.) as you type.

Payment Type

Filter by Receive, Bill, or Payout.

Status

Filter by status. Statuses are grouped under their payment type (Receive / Bill / Payout) — see “Status reference” below.

Group by

Group the table by Name or Nickname/Client Reference. Grouping turns off pagination — all results load on one page — and each group shows a subheader with the group name and the number of payments in it. You can still search and filter further within a grouped view.

Timeframe

Quick presets: 1 week, 1 month (default), 3 months.

  • As the table combines three record types (payouts, invoicing, bills from legacy), only columns common to all three payment types are shown. Column-specific detail (e.g. transaction hash, processing fee) is available on the record's detail panel — see Viewing payment details below.

  • Payments made toward an invoice/payment link no longer appear as their own row in the table. Instead, they show up inside the Timeline of their associated invoice's detail panel, including the received amount, the crypto asset used, the equivalent value in the invoice's fiat currency, and the transaction hash.

The Status filter groups options under Receive, Bill, and Payout.

Grouping by Name collapses the table into named groups with a payment count per group.

Export Data

  1. Click the Export button at the top left of the table.

  1. In the Export payments popup that displays, select the relevant checkbox depending on the fields that you wish to include in the .CSV file.

    • Files: Choose which record types to include: Payment links, Bills, Payouts (all unchecked by default).

    • Date range: a From / To date picker. The range defaults to, and cannot exceed, 90 days back from today (the underlying API rejects longer ranges).

  1. Click Export to generate the files.

The Excel files (in .CSV format) are downloaded accordingly.

Each selected file type downloads as a separate .CSV (Excel)file, named with the file type and the export date, e.g. `payment-links-2026-09-23.csv`, `bill-payments-2026-09-23.csv`, `payouts-2026-09-23.csv`. You can now select a custom date range from the .CSV file. A notification confirms the export and the downloads appear in your browser's download tray.

For Bills exports, records only appear under Bills if they were created through the legacy "create payment bill" / request-payment-address flow. New (V2) invoices created through Receive a Payment are separate records and are exported under Payment links, not Bills. Once a V2 invoice is paid, the payment itself does not create a duplicate row — it's recorded in the invoice's own Timeline (see Viewing payment details above).

Make a Payment

You can use Make a Payment to send funds to a counterparty. This is a 3-step process.

Step 1 — Select recipient

Search for the recipient by name or Nickname/Client Reference. Only people already saved in your Address Book (as a counterparty) will appear in suggestions.

  • If the recipient isn't saved yet, select Add a counterparty to run through the standard Address Book add-counterparty flow before continuing.

You can refer to the Address Book and Adding a Counterparty pages for more details on how to add a counterparty.

Step 2 — Payout amount

Choose the Destination address for the selected recipient (or Add a new address); this opens the same popup used in Address Book), then enter the amount and currency you are sending. The fiat drop down only shows fiats for which you currently have a balance.

You can either choose to:

  • enter the amount which you want to send

  • or enter an amount that the recipient is supposed to receive.

Depending on your choice, the corresponding amount is calculated automatically.

Step 3 — Confirm and get quote

Once both sides of the amount are filled in on Step 2, the Get quote button becomes active. Click it to move to Step 3.

Review the locked-in quote for You send, Recipient receives, Rate, Recipient, Sent from, Network, Nickname/Client Reference and Destination address, before the quote expires. A live countdown is shown (e.g. “Quote expires in 21s”). Enter your 2FA code and select Confirm. You can also select Edit amounts to go back and adjust the quote.

Once confirmed, a Payout submitted confirmation is shown with a status badge (Processing) and an Order ID.

Select Close window — the payout appears as a new row in the Payments table.

Receive a Payment

Use Receive a Payment to request funds from a customer via a shareable payment link. This opens a popup with two options, depending on whether the customer's information is already on file or if the customer is new

  • Select customer – You use this option when your customer's information is already on file (i.e., they exist in your Address Book). You search for them by name or by their Nickname/Client Reference, enter the Billable Amount and Currency, and choose who pays the fee. Because their info is already on file, the checkout flow skips KYC for the payer — when they open the link, they just pick what they want to pay with and go straight through checkout.

  • New customer – You use this when the person is not in your Address Book yet. You can either enter the payee’s details, which saves them as a counterparty in your Address Book, or add an Nickname/Client Reference to identify them easily later. The Nickname/Client Reference is optional and can be left blank.

Select customer

  1. Choose the Select customer tab and search for the customer by name or Nickname/Client Reference.

  2. Enter the Billable Amount and Currency.

  3. Choose the relevant option from the Who pays the fee toggle.

    • Merchant pays fee: The customer pays only the original listed price, and the transaction fee is taken out of the business's final payout.

    • Customer Pays Fee: The payment fee is added to the checkout total, so the buyer pays the extra cost and the business gets the full price of the item.

  4. Click the Create payment link button

New customer

  1. Select the New customer tab.

  2. Select the relevant option from the Who provides customer details dropdown.

  • Customer will provide their information at checkout: In this case, you do not need to provide your customer's KYC. You just create and send the link, and when the customer opens it, they fill out their own KYC info as Step 1 of the hosted checkout page (Payer information → Payment method → Pay).

  • I will provide the information: This opens the same add-a-counterparty popup used in Address Book. Completing it saves the person as a counterparty in your Address Book automatically.

  1. Enter the Billable amount, Currency and choose the relevant option from Who pays the fee tab.

  2. Click the Create payment link button

Once a payment link is created, a confirmation popup shows the shareable link and a pre-filled, editable message.

The newly received payment (the invoice) is added to the Payments table.

You have an option to preview a payment before sharing the payment link. To do so, click the Preview payment link to see how the payment details look like before you send it. The following details are observed on the payment link:

  • Payer (your customer) information dropdown with the following options:

    • Individual (I’m paying this invoice for myself)

    • Business (I’m paying this invoice on behalf of a business)

  • Invoice amount and its details

Once you are satisfied with what you see in the payment preview, you can share the payment link via:

  • Email: Opens your default mail app with the subject and message pre-populated. The message can be updated as per your preference.

  • Send link: Copies the link to your clipboard and you can share it via a message.

  • WhatsApp: Opens WhatsApp’s own Share on WhatsApp page with the message pre-filled, with options to Open app or Continue to WhatsApp Web.

  • Telegram: Opens Telegram’s share flow with the link.

The new request appears in the Payments table as a Receive row.

What the customer sees

The link opens a hosted Aquanow-powered checkout page for the payer. It has the following steps:

  • Payer/Customer information (Optional - depending on how you created the link)

  • Payment method: The customer is asked about the crypto asset they want to pay with (e.g. BTC, ETH, USDT, etc.) and relevant wallet details. They also see a breakdown of the amount due, the fee, and the total invoice amount.

In the Wallet type dropdown, there are two payment options for your customer to select from:

  • SELF_HOSTED: The wallet is controlled directly by the end customer (or the originating party) without an intermediary custodian — the user holds their own private keys.

  • Managed by a VASP (Virtual asset service provider): The wallet is held and controlled on behalf of the user by a regulated or licensed third-party custodian (such as an exchange, broker, or custodian) rather than by the user directly.

  • Pay Details: The customer is shown the crypto address along with the amount of crypto that needs to be deposited

Viewing payment details

Select any row in the Payments table to open its detail panel on the right. The panel is broken into three sections:

  • Header: Amount requested, current status badges (e.g. Open/Closed and payment status such as Not Paid/Paid), a progress bar, the amount received, and the outstanding amount.

  • Details

    • Who & When: Name, Nickname/Client Reference, Created At, Expires At.

    • Payment: Payable Amount (total the payer must pay, fees included), Status, Billable Amount (what your business actually receives before fees), Payment Status, Received Amount, Customer Pays Fee (Yes/No), Processing Fee, Net Deposit.

    • Transaction: Payment Link ID and Payment Link (copyable).

  • Timeline: A chronological log of events on the record (created, payments received, status changes), including the crypto amount, fiat-equivalent value, and transaction hash for each payment received.

At the bottom of the panel: Copy payment link and Download (exports a single CSV — `payment-link.csv` — for that record).

Reading the amount breakdown ("Paid example" above)

  • BILLABLE AMOUNT- The fiat amount you requested.

  • PAYABLE AMOUNT - What the customer owes at checkout.

    • If you pay the fee: Payable Amount = Billable Amount.

    • If the customer pays the fee: Payable Amount = Billable Amount + Processing Fee

  • RECEIVED AMOUNT - What the customer actually paid.

  • NET DEPOSIT - What lands in your account; = Received Amount – Processing Fee

    In other words, what your business actually keeps. This layout lets you see at a glance, e.g., "paid a total of $101, minus a $1 processing fee, net deposit $100."

Status reference

Statuses are grouped by payment type.

Status

Meaning

Not Paid

No payment received yet.

Partially Paid

A payment still in progress because crypto is sitting unconverted. Once the leftover crypto converts, a short invoice becomes Underpaid.

Underpaid

A finished payment that came up short.

Overpaid

More than the amount due was received.

Paid

Full amount received; record is Closed.

Bill (legacy)

Status

Meaning

Open

Payment address is active and awaiting payment.

Awaiting Confirmation

Payment has been submitted and is awaiting blockchain confirmation.

Overpaid

More than the billed amount was received.

Underpaid

Less than the billed amount was received.

Complete

Bill has been paid in full.

Not Converted

Received funds have not yet been converted.

Expired

The bill link expired before payment was made.

Awaiting Compliance

Record is pending a compliance review. (Renamed from “Suspicious Transaction” — this is a front-end label change only, requested to align with AML terminology; the underlying pending-compliance / compliance-rejected states are unchanged.)

Payout

Status

Meaning

Processing

Payout has been submitted and is in progress.

Completed

Payout has been successfully sent.

Failed

Payout did not complete.

Last updated