---
updatedAt: 2026-03-25T12:23:57.000Z
---

Fetch the complete documentation index at: https://developers.pismo.io/pismo-docs/llms.txt. Use this file to discover all available pages before exploring further.

# Create reversal processing code

Create a reversal processing code for an existing processing code.

This endpoint creates a `REVERSAL` type processing code and a [Orgs operation created](https://developers.pismo.io/events/docs/orgs-operation-create-1) event.


# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "Platform setup - Orgs operation",
    "description": "Orgs operations management endpoints.",
    "version": "v1.0",
    "contact": {
      "name": "Pismo Support",
      "url": "https://developers.pismo.io/support/"
    },
    "license": {
      "name": "Copyright Pismo."
    }
  },
  "servers": [
    {
      "url": "https://sandbox.pismolabs.io",
      "description": "Sandbox API server for testing"
    }
  ],
  "security": [
    {
      "S2SAuthentication": []
    }
  ],
  "tags": [
    {
      "name": "Reversal processing codes",
      "description": "Manage reversal processing codes"
    }
  ],
  "components": {
    "schemas": {
      "BalanceImpact": {
        "type": "integer",
        "description": "Balance impact associated with processing code:\n  * `1` - Credit \n  * `0` - No impact. Zero balance operations have no impact. Zero balance customers are responsible for settling accounts and generating transactions.\n  * `-1` - Debit\n",
        "enum": [
          1,
          0,
          -1
        ],
        "example": 1
      },
      "PcDescription": {
        "type": "string",
        "maxLength": 50,
        "description": "Processing code description"
      },
      "ProcessingCode": {
        "type": "string",
        "description": "A processing code identifies a financial operation on the Pismo platform. Processing codes need to be mapped to transaction type codes to create a transaction flow. \n\nA custom processing code is created with a `PENDING` status . Initially, its use is not allowed in authorizations. Once the transaction flow for a custom processing code is completely configured, its status changes to `SUCCESS` and it is ready for use. \n\nFor more information, refer to [Processing codes](https://developers.pismo.io/pismo-docs/docs/processing-codes-and-transaction-types)\n"
      },
      "ReversalOrgsOperationCreateResponse": {
        "type": "object",
        "properties": {
          "processing_code": {
            "$ref": "#/components/schemas/ProcessingCode"
          },
          "status": {
            "$ref": "#/components/schemas/Status"
          }
        }
      },
      "ReversalProcessingCodeCreateRequest": {
        "type": "object",
        "required": [
          "processing_code",
          "description"
        ],
        "properties": {
          "processing_code": {
            "type": "string",
            "description": "Processing code ID"
          },
          "balance_impact": {
            "$ref": "#/components/schemas/BalanceImpact"
          },
          "description": {
            "$ref": "#/components/schemas/PcDescription"
          },
          "translations": {
            "$ref": "#/components/schemas/Translations"
          }
        }
      },
      "Status": {
        "type": "string",
        "description": "Processing code status:\n  * `PENDING` - Missing required configurations. A custom processing code is initially created with a `PENDING` status and its use is not allowed in authorizations. Once the transaction flow for a custom processing code is completely configured, its status changes to `SUCCESS` and it is ready for use. All standard processing codes have a `SUCCESS` status.\n\n  * `SUCCESS` - Required configurations done\n",
        "enum": [
          "SUCCESS",
          "PENDING"
        ],
        "example": "SUCCESS"
      },
      "TranslatedLanguage": {
        "type": "string",
        "description": "Translation language. \n\nFor example, the code for English (United States) is `en-US`. The prefix, `en`, is a language code following the ISO 639-1 standard. The suffix, `US`, is a country code following the ISO 3166-1 Alpha-2 standard.\n",
        "example": "en-US"
      },
      "Translations": {
        "type": "array",
        "description": "Processing code descriptions translation in different languages",
        "items": {
          "type": "object",
          "properties": {
            "language": {
              "$ref": "#/components/schemas/TranslatedLanguage"
            },
            "description": {
              "type": "string",
              "maxLength": 50,
              "description": "Translated description"
            }
          }
        }
      },
      "HTTPError": {
        "type": "object",
        "description": "Code and error message.",
        "properties": {
          "code": {
            "type": "string",
            "description": "HTTP error code"
          },
          "message": {
            "type": "string",
            "description": "HTTP error message"
          }
        }
      }
    },
    "securitySchemes": {
      "S2SAuthentication": {
        "type": "http",
        "scheme": "bearer",
        "description": "All requests must be previously authenticated with an account token"
      }
    }
  },
  "paths": {
    "/orgs-operation/v1/reversal-processing-codes": {
      "post": {
        "summary": "Create reversal processing code",
        "description": "Create a reversal processing code for an existing processing code.\n\nThis endpoint creates a `REVERSAL` type processing code and a [Orgs operation created](https://developers.pismo.io/events/docs/orgs-operation-create-1) event.\n",
        "operationId": "ReversalProcessingCode",
        "tags": [
          "Reversal processing codes"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ReversalProcessingCodeCreateRequest"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Created",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ReversalOrgsOperationCreateResponse"
                }
              }
            }
          },
          "400": {
            "description": "Bad request error.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPError"
                }
              }
            }
          }
        }
      }
    }
  }
}
```