Skip to main content
Finrock’s invoicing feature lets you generate on-chain payment requests that your customers can settle in cryptocurrency. When you create an invoice you specify the crypto asset to accept, an optional fiat currency for price estimation, a descriptive memo, and optionally the payer’s details. Finrock returns a unique deposit address, a payment amount (calculated at current market rates if fiat is provided), and an expiry time, giving your payer clear and time-bound payment instructions.

​
Request

Method: POST URL: https://api.finrock.io/dac/v1/create-invoice
​
object
required
Crypto payment details specifying which asset to accept.
​
object
Optional fiat estimation details. When provided, Finrock converts the fiat amount to an equivalent crypto amount using the current exchange rate.
​
string
required
A descriptive note for this payment. This is displayed to the payer and helps you identify the invoice in your records (e.g., Order #1042, Subscription renewal - Jan 2025).
​
object
Optional information about the sender of the payment.

​
Example Request

​
Response

A 200 response returns the created invoice object, including a deposit address, the crypto amount due, and an expiry timestamp. A 400 response indicates a missing required field or invalid asset.
​
object
The newly created invoice object, including payment address, amount, fiat equivalent, memo, and expiry time.
​
object
Returned when required fields are missing or the specified asset is not supported.
Invoices are time-limited. Ensure your payer sends the payment before the expiry timestamp. Payments received after expiry may require manual reconciliation.