Invoicing API

General Information

Payment Services will recycle the generated payment address. Please DO NOT keep it for a prolonged period of time for receiving additional deposits.

Generate Invoice

POST https://api.aquanow.io/payment/v1/invoice

Generate an invoice for invoicing.

Request Body

Name	Type	Description
amountDue*	string	The amount you wish to have receive
currency*	"CAD" | "USD" | "EUR" | "AED" | "GBP"	The fiat currency you wish to receive
accountId*	string	e.g., CA1000012R Specify the accountId of the account you wish to make the transaction for
customerPaysFee*	boolean	If the customer pays the fee → The invoiced amount includes both the amount due and the fee. If the customer does NOT pay the fee → The invoiced amount includes only the amount due, and your business pays the fee after conversion.
customerReferenceId	string	Text form for message
paymentOriginator*	"self" | "third party"	Payment origin: if sender is 'third party', kycInfo is required
kycInfo	object	PII Data required for KYC. Required if paymentOriginator is "third party"

200 : Success

{
    "invoiceId": "df48e2fd-1b84-4118-83ab-667765fac4c9",
    "username": "woojpay",
    "customerReferenceId": "HKJ10040321",
    "invoiceStatus": "CREATED",
    "paymentStatus": "NOT_PAID",
    "customerPaysFee": false,
    "invoiceSymbol": "USD",
    "amountDue": 100,
    "strategy": "ACA",
    "invoicingFee": 0,
    "invoiceReceivedAmount": 0,
    "processingFee": 0,
    "invoiceAmount": 100,
    "accountId": "CA1001112C"
}

400: If required fields are missing

Generate Bill

POST https://api.aquanow.io/payment/v1/bill

Generate a bill under an invoice to get address

Request Body

Name	Type	Description
invoiceId*	String	invoiceId to associate the bill with
cryptoType*	"BTC" | "ETH" | "BCH" | "USDT" | "LTC" | "USDC" | "POL" | "SOL"	The crypto you wish the deposit
networkType	"eth" | "tron"	For USDT you can also specify the network you wish to deposit to
feeModel	"SPREAD" | "EXPLICIT"	Determines how you the fee to be charged. If the invoice's customerPaysFee is set to true; you cannot select SPREAD Defaults to EXPLICIT

200 Success

{
    "deposit_address": "tb1q5qfkjx5p926hy95ek8fpyfp24q9wgm4469ha6t",
    "price": 97663.96674673,
    "expiryTime": 1738819669926,
    "quantity": 0.00102392,
    "paymentId": "95991db8-8361-4e55-a3f1-b31472953980"
}