Simulation is a Pismo calculation service that allows you to simulate financial scenarios before any actual impact occurs on an account, credit limit, authorization, or accounting records. It is primarily used to simulate installment plans, interest, fees, and future values, returning payment options so you can choose the best alternative.

The Pismo Integrated Service Solution allows you to use our structure without the need for a long development period and major changes to your environment. Pismo offers a complete and personalized experience, with technology and precision, where parameterization occurs quickly and fluidly. The simulation solution is system agnostic, enabling various payment methods, increasing convenience and control.

Pismo provides the following simulation model endpoints for creating simulation parameters to specific types of financial flows:

• Create simulation config
• Attach simulation config (to organization, program, or account)
• Get simulation config

Simulation features

Simulation features include:

• Price table—Calculations are performed using the price method. This is a Brazil-specific calculation method and it includes:
  • Fixed interest—The same interest will be applied to all installments.
  • Dynamic interest—Interest will be applied dynamically according to the rule applied in the configuration.
  • Public fees—In Brazil, for example, the IOF and IOF Aliquot.
• Filters—Every fee you define for a simulation is given a plan_id that distinguishes it from other fees. It is not necessary to call all plan_ids individually, you can create filters for a selection of plans (fees), including processing codes, merchants, and custom filters. This allows you to create a group of simulations for a specific audience (for example, customers in the southern states).
• Skip periods—You can specify periods to skip. For example, start paying in 90 days or skip a payment in December.
• Minimum installment—Define that every installment must have a minimum value set. For example, minimum of $100.00.
• Interest limitation—Set a limit on the interest applied. For example, in Brazil, the government limits the interest rate to up to 100 percent of the original debt. In that case, principal_amount: $100.00, maximum interest applied: $100.00 (100%).
• Custom filters—Use the custom filter to create a group of simulations for a specific audience. For example, you can create simulations geared toward a specific region or state, or specific to students.

Downpayment methods

The simulation offers different downpayment methods:

• Percentage—A percentage is generated based on what you want to apply to the total contract value. The first installment will be issued on D+0. Example: 30% of R$1,000.00 = The down payment will be R$300.00.

• Installment equivalent—All installments are divided equally, assuming the first installment will be issued on D+0. To use this method, the simulation must be created after the payment cutoff date, and the payment will be made at the next invoice cutoff date. Example: R$1,000.00 contract = 10 installments of R$100.00.

• Already done—This is used when the consumer has already made part of the payment as a down payment.
  Example: Contract for $1,000.00; down payment made: $200.00; the simulation will consider the difference in values, that is, $800.00. Down payment: $200.00 + 10 X $80.00.

  Note: If the first installment needs to be in the next cut, the installment input information will not be necessary in the plan_id configuration.

Testing the fee model

To test network transactions scenarios, you can create and attach your feel model, then use the Simulate authorization endpoint.

To test payments scenarios, you can create and attach your feel model, then use the Request authorization endpoint.

For full details, refer to the Simulate authorizations guide.