Monitoring and performing payments

Dashboard allows users to:

• Create, send, and deactivate payment links in order to process one-time purchases and register regular COF purchases (if necessary). General description of the payment link purchase workflow and possible statuses can be found in the corresponding article.
• Take MO/TO (Mail Order / Telephone Order) payments using a payment form when the customer provides payment card details over the phone, by email, or other means of communication. MO/TO payments are processed as one-time purchases according to the workflow. Certain restrictions may apply.
• Manage authorisation holds as part of executing two-step purchases. Held funds can be captured or released with the use of individual and batch requests. General description of the two-step purchase workflow and possible statuses can be found in the corresponding article.

To perform purchases by using Dashboard, the following requirements must be met:

• Two-factor authentication is required for accessing Dashboard in order to take MO/TO payments.
• The user account must be granted the appropriate permissions. Each action, including capturing held funds and releasing authorisation holds, requires a specific permission.
• Required actions are supported for the selected project and the payment method.

If any issues regarding access rights occur, they can be solved with the merchant's specialists.

To take a MO/TO payment:

1. Go to the MO/TO (vPOS terminal) tab.

   Go to Manual payments, click Request on the left of the filtering panel, and switch to the MO/TO (vPOS terminal) tab.

2. Specify payment parameters and send the request to open the payment form by filling in the fields and clicking Pay.

   When filling in the fields, keep in mind that:

   • The payment ID must be unique for the specified project.
   • The amount is entered as a decimal number with a point to separate fractional part (for example, 314.15).
   • The Pay button is enabled when all required parameters have been specified.

   

3. In the payment form specify the required data and confirm the payment by filling in the fields in the payment form that opened and click the Pay button.

   If the field Country is used, enter the country code in accordance with ISO 3166-1 alpha-2. The list of country codes can be found in Country codes).

   

4. Make sure that the payment has been processed.

   You can do this by checking the status of this payment in the payments list—it should state success.

   If the payment has been declined, its status switches to decline. The decline can happen due to a variety of reasons. For example, it can be caused by providing incorrect card details, in which case you should initiate another payment with a new payment ID while making sure that the card details are specified correctly.

1. Go to the MO/TO (vPOS terminal) tab by clicking Request in the Manual payments section.
2. Specify payment parameters and send the request to open the payment form by clicking Pay.
3. In the payment form specify the required data and confirm the payment by clicking Pay.

   If the field Country is used, enter the country code in accordance with ISO 3166-1 alpha-2. The list of country codes can be found in Country codes).

4. Make sure that the payment has been processed by checking its status—it should state success.

To initiate debiting of the authorised amount (cancel authorisation hold) as part of executing an individual two-step purchase:

1. If necessary, locate the purchase that requires debiting (release) of the authorised amount.

   You can use the Search function (search by payment ID, for example) or go to the Payments section and apply necessary filters in the lists (for example, filter by operation type—auth, or by payment status—awaiting capture).

2. Open the payment information tab for the target purchase.

   Click the corresponding row in the list of the Payments section.

3. Send a capture (cancel) request.
   1. Click the Capture button located on the payment management panel (at the top left of the payment information tab) to initiate the debiting of the authorised amount (click the Cancel button to release the authorisation hold).

      

   2. In the window that opens, specify the required amount, which can be the entire authorised amount or its part.

      When changing the authorised amount, keep in mind that this capability is not universally supported (due to regional specifics or other reasons) and that certain restrictions are imposed by payment systems (to learn more, see Request for partial debit or release of authorised amount).

   3. Confirm your request by clicking Capture (Cancel).
      Note: If buttons Capture and Cancel remain inactive, it may mean that one of these operations is already being processed. If these buttons are absent, it may mean that performing such operations is not allowed for the payment.
4. Make sure that the capture (cancel) operation has been processed.

   You can do this by checking the status of this operation in the tab with the detailed information about the target purchase. You can also check the status of this purchase in the payments list. The status of the operation (capture or cancel) should state success, while the status of the purchase should state success if the held funds were captured and cancelled—if the hold on funds was released.

