Guides
Sub-processorsAbout PismoContact us

Program types

Programs are one of the Pismo platform's core objects. Once you've set up your Organization, the next step is to implement programs for it. Pismo has the following program types.

Card-issuing

Pismo has programs for issuing credit, debit, and prepaid cards.

Note: Full balance and Zero balance are Pismo platform card network integration models. For more information, refer to Full balance versus Zero balance integration.

Program typeDescriptionCode enum
Full balance creditFull balance credit accounts.
Credit product that enables a cardholder to borrow funds to pay for goods and services. These borrowed amounts must be paid back with interest and any additional agreed-upon charges. Credit cards provide the cardholder with a revolving line of credit, meaning they can borrow up to a certain limit and repay the amount over time.
For more information, refer to Get started with card issuing and Full balance credit program 		CREDITO
Zero balance creditZero balance credit accounts
Credit product that enables a cardholder to borrow funds to pay for goods and services. These borrowed amounts must be paid back with interest and any additional agreed-upon charges. Credit cards provide the cardholder with a revolving line of credit, meaning they can borrow up to a certain limit and repay the amount over time.
For more information, refer to Full balance versus Zero balance integration and .Zero balance integration - issuer's guide 		CREDITO ZERO-BALANCE
Full balance debitFull balance debit accounts
Operation values are automatically deducted from the cardholder's account.
For more information, refer to Get started with card issuing and Managing the charge order for debit transactions .		DEBITO
Zero balance debitZero balance debit accounts
Operation values are automatically deducted from the cardholder's account.
For more information, refer to Full versus Zero balance integration and Zero balance integration - issuer's guide 		DEBITO ZERO-BALANCE
Full balance prepaid creditFull balance prepaid accounts
Similar to a debit card. Requires previously deposited funds, specifically a prior recharge intended for executing payment transactions.
For more information, refer to Get started with card issuing.		PRE-PAGO
Zero balance prepaid creditZero balance prepaid accounts
Similar to a debit card. Requires previously deposited funds, specifically a prior recharge intended for executing payment transactions.
For more refer to Full versus Zero balance integration and Zero balance integration - issuer's guide 		PRE-PAGO ZERO-BALANCE
Voucher prepaid credit Voucher meal/food card.VOUCHER

Merchant

Program typeDescriptionCode enum
MerchantMerchant programs manage a seller's commercial accounts. Merchants can register and parameterize their products, rates and fees, home bank, and so on. For more information, refer to the Seller management overviewMERCHANT

Transaction banking

Transaction banking focuses on transactions between a bank and a large organization, such as a multinational corporation, lending for short-term expenses and long-term investments. For more information, refer to the Transaction banking overview

Program typeDescriptionCode enum
Correspondent accounts debitAccounts financial institutions hold with each other to facilitate international transactions and provide services to their customers in different geographic locations.CORRESPONDENT ACCOUNTS
Current accounts debitAlso known as checking accounts, these are a type of deposit account that businesses use to manage their everyday financial transactions. This bank account allows customers to manage their daily finances, serving as a central place to receive income, pay bills, and handle various transactions.CURRENT ACCOUNTS
Internal accounts debitAccount used within an organization for internal purposes rather than for transactions with external parties. These accounts help manage and track internal financial activities, such as bookkeeping, accounting, and internal fund transfers.INTERNAL ACCOUNTS

Creating and managing programs

A program's basic structure is detailed in the Create program endpoint. Refer to the Sample credit program below to find out what a typical internal credit program configuration might look like.

You can create and manage programs using Pismo Control Center. You can also do the same using the Programs API .

📘

Program implementation

When a program is first created, its status is PENDING. To configure PCI cards and accounting, please open a Jira ticket . After Pismo's Payment Card Industry (PCI) and accounting teams have done their behind-the-scenes work and configurations, the program's status becomes ACTIVE and is available for use.

Getting started

Once you've picked a program, you need to start doing the following:

Step 1—Determine the processing codes and transaction types your program will use in its operations

Processing codes, in combination with transaction types, define how financial operations are implemented on the Pismo platform. For each organization, Pismo provides a standard set of processing codes.

