# README

go-transact

Turn bank transaction notifications into action.

You receive money in your bank account.
Your institution sends a notification to your email address with transaction details. Importantly, the transaction has a description field which contains a unique string (let's call it a vendor reference id)
Your email provider redirects the email to go-transact
go-transact extracts transaction information from the email
go-transact POSTS the transaction details to a callback url of your choosing

Can be used in environments where payment API services are non-existent or hard to acquire to automate service offerings and subscriptions upon receipt of payment.
etc 👀

A database (SQLite) file will be created in the current working directory to store the following:

The provided Makefile contains the necessary commans to build.

Have an account at a bank that allows specifying a description when sending money.
Have the account receive email notifications upon receipt of credit transactions.
Email provider must be able to redirect emails.
Have a server to run go-transact on.

In your mail client, note your bank's email address and create a rule to redirect credit transaction emails to where go-transact will be running, i.e, [email protected]. I recommend using unguessable generated mailbox names such as openssl rand -hex 24
In your config.yaml, configure the regex patterns that will be used to extract transaction information from the mail.
Run go-transact (prefereably as a service)
(Optional but recommended) Setup firewall rules to only allow connections from mail service provider servers on port 25

To start daemon

./go-transact --config-file myconfig.yaml

To show usage

./go-transact --help

This program will only process emails from configured mailbox addresses to block uninvited visitors.

To prevent unwanted emails, you can setup firewall rules to only allow incoming connections from your mail provider.

The following example would only allow Outlook SMTP server to connect on port 25

iptables -A INPUT -s 40.92.18.77 -p tcp --dport 25 -j ACCEPT
iptables -A INPUT -p tcp --dport 25 -j DROP