Webitel: Documentation

Plata by mono

1. Description

Component for integration with MonoPay.

This component is present in flow types like:

  • Voice;

  • Chat;

  • Forms;

  • Service.

The block (Fig.1(1)) is used in space to build the Flow. The settings panel for this component opens (Fig.1(2)) when you click on the block.

Plata by mono.png

Fig.1. Plata by mono component

1.1. Plata by mono block

The block consists of the following elements:

  1. The name of the component;

  2. In branch — receiving (connecting with the previous block) branch;

  3. Out branch — outgoing (connecting with the following block) branch. When hovering over the Out field, a switch appears. The switch allows this component to be connected to a component that already has a connection.

The presence of an Screenshot 2024-11-07 154742.png icon indicates that the switch is on, and this component can be connected to a component that already has a connection.

Changing the switch position removes the outgoing branch of this component.

The Screenshot 2024-11-07 155145.png button deletes the block from the Flow Schema.

1.2. Plata by mono settings panel

It consists of the following elements:

  1. Token;

  2. Action;

  3. Break;

  4. Limit;

  5. Add description.

1.2.1. Token

Required field.

This is where the token is entered. The token is taken on the Monobank side.

1.2.2. Action

Required field.

This field is used to select an action. The following options are available:

  1. сreate;

  2. cancel;

  3. remove;

  4. status;

  5. payment_info.

1.2.2.1. Create

Create a payment.

When you select create, the following fields are available:

  • Amount - the payment amount in minimum units (if its a dollar - cent). Required field;

  • CCY - currency code;

  • Payment Type - type of operation. For the hold value, the term is nine days. If, after nine days, the hold is not finalized, it is canceled. Required field;

  • Redirect URL - return address (GET) - the user will be redirected to this address after completing the payment (in case of success or error);

  •  Validity - the validity period payment is in seconds;

  • Set variable - a variable in which the response is written. Required field.

1.2.2.2. Cancel

Cancellation of payment.

When you select cancel, the following fields are available:

  • Invoice Id - ID payment; Required field;

  • ExtRef - reference of the cancellation operation, determined by the seller;

  • Amount - the amount in minimum units (for a partial refund);

  • Set variable - a variable in which the response is written. Required field.

1.2.2.3. Remove

Invalidation of an account if no payment has been made for it yet.

When you select remove, the following fields are available:

  • Invoice Id - ID payment; Required field.

1.2.2.4. Status

Checking the status of the payment.

When you select status, the following fields are available:

  • Invoice Id - ID payment; Required field;

  • Set variable - a variable in which the response is written. Required field.

1.2.2.5. Payment_info

Information about successful payment, if it was made.

When you select payment_info, the following fields are available:

  • Invoice Id - ID payment; Required field;

  • Set variable - a variable in which the response is written. Required field.

The structure of the responses passed to the variable is consistent with their documentation. More information can be found here.

1.2.3. Break

Responsible for the completion of the flow execution.

  • image-20250627-120834.png — initiates the end of the flow execution after the given component.

  • image-20250627-120816.png — the switch is in the off position.

1.2.4. Limit

It is intended to determine the maximum number of passes through this component.

The failover branch appears in the edited component when the limit is set image2024-1-26_12-1-12.png .

The failover branch will be used if more passes are passed through the component than entered in the Max field.

Clicking on the Add Limit button adds a Max field and a Delete limit button.

The number of possible passes is indicated in the Max field.

Clicking on the Delete limit button removes the limit and returns the Add limit button.

Limit.png


Fig. 2. Setting a limit

1.2.5. Add description

When you click the Add description button, a Description field and a Delete description button will be added.

The Description field is used to add comments to the component.

Clicking the Delete description button removes the description field and brings back the Add description button.

Description.png

Fig. 3. Add description