Export and import a program

Control Center enables you to migrate programs between environments (such as from a test environment to a production environment). Exporting a program downloads a JSON file to your computer. Using a text editor, you can modify the program's configuration — including program parameter values — before importing it to another Org. For more information about program parameters, refer to Program parameters reference.

📘

The export/import function supports only the debit, credit, and prepaid program types (both full balance and zero balance).

The following information is exported:

  • Program information:
    • Name
    • Type
    • Brand
    • Currency
    • Timezone
    • Country code
  • BIN
  • Due dates
  • Program parameters
  • Transaction types
  • Transaction categories
  • Processing codes
  • Origin (ID of the original program)

Export a program

To export programs:

  1. From the main menu, select Organization > Programs.
  2. On the Programs screen, select the program that you want to export.
  3. On the Program information screen, select Export.
  4. Select Export in the confirmation dialog.
  5. Click the notification that the program is ready for download.
  6. On the Program information screen, select Download.

The Download button remains available for seven days.

Import a program

To import a program, you must use a JSON file that was generated by exporting a Pismo program (see above). The import process validates the file and displays an error message if it encounters a problem.

🚧

If the JSON file that you want to import contains a transaction_category field whose value is null, the program transaction type is not imported. As a result, the value of the applicable_charges field will be empty. In such cases, you should modify the program and then export it again.

To import a program:

  1. From the main menu, select Organization > Programs.

  2. On the Programs screen, select Import programs.

  3. In the Import program dialog, drag the JSON file into the file upload area and then enter the program name.

  4. Select Import.

📘

Your request is processed in the background. When completed, Control Center sends you a notification. In the meantime, your new program displays on the Programs screen with the status Processing.

The program status changes from Processing to Active only after the platform completes a number of setup tasks behind the scenes. This can take up to 90 hours. In the meantime, you can do the following:

  1. Define the program's processing codes, transaction types, and program parameters. For more information, refer to Edit program details and parameters and Manage processing codes and transaction types.
  2. Add accounts that you want the program to manage using the Accounts API.