Pismo also provides a standard set of processing codes to transaction types mapping. These mappings are known as transaction flows. This is a reference you can use to define the transaction flows for your program. This can be done in Pismo Control Center or with the Create transaction flow endpoint.

Step 2—Set the values for your program parameters

Program parameters define limits and what your program allows or doesn't allow. The Progam parameters reference table indicates what parameters are automatically assigned to a program depending on its type. You can set values for your assigned parameters either in the Pismo Control Center or with the Programs API.

Step 3—Create your program's accounts and customers

Begin creating your program's accounts and customers.

Sample credit program

Internally, the Pismo platform keeps a JSON file for each program. Below is an example of what a typical credit program might look like, with the processing codes, transaction types, transaction categories, network acceptances, and program parameters given to a credit program upon creation. Other fields that you need to configure, such as brand, currency_numeric_code, bin, due_dates, and other fields are also shown.

Credit program JSON 
{
  "name": "Cred",
  "program_type": "CREDITO",
  "brand": "VISA",
  "currency_numeric_code": "971",
  "timezone": "Africa/Addis_Ababa",
  "country_code": "AFG",
  "bin": {
    "value": "123121",
    "start_range": "123121",
    "end_range": "567565"
  },
  "due_dates": [
    {
      "day": 1,
      "active": true
    },
    {
      "day": 4,
      "active": true
    },
    {
      "day": 3,
      "active": true
    },
    {
      "day": 5,
      "active": true
    }
  ],
  "programs_parameters": [
    {
      "parameter_name": "VALOR ANUIDADE",
      "value": 0,
      "status": "ACTIVE"
    },
    {
      "parameter_name": "PARCELAS ANUIDADE",
      "value": 0,
      "status": "ACTIVE"
    },
    {
      "parameter_name": "PERCENTUAL LIMITE SAQUE",
      "value": 1,
      "status": "ACTIVE"
    },
    {
      "parameter_name": "NUMERO MESES EXPIRACAO CARTAO",
      "value": 60,
      "status": "ACTIVE"
    },
    {
      "parameter_name": "IOF DIARIO",
      "value": 0.0082,
      "status": "ACTIVE"
    },
    {
      "parameter_name": "IOF FIXO",
      "value": 0.38,
      "status": "ACTIVE"
    },
    {
      "parameter_name": "TAMANHO MAX NOME EMBOSSADO",
      "value": 25,
      "status": "ACTIVE"
    },
    {
      "parameter_name": "ACCRUAL_PROJECTION_STRATEGY",
      "value": 0,
      "status": "ACTIVE"
    },
    {
      "parameter_name": "DIAS ANTECEDENCIA CORTE",
      "value": 10,
      "status": "ACTIVE"
    },
    {
      "parameter_name": "TENTATIVAS SENHA ERRADA",
      "value": 3,
      "status": "ACTIVE"
    },
    {
      "parameter_name": "DIAS ATRASO BLOQUEIO CONTA",
      "value": 10,
      "status": "ACTIVE"
    },
    {
      "parameter_name": "STOP ACCRUAL",
      "value": 63,
      "status": "ACTIVE"
    },
    {
      "parameter_name": "IOF INTERNACIONAL",
      "value": 6.38,
      "status": "ACTIVE"
    },
    {
      "parameter_name": "ATC MIN OFFSET",
      "value": 5,
      "status": "ACTIVE"
    },
    {
      "parameter_name": "ATC MAX OFFSET",
      "value": 15,
      "status": "ACTIVE"
    },
    {
      "parameter_name": "ACCRUAL RATE DISCOUNT",
      "value": 0,
      "status": "ACTIVE"
    },
    {
      "parameter_name": "IOF_FIRST_DAY",
      "value": 0,
      "status": "ACTIVE"
    },
    {
      "parameter_name": "CONTROLE DE TROCA DE VENCIMENTOS",
      "value": 1,
      "status": "ACTIVE"
    },
    {
      "parameter_name": "LIMITE GLOBAL MAXIMO",
      "value": 1000,
      "status": "ACTIVE"
    },
    {
      "parameter_name": "LIMITE GLOBAL MINIMO",
      "value": 0,
      "status": "ACTIVE"
    },
    {
      "parameter_name": "SKIP_RENEW_TEMPORARY_CARD",
      "value": 0,
      "status": "ACTIVE"
    },
    {
      "parameter_name": "NON_BUSINESS_DAYS",
      "value": 67,
      "status": "ACTIVE"
    },
    {
      "parameter_name": "OVERLIMIT_FEE_AMOUNT",
      "value": 0,
      "status": "ACTIVE"
    },
    {
      "parameter_name": "ACCEPT_MULTIPLE_PLASTIC_CARDS",
      "value": 0,
      "status": "ACTIVE"
    },
    {
      "parameter_name": "ACCRUAL_PROJECTION_REVERSAL",
      "value": 0,
      "status": "ACTIVE"
    },
    {
      "parameter_name": "ACCRUAL_CALC_STRATEGY",
      "value": 0,
      "status": "ACTIVE"
    },
    {
      "parameter_name": "MIN_PAYMENT_CALC_STRATEGY",
      "value": 0,
      "status": "ACTIVE"
    },
    {
      "parameter_name": "MINIMO BOLETO",
      "value": 0,
      "status": "ACTIVE"
    },
    {
      "parameter_name": "OVERDUE_ACCRUAL_CALC_STRATEGY",
      "value": 0,
      "status": "ACTIVE"
    },
    {
      "parameter_name": "DELINQUENCY_BUCKET_CALC_STRATEGY",
      "value": 0,
      "status": "ACTIVE"
    },
    {
      "parameter_name": "ALLOW_ACCOUNTS_CREATION",
      "value": 1,
      "status": "ACTIVE"
    },
    {
      "parameter_name": "GRACE_PERIOD_ADDITIONAL_NR_OF_DAYS",
      "value": 0,
      "status": "ACTIVE"
    },
    {
      "parameter_name": "ACCRUALS_REVERSAL_STRATEGY",
      "value": 0,
      "status": "ACTIVE"
    },
    {
      "parameter_name": "LATE_PAYMENT_FEE",
      "value": 0,
      "status": "ACTIVE"
    },
    {
      "parameter_name": "OVERLIMIT_PERCENTAGE",
      "valid_from": "2023-05-24T14:32:20Z",
      "value": 0,
      "account_parameter": true,
      "status": "ACTIVE"
    }
  ],
  "transactions_categories": [
    {
      "transaction_category_id": 114121,
      "transaction_category_description": "Trans Nao Financiaveis",
      "refinancing_rate_before_due_date": 0,
      "refinancing_rate_after_due_date": 0,
      "default_rate": 0,
      "fine_rate": 0,
      "overdue_rate_after_due_date": 0,
      "minimum_value": 0,
      "charge_order": 0
    },
    {
      "transaction_category_id": 114122,
      "transaction_category_description": "Trans Financiaveis",
      "refinancing_rate_before_due_date": 0,
      "refinancing_rate_after_due_date": 0,
      "default_rate": 0,
      "fine_rate": 0,
      "overdue_rate_after_due_date": 0,
      "minimum_value": 0,
      "charge_order": 0
    },
    {
      "transaction_category_id": 114123,
      "transaction_category_description": "Internas",
      "refinancing_rate_before_due_date": 0,
      "refinancing_rate_after_due_date": 0,
      "default_rate": 0,
      "fine_rate": 0,
      "overdue_rate_after_due_date": 0,
      "minimum_value": 0,
      "charge_order": 0
    }
  ],
  "programs_transactions_types": [
    {
      "transaction_type_id": 101,
      "transaction_category": "Trans Financiaveis",
      "description": "COMPRA A VISTA"
    },
    {
      "transaction_type_id": 102,
      "transaction_category": "Trans Financiaveis",
      "description": "COMPRA INTERNACIONAL"
    },
    {
      "transaction_type_id": 111,
      "transaction_category": "Trans Financiaveis",
      "description": "PARCELADO SEM JUROS"
    },
    {
      "transaction_type_id": 112,
      "transaction_category": "Trans Financiaveis",
      "description": "PARCELA SEM JUROS"
    },
    {
      "transaction_type_id": 123,
      "transaction_category": "Trans Financiaveis",
      "description": "SAQUE"
    },
    {
      "transaction_type_id": 124,
      "transaction_category": "Trans Financiaveis",
      "description": "SAQUE INTERNACIONAL"
    },
    {
      "transaction_type_id": 201,
      "transaction_category": "Internas",
      "description": "PAGAMENTO"
    },
    {
      "transaction_type_id": 203,
      "transaction_category": "Internas",
      "description": "VOUCHER DE CREDITO"
    },
    {
      "transaction_type_id": 301,
      "transaction_category": "Internas",
      "description": "AJUSTE A CREDITO"
    },
    {
      "transaction_type_id": 302,
      "transaction_category": "Trans Financiaveis",
      "description": "AJUSTE A DEBITO"
    },
    {
      "transaction_type_id": 401,
      "transaction_category": "Trans Nao Financiaveis",
      "description": "ENCARGOS REFINANCIAMENTO"
    },
    {
      "transaction_type_id": 402,
      "transaction_category": "Trans Nao Financiaveis",
      "description": "JUROS DE MORA"
    },
    {
      "transaction_type_id": 403,
      "transaction_category": "Trans Nao Financiaveis",
      "description": "MULTA"
    },
    {
      "transaction_type_id": 404,
      "transaction_category": "Trans Nao Financiaveis",
      "description": "IOF INTERNACIONAL"
    },
    {
      "transaction_type_id": 405,
      "transaction_category": "Trans Nao Financiaveis",
      "description": "IOF"
    },
    {
      "transaction_type_id": 406,
      "transaction_category": "Trans Nao Financiaveis",
      "description": "IOF SAQUE"
    },
    {
      "transaction_type_id": 407,
      "transaction_category": "Trans Financiaveis",
      "description": "ENCARGOS SAQUE"
    },
    {
      "transaction_type_id": 408,
      "transaction_category": "Trans Nao Financiaveis",
      "description": "DEBITO DIF CAMBIAL"
    },
    {
      "transaction_type_id": 409,
      "transaction_category": "Trans Nao Financiaveis",
      "description": "CREDITO DIF CAMBIAL"
    },
    {
      "transaction_type_id": 417,
      "transaction_category": "Trans Nao Financiaveis",
      "description": "IOF PARCELAMENTO"
    },
    {
      "transaction_type_id": 451,
      "transaction_category": "Internas",
      "description": "ESTORNO ENCARGOS REFINANC"
    },
    {
      "transaction_type_id": 452,
      "transaction_category": "Internas",
      "description": "ESTORNO JUROS DE MORA"
    },
    {
      "transaction_type_id": 453,
      "transaction_category": "Internas",
      "description": "ESTORNO MULTA"
    },
    {
      "transaction_type_id": 455,
      "transaction_category": "Internas",
      "description": "ESTORNO IOF"
    },
    {
      "transaction_type_id": 503,
      "transaction_category": "Internas",
      "description": "CANC DE COMPRA"
    },
    {
      "transaction_type_id": 504,
      "transaction_category": "Internas",
      "description": "CANC PARCELADO SEM JUROS"
    },
    {
      "transaction_type_id": 505,
      "transaction_category": "Internas",
      "description": "CANC PARCELA SEM JUROS"
    },
    {
      "transaction_type_id": 508,
      "transaction_category": "Internas",
      "description": "CANC COMPRA INTERNACIONAL"
    },
    {
      "transaction_type_id": 509,
      "transaction_category": "Internas",
      "description": "CANC IOF INTERNACIONAL"
    },
    {
      "transaction_type_id": 512,
      "transaction_category": "Trans Nao Financiaveis",
      "description": "ESTORNO SAQUE"
    },
    {
      "transaction_type_id": 513,
      "transaction_category": "Trans Nao Financiaveis",
      "description": "ESTORNO ENCARGOS SAQUE"
    },
    {
      "transaction_type_id": 602,
      "transaction_category": "Trans Nao Financiaveis",
      "description": "ANUIDADE"
    },
    {
      "transaction_type_id": 604,
      "transaction_category": "Trans Financiaveis",
      "description": "TARIFA SAQUE"
    },
    {
      "transaction_type_id": 606,
      "transaction_category": "Internas",
      "description": "ESTORNO DE ANUIDADE"
    },
    {
      "transaction_type_id": 617,
      "transaction_category": "Internas",
      "description": "ESTORNO TARIFA SAQUE INTER"
    },
    {
      "transaction_type_id": 676,
      "transaction_category": "Trans Financiaveis",
      "description": "OVERLIMIT FEE"
    },
    {
      "transaction_type_id": 701,
      "transaction_category": "Internas",
      "description": "CREDITO POR PARCELAMENTO"
    },
    {
      "transaction_type_id": 702,
      "transaction_category": "Trans Financiaveis",
      "description": "PARCELA DE REFINANCIAMENTO"
    },
    {
      "transaction_type_id": 703,
      "transaction_category": "Internas",
      "description": "CONTRATO REFINANCIAMENTO"
    },
    {
      "transaction_type_id": 704,
      "transaction_category": "Internas",
      "description": "CANC PARCELA REFINANC"
    },
    {
      "transaction_type_id": 705,
      "transaction_category": "Trans Nao Financiaveis",
      "description": "CANC CREDITO PARCELAMENTO"
    },
    {
      "transaction_type_id": 706,
      "transaction_category": "Internas",
      "description": "CANC CONTRATO REFINANC"
    },
    {
      "transaction_type_id": 711,
      "transaction_category": "Internas",
      "description": "CREDITO POR ACORDO"
    },
    {
      "transaction_type_id": 712,
      "transaction_category": "Trans Nao Financiaveis",
      "description": "PARCELA DE ACORDO"
    },
    {
      "transaction_type_id": 713,
      "transaction_category": "Internas",
      "description": "CONTRATO DE ACORDO"
    },
    {
      "transaction_type_id": 714,
      "transaction_category": "Internas",
      "description": "CANC PARCELA ACORDO"
    },
    {
      "transaction_type_id": 715,
      "transaction_category": "Trans Nao Financiaveis",
      "description": "CANC CREDITO ACORDO"
    },
    {
      "transaction_type_id": 716,
      "transaction_category": "Internas",
      "description": "CANCELAMENTO CONTRATO ACORDO"
    },
    {
      "transaction_type_id": 721,
      "transaction_category": "Internas",
      "description": "CREDITO POR PARCELAMENTO CP"
    },
    {
      "transaction_type_id": 722,
      "transaction_category": "Trans Nao Financiaveis",
      "description": "PARCELA DE REFINANCIAMENTO CP"
    },
    {
      "transaction_type_id": 723,
      "transaction_category": "Internas",
      "description": "CONTRATO REFINANCIAMENTO CP"
    },
    {
      "transaction_type_id": 724,
      "transaction_category": "Internas",
      "description": "CANC PARC DE REF CP"
    },
    {
      "transaction_type_id": 725,
      "transaction_category": "Trans Nao Financiaveis",
      "description": "CANC CREDITO PARCELAMENTO CP"
    },
    {
      "transaction_type_id": 726,
      "transaction_category": "Internas",
      "description": "CANC CONTRATO REF CP"
    },
    {
      "transaction_type_id": 4089,
      "transaction_category": "Internas",
      "description": "ESTORNO DEBITO DIF CAMBIAL"
    },
    {
      "transaction_type_id": 4099,
      "transaction_category": "Trans Financiaveis",
      "description": "ESTORNO CREDITO DIF CAMBIAL"
    },
    {
      "transaction_type_id": 4519,
      "transaction_category": "Trans Financiaveis",
      "description": "CANC ESTORNO ENCARGOS REFINANC"
    },
    {
      "transaction_type_id": 4529,
      "transaction_category": "Trans Financiaveis",
      "description": "CANC ESTORNO JUROS DE MORA"
    },
    {
      "transaction_type_id": 4539,
      "transaction_category": "Trans Financiaveis",
      "description": "CANC ESTORNO MULTA"
    },
    {
      "transaction_type_id": 4559,
      "transaction_category": "Trans Financiaveis",
      "description": "CANC ESTORNO IOF"
    },
    {
      "transaction_type_id": 6769,
      "transaction_category": "Internas",
      "description": "OVERLIMIT FEE REVERSAL"
    },
    {
      "transaction_type_id": 9467,
      "transaction_category": "Trans Nao Financiaveis",
      "description": "ESTORNO TARIFA SAQUE"
    },
    {
      "transaction_type_id": 9469,
      "transaction_category": "Trans Nao Financiaveis",
      "description": "ESTORNO IOF SAQUE"
    },
    {
      "transaction_type_id": 40899,
      "transaction_category": "Trans Financiaveis",
      "description": "CANC EST DEBITO DIF CAMBIAL"
    },
    {
      "transaction_type_id": 40999,
      "transaction_category": "Internas",
      "description": "CANC EST CREDITO DIF CAMBIAL"
    },
    {
      "transaction_type_id": 45359,
      "description": "dfdsff"
    },
    {
      "transaction_type_id": 45565,
      "description": "tt teste 455"
    },
    {
      "transaction_type_id": 45566,
      "description": "Canc tt teste 455"
    },
    {
      "transaction_type_id": 67699,
      "transaction_category": "Internas",
      "description": "OVERLIMIT FEE REV CANC"
    },
    {
      "transaction_type_id": 99602,
      "transaction_category": "Trans Nao Financiaveis",
      "description": "CANC ESTORNO ANUIDADE"
    }
  ],
  "network_acceptances": [
    {
      "processing_code": "00",
      "credit_limit_impact_id": 1,
      "credit_limit_impact_description": "COMPRA GLOBAL",
      "impact_only_conciliation": 0
    },
    {
      "processing_code": "0001",
      "credit_limit_impact_id": 4,
      "credit_limit_impact_description": "PAGAMENTO",
      "impact_only_conciliation": 0
    },
    {
      "processing_code": "0101",
      "credit_limit_impact_id": 4,
      "credit_limit_impact_description": "PAGAMENTO",
      "impact_only_conciliation": 0
    },
    {
      "processing_code": "01",
      "credit_limit_impact_id": 2,
      "credit_limit_impact_description": "SAQUE CREDITO",
      "impact_only_conciliation": 0
    },
    {
      "processing_code": "20",
      "credit_limit_impact_id": 4,
      "credit_limit_impact_description": "PAGAMENTO",
      "impact_only_conciliation": 1
    },
    {
      "processing_code": "203100",
      "credit_limit_impact_id": 4,
      "credit_limit_impact_description": "PAGAMENTO",
      "impact_only_conciliation": 1
    },
    {
      "processing_code": "003101",
      "credit_limit_impact_id": 4,
      "credit_limit_impact_description": "PAGAMENTO",
      "impact_only_conciliation": 0
    },
    {
      "processing_code": "003100",
      "credit_limit_impact_id": 1,
      "credit_limit_impact_description": "COMPRA GLOBAL",
      "impact_only_conciliation": 0
    },
    {
      "processing_code": "003801",
      "credit_limit_impact_id": 4,
      "credit_limit_impact_description": "PAGAMENTO",
      "impact_only_conciliation": 0
    },
    {
      "processing_code": "003800",
      "credit_limit_impact_id": 1,
      "credit_limit_impact_description": "COMPRA GLOBAL",
      "impact_only_conciliation": 0
    },
    {
      "processing_code": "004000",
      "credit_limit_impact_id": 4,
      "credit_limit_impact_description": "PAGAMENTO",
      "impact_only_conciliation": 0
    },
    {
      "processing_code": "013101",
      "credit_limit_impact_id": 4,
      "credit_limit_impact_description": "PAGAMENTO",
      "impact_only_conciliation": 0
    },
    {
      "processing_code": "013100",
      "credit_limit_impact_id": 1,
      "credit_limit_impact_description": "COMPRA GLOBAL",
      "impact_only_conciliation": 0
    }
  ]

}

Updated 6 days ago