Transaction types

A transaction type identifies a transaction, such as a purchase, as either a credit or a debit operation and determines whether the transaction has a financial impact on the customer account. You can call List transaction types to get the transaction types configured for your organization.

Transaction types are mapped to processing codes to create transaction flows. You can call the List transaction flows endpoint to get all transaction flow configurations for your organization. Refer to standard processing code to transaction type mapping below for more information.

A processing code can have one or more transaction types configured, depending on whether one or more transactions can be created through the processing code. You can create custom transaction types on the Pismo platform to represent different kinds of financial operations as applicable to your organization.

Processing codes and transaction types enable you to configure a single operation to generate multiple transactions. Each processing code request creates an authorization that in turn generates one or more transactions of different transaction types, as illustrated above.

Transaction types are objects with the following key fields (not a complete list):

FieldTypeDescription
transaction_type_idintegerTransaction type ID. For example, 101 = purchase.
creditbooleanIs this a credit or debit operation?
posted_transactionbooleanShould this transaction be posted on statements?

Transaction flow

The simplified diagram and the steps below illustrate the basic transactions flow on the Pismo platform and how the platform uses the configured processing codes and their mappings to transaction types.

Transactions flow diagram

Step 1—Client application makes a request

This request includes the processing codes.

Transfer processing codes

You can use two different processing codes in a single request when it’s a transfer operation:

  • One processing code that defines an operation to debit an internal account in the from array.
  • Another processing code that defines an operation to credit an external account in the to array.

Step 2—Pismo evaluates the request

The platform evaluates the request, creates an authorization, and generates the Authorization created event.

Step 3—Pismo generates a transaction

The platform uses the predefined mapping between the processing code and corresponding transaction types to create at least one transaction. A Transaction created event is generated for each created transaction.

Note: One authorization can generate multiple transactions: for example, one transaction for a principal amount and another transaction for an additional fee. These transactions can be of different types, debit or credit.

Step 4—Pismo updates the bank statement

Pismo updates the bank statement with the created transactions.

Processing codes and their relationships with transaction types have accounting implications. For example, if you have a debit operation, then the platform generates an accounting event for this operation. For more information, see the Accounting overview.

For more information on transactions, refer to the Transactions overview.

Payments configurations

You can configure processing codes, transaction types, their mappings, and other settings that manage how the platform will process operations in the payments and transactions flow. Refer to Payments configurations for more information. This guide has a tutorial on creating your own transaction flows.

Standard processing code to transaction type mapping

The platform has templates to associate standard processing codes with Pismo program types . The following templates are examples that can help you map the processing codes to the Pismo programs. Templates may include codes not applicable to your region.

Transaction banking

Accounts belonging to the transaction banking program types (current, internal, and correspondent).

