Use Blockchain Payment Journal

This journal have the specific fields needed to prepare and execute a blockchain transaction.

• Blockchain Network
• From Address (debit).
  • You must own this account and have the private key stored and verified in Business Central, in order to spend the fund
• Destination OwnerShip
• Destination Address (credit)
  • The destination can be either owned by your company (for internal transfer or consolidation) or a thirdparty such as customer or vendor.
• Crypto Currency
  • The default blockchain network currency, but can be changed if « FromAddress » owned any other cryptocurrency.
• Amount
  • The raw amount, excluding transaction fee. The system update Amount LCY (Local company currency) and Net Amount accordingly
  • It is also possible to enter amount using the « Net Amount » field
• Fee
  • Depending the blockchain, you can select different fee level, to fasten the transaction completion. Some blockchain only have one option.
    Read more about fee managment here
    

In the above exemple, we can see two lines, one had just be submited to the blockchain while the other is still pending.
The « Transaction Hash » showed in the factbox represent the unique blockchain transaction identifier. It is public and can be shared with anyone.

Submiting a transaction

The action « Simulate Transaction » process every steps of the blockchain transaction execution and stop just before its sent to the network. It allow you to control if there is any issue before submiting it transaction for real.

The action « Submit Transaction » ask a confirmation of wich line user want to submit (on age selected line or all lines visible).

Disclamer : Once a transaction is submited to the blockchain, there is no way back ! Blockchain transactions are quickly broadcasted to multiple nodes making it impossible to cancel.
We strongly recommand to enable the approval Workflow on this journal in order to have at least two persons controling a journal line before it can be submited.

Each time an user use the submit action, a consent form will appear with the recap of transaction amount and risk disclosure. The user have to explicitly accept the form (checkbox at the bottom and press Accept) to let the system continue.

The line status becomae « Submited » and is keeped on the journal until the system detect that it has been confirmed by the blockchain network. The processing time is dependend on the network state and the provided fee.

There is rare case of transaction beeing rejected by the blockchain after it have been submited, if there is technical issue or insufficient funds to cover fees. The journal line is therefore marked as failed and can be removed by the user.

Fee Consumption

Fee amounts showed on the journal line are debited from the account once the transaction is confirmed by the blockchain network.

Fee amounts are alway expressed in the blockchain main currency. If you are transfering a different crypo-currency (such as USD Tether), the transaction fee is still using the main blockchain currency (eg SOL for solana network).

Archived Blockchain Payment

When a blockchain payment journal line is confirmed or failed after beeing submited, the line is archived in separated table for audit purpose. This archive is in addition of the « Blockchain Transaction » which can be reviewed under the Blockchain Account page, in the Transaction subform.

« Archived Blockchain Payment Journal Lines » is not editable and show the same field as the blockchain payment journal. Transaction Hash is clickable to open the details in blockchain explorer site.

Configure approval workflow

We strongly recommand to configure approval workflow for the blockchain payment journal.

A workflow template is available out of the box in the application, it is very similar to other existing Microsoft workflow templates such as Purchase Order Approval.

Under « Blockchain General Setup » page, use the action « Approval Workflow ». This will create the workflow template if not present yet.

From the opened list, identify the template named « Blockchain Payment Journal Approval Workflow ».
You can use the « New Workflow from Template » action to prepare a workflow, then press « Enabled » field of the newly created workflow.

You need then to configure approval users as per other standard Workflow.
Follow Microsoft guide to configure approvers here.
General MS documentation about approval workflow here.

On the blockchain payment journal, new action will shown when the workflow is enabled.
User can Send approval Request, Cancel approval Request or Approve, regarding their status.