V2 Invoicing APIs

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/v2/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

KYC V2

PII Data required for KYC. Required if paymentOriginator is "third party"

{
    "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"
}

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

networkSymbol*

string

The network you wish to use for a speicfic currency

walleType*

"VASP" | "SELF_HOSTED" | "OTHER_VASP"

vaspId

uuid

required if walletType === "VASP", refere to Wallet Types API

vaspName

string

required if walletTypes === "OTHER_VASP" (the vasp you are using does not have a vaspId) specify the name.

vaspWebsite

string

If walletTypes === "OTHER_VASP" (the vasp you are using does not have a vaspId) specify the url.

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

PreviousInvoicing APINextPayouts API

Last updated