Introduction

​

Overview

Terminal action allows developers to insert custom decision making logic to extend Nomba Terminal features behaviour during different transaction scenarios.

Imagine your terminal is about to:

• Check balance

• Make a payout

• Perform another financial action

Instead of instantly completing the action, Terminal action pulse the process, send the transaction data to your backend system and wait for your system’s approval to either reject or continue the process. After your system’s instruction(based on your business rule) it sends a response back to the terminal to:

• Proceed with the transaction

• Modify some parameters

• Cancel or reject the action

Think of it as middleware for your terminal — it gives your infrastructure control over what happens next in real time.

​

Quick Action

​

Terminal Actions Scenarios

Terminal actions can be triggered at different stages of a transaction to allow custom business logic to run before proceeding. Below are examples of supported scenarios, their action precedence, types, and execution modes.

​

Precedence

Precedence defines the exact point in the transaction pipeline where a terminal action is triggered.
It determines when your custom logic is executed relative to the terminal’s built-in process — such as before showing a balance or after requesting a PIN.

This lets you:

• Enforce business rules before the terminal proceeds

• Reject unauthorized actions early

• Run validations like balance checks and similar actions

1. pre-payout-auth: Triggered when a user is about to initiate a payout transaction, immediately after the terminal requests a PIN. This allows you to validate the transaction, apply rules, or reject it before processing.

2. pre-balance-check-auth: Triggered when a user attempts to check their wallet or account balance. This provides an opportunity to authorize or restrict access based on custom logic.

​

Reason Code List

Terminal Action responses include a reasonCode that indicates the outcome of your custom logic and guides the terminal on what to do next.

These codes help standardize system responses, making them easy to interpret programmatically.

​

What is a reasonCode?

A reasonCode is a status flag returned in your response to indicate whether the transaction should proceed or not, and why It is paired with shouldActionProceed: true/false to clearly guide the terminal’s next step.

{
	"shouldActionProceed": true,
	"reasonCode": "00"		 
}

​

Reason Code Reference