Overview and Types

Overview

A transaction, in the Nium Platform, is a record of a debit/credit event that impacted the wallet balance. The platform supports a number of transaction types.

Transaction Types

Cards

Refer to Card Transactions page for corresponding transaction types and examples.

Payout

TypeDescription
Remittance_DebitDebit from wallet for remittance to one's own account.
Remittance_Debit_ExternalDebit from wallet for remittance to another's account.
Remittance_ReversalReversal of a remittance transaction.

Pay-in

TypeDescription
Wallet_Credit_Mode_CardFund credit to wallet using card.
Wallet_Credit_Mode_PrefundFund credit to wallet using client prefund.
Wallet_Credit_Mode_Prefund_Cross_CurrencyCross-currency fund credit to wallet using client prefund
Wallet_Credit_Mode_OfflineFund credit to wallet using an offline mode such as bank transfer from customer’s own account.
Wallet_Credit_Mode_Offline_Cross_CurrencyCross-currency fund credit to wallet using an offline mode such as bank transfer from customer’s own account.
Wallet_Credit_Mode_Offline_ThirdPartyFund credit to wallet, in same currency, using an offline mode such as bank transfer from a third party.

FX Conversion

When balance transfer within the wallet API is triggered, system will create one record and capture the details about the from/to amount.
| Type | Description |
|---------------------------------------------|-----------------------------------------------------------------|
| Wallet_Fund_Transfer | Fund transfer within wallet, from one currency pool to another. |

P2P Transfers

When a P2P transfer is executed using the P2P Transfer API, system will create two records.

  • Debit in the Sender's Wallet
  • Credit in the Receiver's Wallet
    | Type | Description |
    |---------------------------------------------|-----------------------------------------------------------------|
    | Customer_Wallet_Credit_Fund_Transfer | Funds received in wallet from another customer’s wallet. |
    | Customer_Wallet_Debit_Fund_Transfer | Funds sent from wallet to another customer’s wallet. |

Client Funding

TypeDescription
Client_PrefundCredit to client pool balance.
Client_RefundDeduction from client pool balance and transferred to client.
Wallet_RefundRefund money from the wallet back to the client.

Fees

TypeDescription
Fee_DebitFee deducted for a transaction.
Fee_ReversalReversal of a fee debit transaction.
Fee_WaiverFee waived for a transaction.

Open Banking

TypeDescription
Transfer_LocalLocal payments debited from wallet through PIS open banking.
Transfer_Local_ReversalLocal payments credited (reversed) from wallet through PIS open banking.

PLAIS (EU)

TypeDescription
Regulator_Auto_SweepFor European Economic Area (EEA) regulatory requirements, this transaction includes the amount moved from any other currency to EUR (requested block currency by the regulator) in case of a block instruction. In addition, this is valid if there is insufficient balance in EUR for blocking.
Regulatory_BlockFor European Economic Area (EEA) regulatory requirements, this transaction includes the amount moved to blocked amount from EUR (requested block currency by the regulator) in case of a block instruction.
Regulatory_DebitFor European Economic Area (EEA) regulatory requirements, this transaction includes the amount debited from block amount/ wallet balance of EUR (requested block currency by the regulator). This is valid when regulator asks us to send blocked amount to a beneficiary.
Regulatory_Debit_ReversalFor European Economic Area (EEA) regulatory requirements, this transaction includes the amount returned in case of failed Regulatory_Debit remittance.

Examples

Payout Transactions

ScenarioTransaction record created by the platform
Account holder submitted a payout instruction.Nium Platform will validate and process the payout instruction, and if the instruction can be accepted for processing, the Platform will create Remittance_Debit (if purposeCode is “Transfer to own account”) or Remittance_Debit_External (if purposeCode is not “Transfer to own account”) transaction. If fees are configured and can be applied, Nium Platform will also create the necessary Fee_Debit transaction.
The payout instruction is returned (could be for various reasons including rejected/returned by the bene bank).Nium Platform will create a new transaction record "Remittance_Reversal" (a credit record) with the Settlement Status set to Released. The original remittance transaction record (Remittance_Debit or Remittance_Debit_External) will be retained, and the Settlement Status in the original transaction will be set to Released.

Pay-in Transactions

ScenarioTransaction record created by the platform
When the account holder receives money by using Virtual Account Number (assigned at the account holder wallet)Nium Platform will create Wallet_Credit_Mode_Offline transaction record (account holder is the sender and the Platform able to match) or Wallet_Credit_Mode_Offline_ThirdParty transaction record (sender is not the account holder or the the Platform is unable to match). If fees are configured and can be applied, Nium Platform will also create the necessary Fee_Debit transaction.

Transaction Status and Settlement Status attributes

Every transaction in the platform has two status data elements

  • Transaction Status
  • Settlement Status

Transaction Status

Possible values of transaction status are as follows:

StatusDescription
ApprovedTransaction authorization is successful.
BlockedTransaction was blocked based on a rule or risk policy.
DeclinedTransaction authorization is unsuccessful.
PendingTransaction may be pending due to multiple reasons, such as a reversal pending to be processed for Amaze, transaction monitoring, etc.
ReversalTransaction was reversed.

Settlement Status

Possible values of settlement status are as follows:

StatusDescription
DisputedOnly in the case a dispute is raised for a transaction.
Dispute ClosedDispute raised on a transaction is now closed.
ReleasedThe transaction is released, such as after a reversal.
SettledTransaction settled with the scheme.
UnsettledTransaction is yet to be settled with the scheme.
WaivedCard Operations has waived a fee. Corresponding Fee_Debit transaction is waived.

Explanations for other transaction types (that are not cards-based).

P2P Transfers - when a P2P transfer is executed by using the P2P Transfer API, system will create two records - one for the debit leg and one for the credit leg:

  • Customer_Wallet_Debit_Fund_Transfer transaction record will be created in the sender’s wallet
  • Customer_Wallet_Credit_Fund_Transfer transaction record will be created in the receiver’s wallet

Currency exchange within wallet - when balance transfer within the wallet API is triggered, system will create just one record and capture the details about the from/to amount

  • Wallet_Fund_Transfer transaction record will be created in the account holder’s wallet

Payout / Remittance / Transfer Money - when a transfer operation is executed by using Transfer Money API

  • System will create either Remittance_Debit or Remittance_Debit_External transaction record. System will also create Fee_Debit transaction record (if any fee is applicable for processing the remittance transaction). These transactions will have debit impacts to the account holder’s wallet.

Pay In / Receive / Collect - when the account holder receives money by using Virtual Account Number (assigned at the account holder wallet)

  • System will create Wallet_Credit_Mode_Offline transaction record (account holder is the sender and system able to match) or Wallet_Credit_Mode_Offline_ThirdParty transaction record (sender is not the account holder or the system is unable to match)

Moving funds between Client Prefund and Account Holder’s Wallet and vice versa

  • When, by using the Fund Wallet API (fundingChannel: prefund), funds are moved from the client-prefund account to account holder’s wallet system will create Wallet_Credit_Mode_Prefund transaction record.
  • When, by using the Withdraw Funds From Wallet API (refundMode: CASH), funds are removed from the account holder wallet and moved back to client prefund system will create Wallet_Refund transaction record.