v1

latestOpenAPI 3.1.0Copyright Pismo2026-07-247702,7523.1 MB

Processing codes

Create processing code

Create a processing code for an organization.

Processing codes identify financial operations on the Pismo platform. For example, 00 is a purchase, 01 is a withdrawal, and so on.

Processing codes need to be mapped to transaction types to create a transaction flow.

This endpoint creates an AUTHORIZATION type processing code and generates a Orgs operation created event.

Notes:

The prefix PSM is reserved at Pismo platform, customers are not allowed to use this prefix when creating custom processing codes . Not all standard processing codes have the PSMprefix. There are codes created before this standard and are kept for backward compatibility. New ones, however, will always have this prefix.
On the Pismo platform, 2-digit processing codes are reserved and used only for network processing. Because of this, customers are not allowed to have 2-digit custom processing codes.
When a new standard processing code is created, it is replicated and configured to all platform organizations, no action is required on your part.
This endpoint generates a Orgs operation created event.

For more information, refer to <a href="https://developers.pismo.io/pismo-docs/docs/processing-codes-and-transaction-types">Processing codes</a>.

post/orgs-operation/v1/processing-codes

Request body

processing_codestring required

Processing code ID

The following applies to this field:

It must have between 3 and 6 characters.
Only letters and numbers are allowed.
Must be unique and not already exist in the org's database
Cannot start with the prefix “PSM”, this is reserved for Pismo platform processing codes.

balance_impact1 | 0 | -1 required

Balance impact associated with processing code:

1 - Credit
0 - No impact. Zero balance operations have no impact. Zero balance customers are responsible for settling accounts and generating transactions.
-1 - Debit

descriptionstring required

Processing code description

reversal_processing_codestring required

Reversal processing code. Processing code for cancellation. Used in transactions and accounting flow to post the correct entries related to cancellation.

Every AUTHORIZATION processing code is REQUIRED to have a reversal and a partial reversal processing code. If a partial code isn't provided, a default one is assigned based on balance_impact.

The reversal processing code can either currently exist or not. If it exists, its balance_impact must be the opposite of the main processing code and its type must be REVERSAL.

For more information, refer to default reversal processing codes.

reversal_descriptionstring

Reversal description. If not passed, it is automatically set to "REV " plus the description field. For example, if description is "Purchase", the reversal description will be "REV Purchase".

partial_reversal_processing_codestring

Partial reversal processing code. Processing code for partial reversal cancellation. Used in transactions and accounting flow to post the correct entries related to partial cancellation.

Every AUTHORIZATION processing code is REQUIRED to have a reversal and a partial reversal processing code. If a partial code isn't provided, a default one is assigned based on balance_impact.

For more information, refer to default reversal processing codes.

partial_reversal_descriptionstring

Partial reversal description. REQUIRED if partial_reversal_processing_code does not exist.

tagsstring[]

Processing code tags. These tags apply ONLY to AUTHORIZATION type processing codes. You cannot add tags to reverse processing codes as they may be associated with more than one authorization processing code.

Example request

{
  "processing_code": "I87654",
  "balance_impact": 1,
  "reversal_processing_code": "578739",
  "reversal_description": "Reversal description",
  "partial_reversal_processing_code": "578739",
  "partial_reversal_description": "Partial reversal description",
  "tags": [
    "INDIA"
  ],
  "translations": [
    {
      "language": "en-US"
    }
  ]
}

Response

Processing code sucessfully created

processing_codestring

Processing code for the debit transaction.

If split_transaction is false (the default), each installment payment is recorded as one debit transaction equal to the installment amount minus the discount, and processing_code is the processing code for that transaction.

If split_transaction is true, each installment payment is recorded as two transactions: a debit transaction for the installment amount and a credit transaction for the discount. In this case, processing_code is the processsing code for the debit transaction, and second_processing_code is the processing code for the credit transaction.

reversal_processing_codestring

Reversal processing code. Processing code for cancellation. Used in transactions and accounting flow to post the correct entries related to cancellation.

Every AUTHORIZATION processing code is REQUIRED to have a reversal and a partial reversal processing code. If a partial code isn't provided, a default one is assigned based on balance_impact.

The reversal processing code can either currently exist or not. If it exists, its balance_impact must be the opposite of the main processing code and its type must be REVERSAL.

For more information, refer to default reversal processing codes.

partial_reversal_processing_codestring

Partial reversal processing code. Processing code for partial reversal cancellation. Used in transactions and accounting flow to post the correct entries related to partial cancellation.

Every AUTHORIZATION processing code is REQUIRED to have a reversal and a partial reversal processing code. If a partial code isn't provided, a default one is assigned based on balance_impact.

For more information, refer to default reversal processing codes.

status'PENDING' | 'PROCESSING' | 'CANCELLED' | 'SETTLED' | 'PROCESSED'

PENDING: Charge is scheduled and waiting for the cycle to close. PROCESSING: Cycle closing process has started and is awaiting completion. CANCELLED: Charge canceled due to link cancellation. SETTLED: Amount is zero and/or minimum_spend_to_charge has not been reached. PROCESSED: Charge was posted on the statement."

Example response

{
  "processing_code": "99066",
  "reversal_processing_code": "578739",
  "partial_reversal_processing_code": "578739",
  "status": "PENDING"
}