Processing codeProcessing code descriptionBalance impactTransaction typeTransaction type description
219248HOLD FUNDS-1 (debit, cashout)7128HOLD FUNDS
219249HOLD FUNDS CANCEL1 (credit, cashin)92000046HOLD FUNDS CANCEL
219251RELEASE FUNDS1 (credit, cashin)7129RELEASE FUNDS
219252RELEASE FUNDS CANCEL-1 (debit, cashout)92000047RELEASE FUNDS CANCEL
219258HELD FUNDS CASHOUT TRANSFER-1 (debit, cashout)92000048HELD FUNDS CASHOUT TRANSFER
219259UNDO HELD FUNDS CASHOUT TRANSFER1 (credit, cashin)92000049UNDO HELD FUNDS CASHOUT TRANSFER
220035CASHIN TRANSFER1 (credit, cashin)92000040CASHIN TRANSFER
220036UNDO CASHIN TRANSFER-1 (debit, cashout)92000041UNDO CASHIN TRANSFER
220037CASHOUT TRANSFER-1 (debit, cashout)92000042CASHOUT TRANSFER
220038UNDO CASHOUT TRANSFER1 (credit, cashin)92000043UNDO CASHOUT TRANSFER
220039CREDIT ADJUSTMENT1 (credit, cashin)92000044CREDIT ADJUSTMENT
220040DEBIT ADJUSTMENT-1 (debit, cashout)92000045DEBIT ADJUSTMENT
220041FUTURE DATED CASHIN TRANSFER1 (credit, cashin)92000050FUTURE DATED CASHIN TRANSFER
220042UNDO FUTURE DATED CASHIN TRANSFER-1 (debit, cashout)92000051UNDO FUTURE DATED CASHIN TRANSFER
220043FUTURE DATED CASHOUT TRANSFER-1 (debit, cashout92000052FUTURE DATED CASHOUT TRANSFER
220044UNDO FUTURE DATED CASHOUT TRANSFER1 (credit, cashin)92000053UNDO FUTURE DATED CASHOUT TRANSFER
Full balance debit

Accounts for core banking with balance controls within the Pismo platform.

Processing codeProcessing code descriptionBalance impactTransaction typeTransaction type description
00PURCHASE-1 (debit, cashout)101PURCHASE
0001REFUND PURCHASE1 (credit, cashin)503PURCHASE REVERSAL
003100INTERNATIONAL PURCHASE-1 (debit, cashout)102INTERNATIONAL PURCHASE
003101INTERNATIONAL PURCHASE REVERSAL1 (credit, cashin)508INTERNATIONAL PURCHASE REV
007000DEBIT TRANSFER-1 (debit, cashout)304DEBIT TRANSFER
007001DEBIT REVERSAL1 (credit, cashin)392DEBIT REVERSAL
007200CREDIT TRANSFER1 (credit, cashin)320MONEY ORDER
007201CREDIT REVERSAL-1 (debit, cashout)391CREDIT REVERSAL
007503DEPOSIT BY BILL1 (credit, cashin)341DEPOSIT BY BILL
007700ZERO DEBIT TRANSFER0 (no impact, zero balance)*330ZERO DEBIT TRANSFER
007701TRANSFER REVERSION ZERO DEBIT0 (no impact, zero balance)*331TRANSFER REVERSION ZERO DEBIT
01NATIONAL WITHDRAWAL-1 (debit, cashout)123WITHDRAWAL
01NATIONAL WITHDRAWAL-1 (debit, cashout)604WITHDRAWAL FEE
0101REVERSE NATIONAL WITHDRAWAL1 (credit, cashin)512REVERSAL WITHDRAWAL
0101REVERSE NATIONAL WITHDRAWAL1 (credit, cashin)9467REVERSAL FEE WITHDRAWAL
013100INTERNATIONAL WITHDRAWAL-1 (debit, cashout)124INTERNATIONAL WITHDRAWAL
013100INTERNATIONAL WITHDRAWAL-1 (debit, cashout)604WITHDRAWAL FEE
013101REVERSAL INTERNATIONAL WITHDRAWAL1 (credit, cashin)510REVERSAL INTERNATIONAL WITHDRAWAL
20NATIONAL CREDIT VOUCHER1 (credit, cashin)203CREDIT VOUCHER
203100INTERNATIONAL CREDIT VOUCHER1 (credit, cashin)253CREDIT VOUCHER INTER
903002UTILITIES PAYMENT1 (credit, cashin)917UTILITIES PAYMENT
904002UTILITIES PAYMENT REVERSAL-1 (debit, cashout)541UTILITIES PAYMENT STATE
Full balance credit

Accounts for credit cards with balance controls within the Pismo platform.

Processing codeProcessing code descriptionBalance impactTransaction typeTransaction type description
219734INTEREST ON REVOLVING CREDIT-1 (debit, cashout)401INTEREST ON REVOLVING CREDIT
219735CAN INTEREST ON REVOLVING CREDIT1 (credit, cashin)451CAN INTEREST ON REVOLVING CREDIT
219736UNDO CANC INTEREST ON REVOLVING CREDIT-1 (debit, cashout)4519INT ON REVOLV CREDIT REV CANC
219737LATE PAYMENT INTEREST-1 (debit, cashout)402LATE PAYMENT INTEREST
219738CAN LATE PAYMENT INTEREST1 (credit, cashin)452CAN LATE PAYMENT INTEREST
219739UNDO CANC LATE PAYMENT INTEREST-1 (debit, cashout)4529LATE PAYMENT INT REV CANC
219740LATE FEE-1 (debit, cashout)403LATE FEE
219741CAN LATE FEE1 (credit, cashin)453CAN LATE FEE
219742UNDO CANC LATE FEE-1 (debit, cashout)4539LATE FEE REV CANC
219743TAXES-1 (debit, cashout)405TAXES
219744CAN TAXES1 (credit, cashin)455CAN TAXES
219745UNDO CANC TAXES-1 (debit, cashout)4559TAXES REV CANC
219746OVERLIMIT FEE-1 (debit, cashout)676OVERLIMIT FEE
219747CAN OVERLIMIT FEE1 (credit, cashin)6769OVERLIMIT FEE REVERSAL
219748UNDO CANC OVERLIMIT FEE-1 (debit, cashout)67699OVERLIMIT FEE REV CANC
219749DEBIT EXCHANGE DIFFERENCE-1 (debit, cashout)408DEBIT EXCHANGE DIFFERENCE
219750CAN DEBIT EXCHANGE DIFFERENCE1 (credit, cashin)4089CAN DEBIT EXCHANGE DIFFERENCE
219751UNDO CANC DEBIT EXCHANGE DIFFERENCE-1 (debit, cashout)40899DEBIT EXC DIFFE REV CANC
219752CREDIT EXCHANGE DIFFERENCE1 (credit, cashin)409CREDIT EXCHANGE DIFFERENCE
219753CAN CREDIT EXCHANGE DIFFERENCE-1 (debit, cashout)4099CREDIT EXCHANGE DIFFE REV
219754UNDO CANC CREDIT EXCHANGE DIFFERENCE1 (credit, cashin)40999UNDO CANC CREDIT EXCHANGE DIFFERENCE
219755ANNUITY-1 (debit, cashout)602ANNUITY
219756CAN ANNUITY1 (credit, cashin)606CAN ANNUITY
219757UNDO CAN ANNUITY-1 (debit, cashout)99602UNDO CAN ANNUITY
00PURCHASE-1 (debit, cashout)101PURCHASE
0001PURCHASE REVERSAL1 (credit, cashin)503PURCHASE REVERSAL
003100INTERNATIONAL PURCHASE-1 (debit, cashout)102INTERNATIONAL PURCHASE
003101INTERNATIONAL PURCHASE REV1 (credit, cashin)508INTERNATIONAL PURCHASE REV
003800INSTALLMENT WITHOUT INTEREST-1 (debit, cashout)111INSTALLMENT WITHOUT INTEREST
003800INSTALLMENT WITHOUT INTEREST-1 (debit, cashout)112INSTALLMENT WITHOUT INTEREST
003801INSTALLMENT WITHOUT INTEREST REV1 (credit, cashin)504INSTALLMENT WITHOUT INTEREST REV
003801INSTALLMENT WITHOUT INTEREST REV1 (credit, cashin)505INSTALLMENT WITHOUT INTEREST REV
004000PAYMENT1 (credit, cashin)201PAYMENT
004990CREDIT BY INSTALLMENTS1 (credit, cashin)701CREDIT BY INSTALLMENTS
004991REFINANCING AGREEMENT1 (credit, cashin)711REFINANCING AGREEMENT
004992COMPULSORY INSTALLMENT CREDIT1 (credit, cashin)721COMPULSORY INSTALLMENT CREDIT
004995CAN CREDIT BY INSTALLMENTS-1 (debit, cashout)705CAN CREDIT BY INSTALLMENTS
004996CAN REFINANCING AGREEMENT-1 (debit, cashout)715CAN REFINANCING AGREEMENT
004997CANC CREDIT COMPULSORY INSTALLMENT-1 (debit, cashout)725CANCEL COMPULSORY INST CREDIT
009100CREDIT ADJUSTMENT1 (credit, cashin)301CREDIT ADJUSTMENT
009200DEBIT ADJUSTMENT-1 (debit, cashout)302DEBIT ADJUSTMENT
01NATIONAL WITHDRAWAL-1 (debit, cashout)123WITHDRAWAL
01NATIONAL WITHDRAWAL-1 (debit, cashout)407WITHDRAWAL CHARGES
01NATIONAL WITHDRAWAL-1 (debit, cashout)604WITHDRAWAL FEE
0101NATIONAL WITHDRAWAL REV1 (credit, cashin)512WITHDRAWAL REV
0101NATIONAL WITHDRAWAL REV1 (credit, cashin)513WITHDRAWAL CHARGES REV
0101NATIONAL WITHDRAWAL REV1 (credit, cashin)9467WITHDRAWAL FEE REV
013100INTERNATIONAL WITHDRAWAL-1 (debit, cashout)124INTERNATIONAL WITHDRAWAL
013100INTERNATIONAL WITHDRAWAL-1 (debit, cashout)604INTERNATIONAL FEE
013101INTERNATIONAL WITHDRAWAL REV1 (credit, cashin)512WITHDRAWAL REV
013101INTERNATIONAL WITHDRAWAL REV1 (credit, cashin)617INTER WITHDRAWAL FEE REV
20NATIONAL CREDIT VOUCHER1 (credit, cashin)203CREDIT VOUCHER
203100INTERNATIONAL CREDIT VOUCHER1 (credit, cashin)253CREDIT VOUCHER INTER
Full balance prepaid

Accounts for prepaid credit cards with balance controls within the Pismo platform.

Processing codeProcessing code descriptionBalance impactTransaction typeTransaction type description
00PURCHASE-1 (debit, cashout)101PURCHASE
0001REFUND PURCHASE1 (credit, cashin)503PURCHASE CANCELLATION
003100INTERNATIONAL PURCHASE-1 (debit, cashout)102INTERNATIONAL PURCHASE
003101INTERNATIONAL PURCHASE REVERSAL1 (credit, cashin)508CANC INTERNATIONAL PURCHASE
007000DEBIT TRANSFER-1 (debit, cashout)304DEBIT TRANSFER
007001DEBIT REVERSAL1 (credit, cashin)392DEBIT REVERSAL
007200CREDIT TRANSFER1 (credit, cashin)320CREDIT TRANSFER
007201CREDIT REVERSAL-1 (debit, cashout)391CREDIT REVERSAL
01NATIONAL WITHDRAWAL-1 (debit, cashout)123WITHDRAWAL
01NATIONAL WITHDRAWAL-1 (debit, cashout)407WITHDRAWAL CHARGES
01NATIONAL WITHDRAWAL-1 (debit, cashout)604WITHDRAWAL FEE
0101REVERSE NATIONAL WITHDRAWAL1 (credit, cashin)512REVERSAL WITHDRAWAL
0101REVERSE NATIONAL WITHDRAWAL1 (credit, cashin)513REVERSAL WITHDRAWAL CHARGES
0101REVERSE NATIONAL WITHDRAWAL1 (credit, cashin)9467REVERSAL FEE WITHDRAWAL
013100INTERNATIONAL WITHDRAWAL-1 (debit, cashout)124INTERNATIONAL WITHDRAWAL
013101REVERSAL INTERNATIONAL WITHDRAWAL1 (credit, cashin)512REVERSAL WITHDRAWAL
20NATIONAL CREDIT VOUCHER1 (credit, cashin)203CREDIT VOUCHER
203100INTERNATIONAL CREDIT VOUCHER1 (credit, cashin)253CREDIT VOUCHER INTER