Webhook for Payment Notification

With new regulations being introduced in Spain, we will need to integrate a notification system (via REST API) when a payment is made—this is called Verifactu. This system is already in place in some regions (the interested hub is located in a region where this system has already been implemented) and has been approved by the EU, meaning it will likely be adopted in other countries in the coming years.

To prepare for this, it would be highly practical to have a webhook trigger when a payment is made (or when an invoice is generated—open to discussion). This would allow us to execute a script or workflow (such as with n8n) to make the relevant API call.

The information required each time an order is paid would include the total price, items, and time of the transaction.

My question is whether this feature could be considered by the global community. If it is feasible, we may be able to allocate some budget to support its development.

Thank you for bringing this up.

This request is similar to another webhook that was requested:

The estimate there was 1.5 days dev time. The same applies here. For funding, we usually multiply this by a certain factor to account for review, testing, project management and contribution to maintenance. @Rachel, what’s that factor?

this is a complete stab in the dark but I would suggest a factor of x3

thanks @NickWeir !

@maikel I’m noticing you are talking about 1.5 days here but mentioned 1.5 hours on slack. Which is the good estimate?

@mikel I don’t think it’s a good move to rely on the invoice as current OFN invoices are made on the fly and are not stored (so can be created multiple times).

Can we get into more detail on the type of data needed? A few questions that came in for me:

  • what do you need when you mention “items”: name + unit + quantity sold?
  • what is the time of the transaction for you? time of payment or order completion date? If it is the time of payment, what is the expected behavior when the payment is made later in cash?
  • for price, do you need VAT breakdown?

thanks!

Oh dear, that’s a bad mistake. 1.5 days is the right one.