1. Open the payment information tab of the target purchase in the Payments section.
2. Click the Capture (Cancel) button on the payment management panel to send a capture (cancel) request.
3. In the window that opens, specify the required amount (in full or its part) and confirm the request by clicking Capture (Cancel).
4. Make sure that the capture (cancel) operation has been processed by checking its status.

   The status of the operation (capture or cancel) should state success while the status of the purchase should state success if the held funds were captured and cancelled—if the hold was released.

If the operation request has been declined, its status switches to decline while the payment status remains awaiting capture.

To perform capture or cancel operations using a batch request:

1. Create and prepare the file with the capture (cancel) operations data in the specified format.

   You can find the file requirements with the template and a file sample below.

   Restriction: When preparing the file, keep in mind that it must contain operations of only one type—either capture or cancel, while both the entire authorised amounts and the partial amounts can be specified as the amounts to capture (cancel). It is important to remember that changing the authorised amount is not universally supported (due to regional specifics or other reasons) and that certain restrictions are imposed by payment systems (to learn more, see Request for partial debit or release of authorised amount).
2. Go to Mass Captures (Mass Cancels).

   Go to Manual payments, click Request on the left of the filtering panel, and switch to the Mass Captures (Mass Cancels) tab.

3. Upload the file with the list of operations and check it for data consistency.

   Drag the file or use the Browse button to upload.

   Following the validity check, either the Send request button is enabled, or the error message is shown. In the latter case, you can view the details of the error (using the File preview toggle and then the File details button), correct the error and re-upload the file.

   

4. Send the batch request by clicking Send request.
5. Make sure the requests have been processed.

   You can monitor statuses and indicators of batch processing and statuses of individual operations.

   To monitor the state of batch processing in the list of mass requests, click Mass requests on the filtering panel in the Manual payments section, find the row of the batch you need in the list and check its status and indicator. Keep in mind that the time it takes to process operations and to update their status information can significantly vary depending on the number of operations in the batch. When the batch has been processed, its status should state Done.

   To check the status of individual operations, check the status of the payments that require performing capture or cancel operations in the payments list (they should have the status success when the authorised amount is debited or cancelled when the authorisation hold is released). You can also check the statuses of operations in the corresponding payment information tabs (they should state success or decline depending on the operation result).

1. Create and prepare the file with the capture (cancel) operations data in the specified format.

   You can find the file requirements with the template and a file sample below.

   Restriction: The file must contain operations of only one type—either capture or cancel, while both the entire authorised amounts and the partial amounts can be specified as the amounts to capture (cancel). To learn more, see details.
2. Go to Mass Captures (Mass Cancels) by clicking Request in the Manual payments.
3. Upload the file with the list of operations and check it for data consistency.
4. Send the batch request by clicking Send request.
5. Make sure the requests have been processed by checking statuses and indicators of batch processing and statuses of individual operations.

   Statuses of the individual capture or cancel operations should state success while statuses of the relevant payments should state success when the authorised amount is debited or cancelled when the authorisation hold is released.

Dashboard interface allows users to register regular COF purchases (subscriptions), monitor their processing, update subscription settings, and cancel debiting series of the registered COF purchases.

Regular purchase is a type of COF purchase initiated by the merchant with automatic debits on specific schedule and with the fixed charged amount. After the registration of the regular COF purchase in the payment platform, the information about it is shown in the Subscriptions list. The regular COF purchase can have the following statuses:

• Not set is assigned to regular COF purchases that do not have all of their settings specified, hence no automatic debits are executed.
• Active is assigned to activated regular COF purchases with automatic debits executed on schedule.
• Active is assigned to activated regular COF purchases with debiting terms already set and automatic debits executed on specified schedule.
• Cancelled is assigned to regular COF purchases with subsequent automatic debits cancelled.

In the Subscriptions section you can access payment information tabs with details of regular COF purchases. Each tab includes several panels including the payment management panel, the Recurring payment panel with the data of all regular COF purchase debits performed so far, and the Registration payment panel with information about the regular COF purchase registration. In this tab, you can also manage subscription settings, cancel subsequent debiting executed as part of the subscription, and view change history. The buttons for performing these actions become active on the payment management panel if you have the appropriate permissions. The step-by-step instructions are provided below.

