First, you need to provide us information about who the issuer, supplier and the customer are. You can send this information in 2 ways:

  • Raw data sent directly via Request an invoice endpoint, or
  • You can use Onboard a company endpoint to give us the core company info (company_name, address, country) only once. Afterward, you can use the ID (id) which you got during onboarding repeatedly for referencing the company with various other products. The company can then take the role of the issuer, supplier, or customer within invoicing.
  • Moreover, you can use the Onboard individual endpoint to give us data on individuals once, and then use the corresponding ID (id) repeatedly for referencing them afterward. This can be useful in the case of B2C transactions where customers are private persons.

Finally, to generate a complete invoice, you will need to provide some transaction data, such as the price, and quantity of goods or services provided.

Here is a list of mandatory fields for generating an invoice through this endpoint.

📘

Use polling approach to get results

Since webhooks are currently under development, the Fonoa API is asynchronous.

Issue an invoice or a credit note, both directly to your customers, and on behalf of 3rd parties to their customers.

For example, to create an invoice, you should send a request using the POST Request an Invoice endpoint and fetch the response from the GET Get an invoice endpoint. Similarly, to create a credit note, you should send a request using the POST request a Credit Note endpoint and fetch the response from the GET Get an invoice endpoint.