In the Subscriptions section you can access payment information tabs with details of regular COF purchases. With the appropriate permissions you can view information about all operations performed as part of the regular COF purchase, manage subscription settings, and cancel subsequent debiting executed as part of the subscription.

Figure: Payment information tab with subscription details

The ecommpay payment platform allows you to register regular COF purchases with automatic debits in a variety of ways including when payments are processed via Payment Page (details) and Gate (details) and by migrating information about COF purchases and payment card tokens (details).

Along with that, Dashboard allows you to register regular COF purchases with the use of payment links by specifying additional information when you create them. This procedure is described above. When the customer clicks such payment link and completes the purchase, the regular COF purchase becomes activated and is assigned the Active status in the subscriptions list.

To specify or modify the debiting terms of the regular COF purchase (subscription):

1. Open the payment information tab of the subscription you need.

   You can use the Search function (search by payment ID, for example) or go to Subscriptions and use the registry and filters.

2. Open the Subscription settings window and switch to editing mode.

   Click Go to Settings in payment management panel and then click Edit in the bottom right corner of the window that opens.

3. Specify or modify target parameters of the regular COF purchase.

   Fill in the fields and click Save.

   When filling in the fields, keep in mind that:

   • If the regular COF purchase identifier was not provided at the time of registration (such payment has a Not set status in the registry), the Recurring payment ID field is required. If the identifier has been provided, this field is read only.
   • Fields to specify the debiting amount, period, and the date when the next debiting is supposed to occur are required. If at least one field is left empty, an attempt to save changes triggers an error notification.
   • The date when the next debiting is supposed to occur cannot precede the current date and cannot occur later than the expiration date of the regular COF purchase.
   • Fields Currency and Subscription end date are read only. The currency of the subscription is always the currency of the registration payment. If the last recurring date has not been specified in the regular COF purchase registration request, it is set to the expiry date of the payment instrument (for example, card) used to make this COF purchase.
   • Fields Every (for specifying the multiplicator to increase debiting period) and Description are optional.

   If you need to discard any unsaved changes to the subscription settings, click Cancel

   

4. Make sure that the changes have been saved.

   You can do this by clicking Settings History on the payment management panel: the registry of changes to subscription terms should contain a record of the update. In addition, the status of the regular COF purchase in the subscriptions list should change from Not set to Active.

1. Open the Subscription settings window in the subscription information tab and switch to editing mode by clicking Edit.
2. Specify or modify target parameters of the regular COF purchase and click Save.

   Keep in mind that fields Recurring payment ID (if it has been specified), Currency and Last recurring date are read only.

3. Make sure that the changes have been saved.

   Check if the Settings History registry contains a record of the update and the status of the regular COF purchase has changed from Not set to Active in the subscriptions list.

To cancel automatic debits executed as part of the regular COF purchase:

1. Open the payment information tab of the subscription you need.

   You can use the Search function (search by payment ID, for example) or go to Subscriptions and use the registry and filters.

2. Open the Subscription settings window and select cancelling the subscription.

   Click Go to Settings in payment management panel and then click Cancel Subscription in the top left corner of the window that opens.

3. Open the Subscription settings window and click Cancel Subscription.
4. Confirm cancellation in the pop-up window.
5. Make sure that the subscription has been cancelled by checking its status.

   Click Settings History on the payment management panel: the registry of changes to subscription terms should contain a record of the update. In addition, the status of the regular COF purchase in the subscriptions list should state Cancelled.

   

Dashboard interface allows users to perform payouts with the use of individual and batch requests. In both cases, the following requirements must be met:

• Two-factor authentication is enabled for the Dashboard user account in question.
• The user account has been granted the right to perform payouts.
• Payouts are supported for the selected payment method.
• The balance under which payouts are performed has enough funds.
• If additional data is required to perform a payout, it has to be provided within 22 hours.

If any issues regarding these requirements occur, they can be solved with the specialists in charge of granting access rights and working with balances.

In any payout type—either single payout or batch payout—you can issue one or more retries if the initial attempt is declined, for example because daily limit for payouts in the payment system is reached or the payment system services are unavailable. The payment platform can be set up to issue retries automatically after specific timeout, or technical support specialists can issue them manually. The number of retries is always limited. To enable retry functionality, contact your account manager at ecommpay; to set up retries number limit and delay between retries, contact technical support service (support@ecommpay.com).

Payment platform can be set up to issue retries of both single and batch payouts when the initial attempt is declined. To enable this functionality, contact your account manager; to set up—contact technical support.

To perform a single payout:

1. Go to the Single payout tab.

   Go to Manual payments, click Request on the left of the filtering panel and switch to the Single payout tab.

2. Specify payout parameters and send a payout request.

   Fill in the fields and click Send Request; if needed, enter the SMS verification code in the popup window.

   When filling in the fields, keep in mind that:

   • The amount is entered as a decimal number with a point to separate fractional part (for example, 314.15).
   • Fields for the payment method specific parameters are not available until the project, the amount, the currency, and the payment method have been specified.
   • Among the specific fields only the required ones are shown.
   • If the field is filled incorrectly, the error message "Specify payout parameters" is shown.
   • The Send Request button is enabled when all parameters have been specified correctly.

   

3. If additional payment information is required, specify the parameters needed (you can also decline the payment).

   When the payout is processed, its parameters are validated, following which a notification is displayed in the Single payout tab. If the parameters satisfy all requirements, the notification states that the request has been successfully processed. If certain parameters, which are not mandatory in general but can be required in a specific situation, are absent, fields where you can enter the required additional information are shown. In this case, to proceed with the payment, specify the information needed and click Proceed; to decline the payment, click Reject Payout.

   If for any reasons (to get more accurate information, for example) you need to pause and return to performing the payout later, you can find this payout in the payouts list using the Clarification filter and clicking the corresponding row.

   Restriction: By default, additional payment information has to be provided no later than 22 hours after the clarification request was received. However, certain payment systems may require additional information specified within shorter amounts of time. Contact technical support for more information about specific payment methods.

   

4. Make sure that the payout has been processed.

   Verify the status of this payout in the Payouts or Payments list—it should state success.

1. Go to the Single payout tab in the Manual payments section.
2. Specify payout parameters and send a payout request.
3. If additional payment information is required, specify the parameters needed (you can also decline the payment).

   If necessary, you can pause and return to performing payouts later. These payouts can be found in the payments or payouts list by using the Clarification filter.

4. Make sure that the payout has been processed by checking its status— it should state success.

If the payout is declined, the payment status switches to decline. It can happen due to a variety of reasons. For example, it can be caused by the lack of funds, in which case you can add funds to the balance and try to perform a payout again.

To prepare the file, you can use the template available for download on Dashboard or here. Having downloaded the template, you can fill it in any CSV file editor, for example, Microsoft Excel. Each file used for adding criteria in bulk must meet the following requirements:

• The data files must be uploaded in CSV format and the character encoding must be UTF-8 without BOM (Byte Order Mark string).
• The file size cannot exceed 128 MB.
• The first row must contain the names of parameters. The order of parameters can be random.
• The subsequent rows must contain values of target parameters. Specifying values for optional parameters is recommended but not required.
• All parameter values in the file must meet the requirements provided in the table below.
• If operation parameters are specified in strings (not in table format), parameter values in each row must be separated by a semicolon (";"). In addition, the fields without values are separated by semicolons in the same way as the fields with values, and two or more ";" characters can follow one another, for example:

  
  
  

  If you use Microsoft Excel to create and prepare the file, make sure that strings do not include incorrect separators or extra characters. You should use a different editor, for example Notepad, to check if extra characters have been added.

When adding data to files, you can use the parameters presented in the table below.

The following error messages can appear after the validity check of the file uploaded to Dashboard has been performed.