ecp-merchant-genesis-user-guide
ecp-merchant-genesis-user-guide
user guide
2.0 All sections are updated with relevant information. Emil Petkov 29/04/2015
2.1 Added new sections – TC40, SAFE, Interchange Emil Petkov 12/10/2015
Rejects, Front End Rejects and new APMs
2.2 Added new screenshots due to gateway UI redesign, Emil Petkov 11/08/2016
added new risk filters and sections
2.3 Added description for IRF Report Emil Petkov 18/11/2016
2.9 Added RPN Payout, Paycommerce, Neosurf, Klarna Emil Petkov 14/02/2018
Authorise, Klarna Capture, Klarna Refund and
Astropay Direct. Added Paycommerce Batches to the
Billing Section
3.0 Added Bancontact, QIWI, MyBank, GiroPay, Emil Petkov 16/04/2018
TrustPay, Zimpler, Safetypay, PayU, Instant Transfer,
Multibanco, iDEAL, EPS, Entercash, Pago 2ácil, PSE,
Rapipago, Link, Webpay, Carulla, Davivienda, Banco
de Chile, Surtimax, OXXO, Efecty, Argencard,
Naranja, Nativa, Cabal, Cencosud, Hipercard, Cartao
Mercado Livre, Elo, Aura, Astropay Card, Banamex,
Itau, Bradesco, Tarjeta Shopping, BBVA Bancomer,
Boleto Bancario, Redpagos, Santander, Santander
Cash, Baloto, EDEQ, Banco de Occidente, Banco do
Brasil.
3.1 Added new screenshots due to Gateway UI redesign. Emil Petkov 18/06/2018
Remove the Paybyvoucher yeepay payment method.
Change the name of Klarna Authorise to only Klarna.
3.2 Add Contract MCC based search criteria in the Emil Petkov 26/09/2018
Payment Transaction. Remove the Citadel Payin and
Citadel Payout payment methods.
3.3 Added Pay by link section under Virtual Terminal, Emil Petkov 11/04/2019
Updated Merchants Configuration section, Added
Consumers section, Updated payment transactions
3.4 New APMs and Transaction types have been added – Dimo Dilov 17/07/2019
Tola Sale, Tola Payout, eZeeCard Payout, BitPay Sale,
BitPay Payout, BitPay Refund. TransferTo Payout,
Incremental Authorise, Partial Reversal
3.5 Added new Specific Business Attributes for applicable Dimo Dilov 23/07/2019
merchants
3.6 New parameter for Virtual Terminal for Payout and Dimo Dilov 29/07/2019
Credit transactions has been implemented. Added new
search filter for payment transactions under specific
gateway
3.7 Updated Partial Reversal description, added FX Logs Dimo Dilov 12/08/2019
section to Payment Transactions
3.9 Added Email Templates configuration for Pay by link Dimo Dilov 17/09/2019
feature
4.0 Added description of the channels to send a Pay by Dimo Dilov 03/10/2019
link
4.1 Added description Email templates for Pay by link Dimo Dilov 24/10/2019
functionality. Fixed description of Blacklists and
Whitelists.
4.2 Added description of Card present new menus for ECP Dimo Dilov 13/11/2019
4.3 Added Token Sharing Group feature, removed Dimo Dilov 10/12/2019
Banamex and Entercash
4.4 New option “Supports Apple pay”, Update the Dimo Dilov 05/02/2020
Payment transaction section to reflect the new name of
the filter Transaction ID
4.5 New options to filter Stats and general improvements Dimo Dilov 28/03/2020
4.7 New Virtual Terminal UPI added, changed references Dimo Dilov 07/08/2020
to “Klarna” Virtual Terminal for “Invoice “and new
options and features to control the integration of the
merchants were added
4.8 Added new email configurations in merchants and Dimo Dilov 21/09/2020
terminals and new options for notifications
5.0 Added option Capture to the button Actions of a Dimo Dilov 27/01/2021
payment transaction
5.1 Added Issuing merchant configuration and the Dimo Dilov 04/03/2021
possibility to save custom payment transaction export
parameters
5.3 Extended WPF options to hide optional fields Dimo Dilov 26/05/2021
5.4 Additional WPF options to hide optional fields Dimo Dilov 21/07/2021
5.5 Additional Card Present options for AMEX and ECP Dimo Dilov 08/09/2021
acquirers, added new WPF option and removed
disabled transaction types
5.6 Introduced new configurations with Apple Pay and Amir 25/11/2021
new features for merchant users
Fasihani
6.0 Removed Trustpay from the list of virtual terminals. Alejandro 31/10/2022
Salazar
2. ANALYSIS ..................................................................................................................................... 25
3. CONFIGURATION ....................................................................................................................... 30
8. CONSUMERS ................................................................................................................................ 71
You will be provided with login credentials via email with further instructions and steps
you should follow. To log into Genesis, you need to have the following details:
• Username
• Password (to be configured by the user upon account activation)
• Dedicated URL for access to the Merchant Console of the Genesis gateway.
Open your browser and go to the URL provided in the activation email.
Enter your username and password in the relevant fields, then click on the button “Log
in”.
Note: Both, the username and the password are case sensitive and must be entered
exactly as provided/created.
Successful login
Depends on your access role, if you have authenticated successfully, you will be
redirected either to the Dashboard’s index page or directly to the Virtual Terminal
(lightweight merchant console) as shown below.
Failing to log in
If on the login attempt you have received an error message Login failed., this means that
you are mistaking either the username or the password. Make sure that you’re using the
correct username and password, if you are still unable to log in, please follow the
described steps to reset your password in section 1.3. Reset your password.
1.2. Preferences
The button Preferences is placed on the top right corner of your screen and there
are two options:
- Update user - if you want to change your password, please use this option. The
following page will open, where you will be prompted to enter your current
password and the new one:
- Customisable columns for the user. You can select specific columns to be
exported for the Payment Transactions.
*Note: User selected fields in the Custom Exports are now saved until changed by the
merchant and/or Genesis User and are not session related.
Currently, Genesis uses UTC as the default time zone. At this time, this preference
cannot be changed. The user must take this into account when performing any kind of
search.
Once you have entered the required information in the fields, please click on the button
Submit.
An email will be sent to the mailbox registered for that account containing one-time link
for password reset. When you click on it, the following page will open:
The following page will open where you will be prompted to enter your current password
and the new one:
The following requirements should be fulfilled when you set your password:
Due to security reasons, it is recommended to log out from the gateway when you have
finished with all your tasks.
The language of the application can be changed from the dropdown list placed in the top
right corner of the window. Once the desired language is chosen, all labels in the
application will be changed automatically.
Genesis dashboard provides visual charts, enabling quick insights into real-time data. It
gives you the ability to observe the daily volumes converted into a different currencies
such as USD, EUR, GBP etc., see the top five terminals and merchants based on the
processing volume passed through them, to check the processing health and the
chargeback/fraud ratios.
After successful login, on the left panel menu, navigate to the bottom of the menu and
click “Downloads”.
• The API documentation can be found and downloaded from the main left menu
under “Downloads” at the very bottom of it. It is always automatically generated
and is the latest version of the API. This document is intended for technical
people.
• Online API Documentation contains Slate API Documentation and is accessible
online.
• The User Guide documentation can be found and downloaded from the main left
menu under “Downloads” at the very bottom of it. It is always automatically
generated and is the latest version of the User Guide. This document describes the
2. Analysis
With all the retail transactions being passed through the Genesis payment gateway, you
can view detailed reports, as well as graphs and charts of all transactions since the
account’s existence.
The Analysis tool provides the option to run the following types of reports: Custom
Chart, All Channels Report and Invoices. For ‘All Terminal Report’, ‘Stats’, ‘IRF
Report’ and ‘Invoice’, reports can also be exported to CSV and Excel files.
You need to select the required field and choose from the following options: Show graph,
Show deltas.
You need to select the required fields and click on “Generate CSV” or “Generate Excel”:
Also, you have the following predefined options to retrieve reports that you can choose to
automatically generate and export these:
2.3. Stats
In this section, you can retrieve statistical reports for merchant terminals and MIDs, and
thereafter export these into CSV or Excel file formats.
Stats by Terminal
You need to select a date range and a merchant. If you choose the option “Split per card
brand”, it will split the volume reports per card brand. If you choose the option “Only
processing”, it will split reports per processing volume of terminals. Once you retrieve
the data, you can export it in CSV or Excel file formats and preview it in a chart. You
will see the volume and the ratios separated per terminal.
- “Split per card brand” will split the volume reports per card brands.
- “Only processing” will split reports per processing volume of MIDs.
- “Split by currency” will split the volume reports per currencies.
Once you retrieve the data, you can export it in CSV or Excel file formats and preview it
in a chart. You will see the volume and the ratios separated per MIDs.
In this section, you can generate invoices for terminals, MIDs and merchants, and
thereafter export these into CSV or Excel file formats.
Invoice by Terminal
You need to select the terminal, month, and week, or choose Custom Date Range. Then,
you can generate a CSV or Excel file by clicking on the relevant buttons.
Invoice by MID
Invoice by Merchant
You need to select the Merchant, month, and week, or choose Custom Date Range. Then,
you can generate a CSV or Excel file by clicking on the relevant buttons.
From this tab, you can find and download any CSV or Excel exports you have made
previously, so you do not have to re-generate and export them again.
3. Configuration
To set up merchant and associated MIDs we can use the Merchant Configuration tool as
described below. In order to reach the Configuration tab, you need to log in as a merchant
user by using the merchant URL with the right administrative privileges and simply
clicking on the Configuration tab.
3.1. Merchants
The Merchants tab provides a view of the merchant that the admin is assigned to:
If we want to see what details our merchant contains, we can click on the “Actions”
button ( ) and then on the “View Details” button ( ), where all the
information for the particular merchant will be shown.
If we want to see what details a particular terminal contains, we can click on the
“Actions” button ( ) and then on the “View Details” button ( ).
Here we can see information such as Terminal Token, Supported Features, Supported
Transaction types, Filters, API Access details, and even the Decline Reasons for the last
month for this terminal.
In order to have an active Mailer service for the merchant’s clients, you need to use
Email Configuration on Terminal Level.
You can select Type, Name and Recipients and Save your Email Configuration.
- Type: can be selected from the dropdown menu, they are grouped as
“TRANSACTION EMAILS”.
- Name: you can choose any names.
- Recipients: The recipients’ field can be configured in cases when a custom
recipient is required. If it is not configured, it will send the mail to the
Merchant User.
Email Templates
Merchants have the option to use the default email templates or use the customisable
ones.
Clicking the button “Configure new Email Template” will open an editor that will allow
you to customise several aspects of the email:
• Subject
• Language
• Body
Once you enter the desired template subject and select the template language (the
language can be also set as the default one ), the body of the template can
be enhanced with the use of variables that will make it more dynamic by including
information related to the cardholder. The use of variables is optional, but they allow to
personalise the content by embedding the following information: First and Last name of
the cardholder, Address, Zip Code, State, Country, a link to the payment form that the
cardholder can open to finish the payment, the amount with currency and type of
transaction.
If no template is defined, the system will send a default one with a link for the cardholder
to go to the payment form and finalise the transaction.
Reminder Configuration
As soon as changes have been applied to the option Pay Later, its settings will appear in
the Merchant Details section on the right side of the page:
In order to have an active Mailer service, you need to use Email Configuration.
- Type: can be selected from the dropdown menu, they are grouped as
“TRANSACTION EMAILS”, “GENERAL EMAILS” and “REMINDER
EMAILS”.
- Name: you can choose any names.
- Recipients: The recipients’ field can be configured in cases when a custom
recipient is required. If it is not configured, it will send the mail to the
Merchant User.
Email Templates
Merchants have the option to use the default email templates or using the customisable
ones.
By editing any customisable emails, you will be able to Configure a new Email
Template.
Clicking the button “Configure new Email Template” will open an editor that will allow
you to customise several aspects of the email:
• Subject
• Language
• Body
language can be also set as the default one ), the body of the template can
be enhanced with the use of variables that will make it more dynamic by including
information related to the cardholder. The use of variables is optional, but they allow to
personalise the content by embedding the following information: First and Last name of
the cardholder, Address, Zip Code, State, Country, a link to the payment form that the
cardholder can open to finish the payment, the amount with currency and type of
transaction.
If no template is defined, the system will send a default one with a link for the cardholder
to go to the payment form and finalise the transaction.
• OpenSSL
• KeyTool
• Keychain Access (Mac only)
Instructions on how to generate the certificate can be found under each of the methods to
generate it after you click on the arrow icon ( ).
• Direct Registration
Allows the Merchant URL(s) to be entered and sent for validation through the Apple
Merchant Registration API.
The "Download Validation File" button calls the Merchant Registration API and once a
domain validation file is obtained in response, it is downloaded locally on the user's
machine.
The WPF (Web Payment Form) is a customisable component of Genesis and offers the
opportunity for numerous payment methods through a payment page facilitated by
Genesis.
If the Web Payment Form is enabled, you can select an existing WPF configuration.
When selected, it navigates to the Edit menu, containing the following parameters:
• Show WPF Fields - Provide the ability to select which of the following
options/fields to be displayed on the Web Payment Form.
• Logo – Add a custom merchant logo. The merchant account must have
Show merchant logo enabled.
• Terms & Conditions – The merchant can have their custom Terms and
Conditions. The merchant account must have Show merchant terms and
conditions enabled.
• Privacy Policy – dropdown menu from where optionally you can upload
Privacy Policy for the merchant. The merchant account must have Show
merchant privacy policy enabled.
The last introduced "Custom" option gives you choices for setting the colours of
the separate areas in the Web Payment Form.
In this way, the uploading of a .css file for approval becomes almost unnecessary.
• WPF Designer – allows merchants to customize the way the WPF form looks
▪ You can choose to customize:
- Colours and background – theme (light/dark), brand colour,
background colour, a choice to have a background image and upload
one, layout position
•
WPF Custom Footer text – allowing the merchant to provide a footer
with the wording they would like to be displayed in the form. The footer
text must be sent to Tech Support for configuration in the form.
From here, we can see the MID with the assigned terminals, which are the enabled
currencies, and the enabled card brands for the MIDs.
From this tab, you can find a particular transaction or a group of transactions by using
different search criteria:
• Merchant Transaction ID
• Unique ID
• Date range From – To: Searchable by year, month, days, hours, minutes and
seconds.
Once you have retrieved the information you are searching for, you have the option to
export it in CSV or Excel file formats.
• If you want to customise the export, you can click on the “Export Files” button (
) and select “Custom Export” ( ). The available columns to
export are: Status; Created At; Merchant name; Terminal; Type; Error class;
Merchant transaction ID; among others.
If you click on the Volumes for selection’s “Show” button the below table will be shown
where you can choose to view the information separated per currency (from the
dropdown list).
If you want to check if a particular payment transaction has been cleared successfully
with the 80byte can open it by clicking on the “Actions” button ( ) and then
clicking on the “View Details” button ( ) and see if there is a processed
transaction related to it. Also, once you open a transaction you can see all the processing
logs. You can refund ( ) or void ( ) a transaction directly
from here.
When opening the transaction details, the following new fields appear:
- Transaction Notes
- Log
- MID Reconciliation log
- FX Logs
- Risk Details
- Billing address
- Details
- Notification
- Additional Attributes
- Consumer
If you want to Capture only an Authorize/Authorize3D transaction directly from the menu, you
can do it by clicking the “Actions” ( ) button and then clicking on the button Capture (
). This will forward you to the Capture Transaction type form of the Virtual Terminal
with pre-populated values from the Authorize Transaction that you select for capturing.
Here you can find all processed (cleared) transactions with Omnipay. You can retrieve
the ARNs from here if requested by a merchant or internally.
• ARN
• Merchant
• Transaction date range From – To
• Filter - Reseller subtype
• ARN
• Merchant
• Reject Type
• Codes
• Transaction date range From – To
• Filter - Reseller subtype
• ARN
• Merchant
• Status
• Transaction date range From – To
• Filter - Reseller subtype
Here you can find different events that occurred for specific transactions, such as:
Chargebacks, Fraud reports, Retrieval requests, comments/notes, etc. You have the
following search options: “Date range”, “Merchants”, “Category”, “Priority and
“Reviewed”:
If you want to open the transaction for which is a note click on the “Actions” button (
From here, you can find which transactions have been processed slower than usual. You
need to choose the required fields and click on the “Search” button.
• Transaction ID
• Merchant
• Date range From – To
• By payment days
• You can also add additional search criteria: Reseller subtype, Acquirer, Card
Holder, Card No. (last four digits), Card Bin. (first six digits), Email, Type, and
Status, among others.
By using this tool, you can monitor for any issues that you might have with the
transactions posted to our gateway. If the Merchant and Terminal columns are empty,
this means that you have failed to authenticate via the API and therefore the request is
recorded without an owner.
Search options:
• Merchant
If you want to open a particular record to view the full information for it, click on the
From this tab, you can find and download any CSV or Excel exports you have previously
made, so you do not have to re-generate and export them again.
5.1. AMEX
In this tab, you can search for card present transactions that were processed via the
AMEX acquirer. You can export the results into CSV and Excel files.
Search options:
• Merchants
• Date range From – To
• You can also add additional search criteria: Merchant number and Terminal.
In this tab, you can search for card present transactions that were processed via the
Girocard acquirer. You can export the results into CSV and Excel files.
Search options:
• Merchants
• Date range From – To
• You can also add additional search criteria: Merchant number and Terminal.
5.3. ECP
Search options:
• Auth Code
Search options:
• ARN
• Merchants
• Date range From - To
• You can also add additional search criteria: Reseller subtype
• Customisable Columns: Created At, authorisation date, merchant number, amount,
among others.
• ARN
• Merchants
• Date range From - To
• You can also add additional search criteria: Reseller subtype
Search options:
• ARN
• Merchants
• Original transaction date
Search options:
• Item Number
• Merchants
• Post date
• Reseller subtype
• Merchant Number
• Merchant Reference Transaction
• ARN
• Merchants
• Date range From - To
• You can also add additional search criteria: Reseller subtype, Terminal ID and
Merchant Number
Since some merchants have more than one POS terminal and location which are
connected to the same MID, searching under the Terminal ID allows
distinguishing the reporting for the different devices.
Search options:
• ARN
• Merchants
• Date range From - To
• You can also add additional search criteria: Reseller subtype
Customisable Columns: Created at, Original Transaction Date, Merchant Name, and
Reason Code, among others.
From this tab, you can find and download any CSV or Excel exports of Card Present data
you have made previously, so you do not have to re-generate and export them again.
6. WPF Payments
This functionality shows all payments made through the Web Payment Form (WPF) by
the merchant.
• WPF Payment
• Payment Transactions – in this section you will see all transactions related to a
particular WPF payment.
This menu allows the merchant to control the recurring payment schedule. These
payments will be triggered automatically by the gateway following the instructions and
configurations entered by the merchant when the recurring item is created.
When the View Details option is selected, a summary of the item will be displayed:
This form allows the merchant to edit the conditions and configuration of a managed
recurring item, allowing them total control over the schedule of the subsequent payments.
8. Consumers
The Consumers menu has the purpose of searching for customers (consumers) based on
specific conditions and parameters, and then viewing and editing certain properties and
specs. Once a consumer is found, one can display all the details and all the transactions of
the consumer. More information about the purpose of the consumer can be found in the
API documentation.
The search is currently based on the following parameters:
- Date range – searches for the customers who were active in a specific period.
- Merchant – If a specific merchant owns several different merchant accounts, they
can select the account of interest. If only one account is available, it will
automatically appear in the dropdown field.
- Consumer ID – A limited range of consumers can be displayed based on parts of
their ID.
- Email - A limited range of consumers can be displayed based on parts of their
email address.
By going on “View Details” more useful information about the consumer can be
accessed.
If the cardholder’s details have not been tokenised the section “Saved Cards” does not
exist. In this view, the visible additional information could be the Billing address,
Payment transactions and WPF Payments. Here are the individual sections:
- Payment Transactions have the following columns: Actions, ID, Created at,
Merchant, Terminal, Type, Status, Error, Merchant Transaction ID, Unique ID,
Transaction ID, Card Holder, Card Number, Amount, Ref.
- WPF Payments have the following columns: ID, Date, Merchant, Terminal, MID,
Status, Customer, Amount.
- Saved Cards contain: Token ID, Token Type, Status, Created at, Expires at.
In case the cardholder details have been tokenised, the section “Saved Cards” appears
right under the section “Payment transactions”. To see how many card details have been
tokenised, users must click on the up arrow to expand the information.
Please be aware that the Billing address can be updated using the Consumer API together
with the credit card number and other consumer information.
9. Virtual Terminal
The Virtual Terminal is used for processing mail order/telephone order (MOTO)
transactions. Those transactions are processed by the merchant on the behalf of the
customer. They are considered as riskier than normal eCommerce transactions, where the
customer places the transaction by themselves.
You must log in using your account to the gateway and navigate to the menu – “Virtual
Depending on your account configuration, your user account may have different options
for processing Virtual Terminal transactions.
If this terminal belongs to a merchant who supports FX rates, then a new field will appear
containing a dropdown list where a rate can be selected:
The amount must be filled in as per the input text box and the decimal point considered
depending on the currency exponent.
It is also possible for the merchants to ask for a lightweight access, so after logging in the
user will have access only to the “Virtual Terminal”:
By clicking on Pay by Link, the user will be able to easily generate a link for the payment
(Pay by Link will be available depending on your account configuration).
9.1. Authorize
The Authorization is an initial transaction type which requires Capture (settlement) for
such transaction to become financial for the end customer. Capture processing with
Virtual Terminal will be covered below.
To process an Authorization transaction with the Virtual Terminal please click on the
Virtual Terminal button and click on the Authorize link. Some basic details will be
needed to process an Authorize transaction.
The rest of the details are filled in the respective sections:
After filling in all mandatory details (*) from the Virtual Terminal form you can click the
Process button and wait for a response.
To open the payment transaction, you have just made click on the button “Show Payment
Transaction”.
9.2. Authorize3D
• Credit Card Information – This is the section where the sensitive customer
information is filled: Card Number, Card Number, CVV/CVC2 number,
Expiration date.
• Customer information and Billing Address – These are the sections where the
specific customer information is filled. Those may vary from optional to
mandatory, depending on the account configuration. The possible fields in this
section are as follows: Email, Phone, First name, Last name, Primary Address,
Secondary Address, Zip Code, City, Country, State.
• Dynamic descriptor – If enabled in account configuration, the Dynamic
descriptor could be used.
After filling in all mandatory details (*) from the Virtual Terminal form you can click the
Process button and wait for a response.
9.3. Capture
To finalise and make the authorisation transaction a financial transaction, a Capture must
be performed.
To Capture an Authorize / Authorize3D transaction, please click on the Virtual Terminal
button and click on the Capture link.
From the menu Terminal a proper terminal must be selected. The terminal must be the
same as the Terminal where the authorisation has been processed.
In the field reference_id, please input the unique_id returned from the authorise response
within the field unique_id.
9.4. Sale
The Sale transaction is an initial transaction type and has a direct financial impact to the
end customer.
To process a Sale transaction with the Virtual Terminal, please click on the Virtual
Terminal button and click on the Sale link. Some basic details will be needed to process a
Sale.
The rest of the details are filled in the respective sections:
• Credit Card Information – This is the section where the sensitive customer
information is filled: Card Number, Card Number, CVV/CVC2 number,
Expiration date.
• Customer information and Billing Address – These are the sections where the
specific customer information is filled. Those may vary from optional to
mandatory, depending on the account configuration. The possible fields in this
section are as follows: Email, Phone, First name, Last name, Primary Address,
Secondary Address, Zip Code, City, Country, State.
After filling in all mandatory details (*) from the Virtual Terminal form, you can click
the Process button and wait for a response.
To open the payment transaction, you have just made click on the button “Show Payment
Transaction”.
9.5. Sale3D
The Sale3D transaction is an initial transaction type and has a direct financial impact to
the end customer. The Sale3D transaction in additional to the normal (CVV ON) sale will
add 3D secure authentication at the issuer page.
To process a Sale3D transaction with the Virtual Terminal, please click on the Virtual
Terminal button and click on the Sale3D link. Some basic details will be needed to
process a Sale3D.
In the Details section for Sale3D, the following URL addresses for 3D must be added to
the form as well: notification_url, return_success_url and return_failure_url.
The rest of the details are filled in the respective sections:
• Credit Card Information – This is the section where the sensitive customer
information is filled: Card Number, Card Number, CVV/CVC2 number,
Expiration date.
• Customer information and Billing Address – These are the sections where the
specific customer information is filled. Those may vary from optional to
mandatory, depending on the account configuration. The possible fields in this
section are as follows: Email, Phone, First name, Last name, Primary Address,
Secondary Address, Zip Code, City, Country, State.
After filling in all mandatory details (*) from the Virtual Terminal form, you can click
the Process button and wait for a response.
To open the payment transaction, you have just made click on the button “Show Payment
Transaction”.
To process an Init recurring sale transaction, click the Virtual Terminal button and then
the Init recurring sale link. Some basic details will be needed to process an Init recurring
sale.
Init recurring sale is processed like the normal Sale transaction, but it provides the
possibility for recurring. Please refer to the Sale transaction section from the guide. Init
recurring sale is used for subsequent recurring transactions.
After a successful Init recurring sale transaction, using the unique_id parameter returned,
a RecurringSale transactions could be submitted. Or a new Managed Recurring Item can
be created for an automatic charge to the customer if the merchant is configured to
support this feature.
Please refer to the 7.6. Init recurring sale section. The additional is that a 3D
authentication is performed, and three URLs must be filled - notification_url,
return_success_url and return_failure_url.
To process a RecurringSale transaction, click the Virtual Terminal button and then click
the RecurringSale link. Some basic details will be needed to process a Recurring sale.
RecurringSale transaction type via the Virtual Terminal requires a unique id from an Init
recurring sale which should be included in the reference_id field.
Account verification is a transaction that does not have a financial impact on the
customer.
To submit an Account verification transaction, click the Virtual Terminal button and then
click the Account verification link.
The following fields must be filled depending on the account configuration:
• Credit Card Information – This is the section where the sensitive customer
information is filled: Card Number, Card Number, CVV/CVC2 number,
Expiration date.
• Customer information and Billing Address – These are the sections where the
specific customer information is filled. Those may vary from optional to
mandatory, depending on the account configuration. The possible fields in this
section are as follows: Email, Phone, First name, Last name, Primary Address,
Secondary Address, Zip Code, City, Country, State.
9.10. Credit
To submit Credit transaction, click the Virtual Terminal button and then then click the
Credit link.
9.11. Payout
• Credit Card Information – This is the section where the sensitive customer
information is filled: Card Number.
• Customer information and Billing Address – These are the sections where the
specific customer information is filled. Those may vary from optional to
mandatory, depending on the account configuration. The possible fields in this
section are as follows: Email, Phone, First name, Last name, Primary Address,
Secondary Address, Zip Code, City, Country, State.
• Sender Details – Section where additional details about the sender of the payout
are provided.
• Money Transfer Type: Special attribute for Payouts – needs also to be
enabled on Merchant Level. Genesis supports several types of transfers,
this field can take the following values: Account to Account, Person to
person, Wallet Transfer, Business to business Supplier Payments, Loyalty
Payments, Funds Disbursement, Merchant Settlement and Prepaid Card
Load.
• Source of funds - The following options can be selected (only applicable
for transactions with the Visa card brand):
- Credit – Visa credit
- Debit – Visa debit
- Prepaid – Visa prepaid
- Cash
- other_debit_account - Debit/deposit access accounts other than those linked
to a Visa Card (includes cheking/savings accounts and proprietary
debit/ATM cards). This is the default if no other value is selected.
eZeeCard Payout is a sync-based payout method. It is merchant initiated and can only
reference specific transaction types: Capture, Sale, Sale3D, InitRecurringSale,
InitRecurringSale3D and RecurringSale
To process an eZeeCard Payout transaction with the Virtual Terminal, please click on the
Virtual Terminal button and click on the eZeeCard Payout link. Some basic details will
be needed to process an eZeecard Payout. Reference ID – Unique ID returned by THE
corresponding transaction.
Incremental authorisations are non-3DS because they only refer to the Pre-authorisation
transaction. They cannot be voided/refunded etc, and can only modify/extend the related
pre-authorisation.
An incremental authorisation transaction can be submitted in case:
To process an Incremental Authorize transaction with the Virtual Terminal, please click
on the Virtual Terminal button and click on the Incremental Authorize link. Some basic
details will be needed to process an Incremental Authorize.
The rest of the details are filled in the respective sections:
9.15. CashU
To process a CashU transaction with the Virtual Terminal, please click on the Virtual
Terminal button and click on the CashU link. Some basic details will be needed to
process a CashU transaction.
• Customer information and Billing Address – These are the sections where the
specific customer information is filled. Those may vary from optional to
mandatory, depending on the account configuration. The possible fields in this
section are as follows: Email, Phone, First name, Last name, Primary Address,
Secondary Address, Zip Code, City, Country, State.
9.16. Paysafecard
To process a Paysafecard transaction with the Virtual Terminal, please click on the
Virtual Terminal button and click on the Paysafecard link. Some basic details will be
needed to process a Paysafecard transaction.
For the Paysafecard method and due to the asynchronous design, the following fields /
addresses must be filled: notification_url, return_success_url and return_failure_url.
The rest of the details are filled in the respective sections:
• Customer information and Billing Address – These are the sections where the
specific customer information is filled. Those may vary from optional to
mandatory, depending on the account configuration. The possible fields in this
section are as follows: Email, Phone, First name, Last name, Primary Address,
Secondary Address, Zip Code, City, Country, State.
9.17. eZeeWallet
To process an eZeeWallet transaction with the Virtual Terminal, please click on the
Virtual Terminal button and click on the eZeeWallet link. Some basic details will be
needed to process an eZeeWallet transaction.
• Customer information and Billing Address – These are the sections where the
specific customer information is filled. Those are the fields: Consumer email and
Consumer password.
9.18. Sofort
To process a Sofort transaction with the Virtual Terminal, please click on the Virtual
Terminal button and click on the Sofort link. Some basic details will be needed to process
a Sofort transaction.
For the Sofort method and due to the asynchronous design, the following fields /
addresses must be filled: notification_url, return_success_url and return_failure_url.
The rest of the details are filled in the respective sections:
• Customer information and Billing Address – These are the sections where the
specific customer information is filled. Those may vary from optional to
mandatory, depending on the account configuration. The possible fields in this
section are as follows: Email, Phone, First name, Last name, Primary Address,
Secondary Address, Zip Code, City, Country, State.
• Sofort specific fields: Customer Bank ID and Bank Account Number must be
filled as well.
9.19. PPRO
To process a PPRO transaction with the Virtual Terminal, please click on the Virtual
Terminal button and click on the PPRO link. Some basic details will be needed to process
a PPRO transaction. A PPRO sub-method must be selected as well.
• Customer information and Billing Address – These are the sections where the
specific customer information is filled. Those may vary from optional to
mandatory, depending on the account configuration. The possible fields in this
section are as follows: Email, Phone, First name, Last name, Primary Address,
Secondary Address, Zip Code, City, Country, State.
• PPRO specific fields: BIC, IBAN, Account Phone, Bank Code, Account Number.
9.20. Neteller
To process a Neteller transaction with the Virtual Terminal, please click on the Virtual
Terminal button and click on the Neteller link. Some basic details will be needed to
process a Neteller transaction.
For the Neteller method and due to the asynchronous design, the following fields /
addresses must be filled: notification_url, return_success_url and return_failure_url.
The rest of the details are filled in the respective sections:
• Customer information and Billing Address – These are the sections where the
specific customer information is filled. Those may vary from optional to
mandatory, depending on the account configuration. The possible fields in this
To process an ABN iDeal transaction with the Virtual Terminal, please click on the
Virtual Terminal button and click on the ABN iDeal link. Some basic details will be
needed to process an ABN iDeal transaction.
For the ABN iDeal method and due to the asynchronous design, the following fields /
addresses must be filled: notification_url, return_success_url and return_failure_url.
The rest of the details are filled in the respective sections:
• Customer information and Billing Address – These are the sections where the
specific customer information is filled. Those may vary from optional to
mandatory, depending on the account configuration. The possible fields in this
section are as follows: Email, Phone, First name, Last name, Primary Address,
Secondary Address, Zip Code, City, Country, State.
• ABN iDeal specific fields: Bank.
9.22. Webmoney
To process a Webmoney transaction with the Virtual Terminal, please click on the
Virtual Terminal button and click on the Webmoney link. Some basic details will be
needed to process a Webmoney transaction.
For the Webmoney method and due to the asynchronous design, the following fields /
addresses must be filled: notification_url, return_success_url, return_failure_url and
Select payment type.
The rest of the details are filled in the respective sections:
9.23. POLi
To process a POLi transaction with the Virtual Terminal, please click on the Virtual
Terminal button and click on the POLi link. Some basic details will be needed to process
a POLi transaction.
For the POLi method and due to the asynchronous design, the following fields /
addresses must be filled: notification_url, return_success_url and return_failure_url.
The rest of the details are filled in the respective sections:
• Customer information and Billing Address – These are the sections where the
specific customer information is filled. Those may vary from optional to
mandatory, depending on the account configuration. The possible fields in this
section are as follows: Email, Phone, First name, Last name, Primary Address,
Secondary Address, Zip Code, City, Country, State.
To process a Paybyvoucher sale transaction with the Virtual Terminal, please click on the
Virtual Terminal button and click on the Paybyvoucher sale link. Some basic details will
be needed to process a Paybyvoucher transaction.
The rest of the details are filled in the respective sections:
To process an SDD Sale transaction with the Virtual Terminal, please click on the Virtual
Terminal button and click on the SDD Sale link. Some basic details will be needed to
process an SDD transaction.
The rest of the details are filled in the respective sections:
• Customer information and Billing Address – These are the sections where the
specific customer information is filled. Those may vary from optional to
mandatory, depending on the account configuration. The possible fields in this
section are as follows: First name, Last name.
• SDD Sale specific fields: IBAN, BIC.
To process an SDD Init Recurring Sale transaction with the Virtual Terminal, please
click on the Virtual Terminal button and click on the SDD Init Recurring Sale link. Some
basic details will be needed to process a SDD Init Recurring Sale transaction.
The rest of the details are filled in the respective sections:
To process an SDD Recurring Sale transaction with the Virtual Terminal, please click on
the Virtual Terminal button and click on the SDD Recurring Sale link. Some basic details
will be needed to process an SDD Recurring Sale transaction.
The SDD Recurring Sale transaction type via the Virtual Terminal requires to be referred
by a Unique ID from an SDD Init Recurring Sale which should be included in the
Reference ID field.
To process an SDD Refund transaction with the Virtual Terminal, please click on the
Virtual Terminal button and click on the SDD Refund link. Some basic details will be
needed to process an SDD Refund transaction.
The SDD Refund transaction type via the Virtual Terminal requires to be referred by a
Unique ID from an approved SDD deposit type of transaction which should be included
in the Reference ID field.
9.29. Przelewy24
To process a Przelewy24 transaction with the Virtual Terminal, please click on the
Virtual Terminal button and click on the Przelewy24 link. Some basic details will be
needed to process a Przelewy24 transaction.
• Customer information and Billing Address – These are the sections where the
specific customer information is filled. Those may vary from optional to
mandatory, depending on the account configuration. The possible fields in this
section are as follows: Email, Phone, First name, Last name, Primary Address,
Secondary Address, Zip Code, City, Country, State.
To process an SCT Payout transaction with the Virtual Terminal, please click on the
Virtual Terminal button and click on the SCT Payout link. Some basic details will be
needed to process an SCT Payout transaction.
The rest of the details are filled in the respective sections:
• Customer information and Billing Address – These are the sections where the
specific customer information is filled. Those may vary from optional to
mandatory, depending on the account configuration. The possible fields in this
section are as follows: First name, Last name.
• STC Payout specific fields: IBAN, BIC.
To process a Trustly Sale transaction with the Virtual Terminal, please click on the
Virtual Terminal button and click on the Trustly Sale link. Some basic details will be
needed to process a Trustly Sale transaction.
• Customer information and Billing Address – These are the sections where the
specific customer information is filled. Those may vary from optional to mandatory,
depending on the account configuration. The possible fields in this section are as
follows: Email, Phone, First name, Last name, Primary Address, Secondary Address,
Zip Code, City, Country, State.
To process a Trustly Withdrawal transaction with the Virtual Terminal, please click on
the Virtual Terminal button and click on the Trustly Withdrawal link. Some basic details
will be needed to process a Trustly Withdrawal transaction.
In the Details section for Trustly Withdrawal the following URL addresses for 3D must
be added to the form as well: notification_url, return_success_url and return_failure_url.
The rest of the details are filled in the respective section:
• Customer information and Billing Address – These are the sections where the
specific customer information is filled. Those may vary from optional to mandatory,
depending on the account configuration. The possible fields in this section are as
follows: Email, Phone, First name, Last name, Primary Address, Secondary Address,
Zip Code, City, Country, State.
• Trustly specific fields: Birth Date.
• Customer information and Billing Address – These are the sections where the
specific customer information is filled. Those may vary from optional to
mandatory, depending on the account configuration. The possible fields in this
section are as follows: Email, First name, Last name, Primary address, Zip code,
City, Country.
To process an iDebit Payin transaction with the Virtual Terminal, please click on the
Virtual Terminal button and click on the iDebit Payin link. Some basic details will be
needed to process an iDebit Payin transaction.
The rest of the details are filled in the respective sections:
• Customer information and Billing Address – These are the sections where the
specific customer information is filled. Those may vary from optional to
mandatory, depending on the account configuration. The possible fields in this
section are as follows: Email, Phone, First name, Last name, Primary Address,
Secondary Address, Zip Code, City, Country, State.
• iDebit Payin specific fields: Customer Account number or ID.
• iDebit Payout specific fields: Approved InstaDebit Payin transaction Unique ID.
To process an InstaDebit Payin transaction with the Virtual Terminal, please click on the
Virtual Terminal button and click on the InstaDebit Payin link. Some basic details will be
needed to process an InstaDebit Payin transaction.
The rest of the details are filled in the respective sections:
• Customer information and Billing Address – These are the sections where the
specific customer information is filled. Those may vary from optional to
mandatory, depending on the account configuration. The possible fields in this
section are as follows: Email, Phone, First name, Last name, Primary Address,
Secondary Address, Zip Code, City, Country, State.
• InstaDebit Payin specific fields: Customer Account number or ID.
To process an InstaDebit Payout transaction with the Virtual Terminal please click on
Virtual Terminal button and click on the InstaDebit Payout link. Some basic details will
be needed to process an InstaDebit Payout transaction.
The rest of the details are filled in the respective sections:
To process an Earthport transaction with the Virtual Terminal, please click on the Virtual
Terminal button and click on the Earthport link. Some basic details will be needed to
process an Earthport transaction.
For the Earthport method and due to the asynchronous design, the following fields /
addresses must be filled: notification_url, return_success_url, return_failure_url and
Select payment type.
The rest of the details are filled in the respective sections:
• Customer information and Billing Address – These are the sections where the
specific customer information is filled. Those may vary from optional to
mandatory, depending on the account configuration. The possible fields in this
section are as follows: Email, Phone, First name, Last name, Primary Address,
Secondary Address, Zip Code, City, Country, State.
To process a WeChat Pay transaction with the Virtual Terminal, please click on the
Virtual Terminal button and click on the WeChat Pay link. Some basic details will be
needed to process a WeChat Pay transaction.
For the WeChat Pay method and due to the asynchronous design, the following fields /
addresses must be filled: notification_url, return_success_url, return_failure_url and
Select payment type.
The rest of the details are filled in the respective sections:
• Customer information and Billing Address – These are the sections where the
specific customer information is filled. Those may vary from optional to
mandatory, depending on the account configuration. The possible fields in this
section are as follows: Email, Phone, First name, Last name, Primary Address,
Secondary Address, Zip Code, City, Country, State.
• WeChat Pay specific fields: Product code; Product number; Product description.
To process an Alipay transaction with the Virtual Terminal, please click on the Virtual
Terminal button and click on the Alipay link. Some basic details will be needed to
process an Alipay transaction.
For the Alipay method and due to the asynchronous design, the following fields /
addresses must be filled: notification_url, return_success_url, return_failure_url and
Select payment type.
The rest of the details are filled in the respective sections:
• Customer information and Billing Address – These are the sections where the
specific customer information is filled. Those may vary from optional to
mandatory, depending on the account configuration. The possible fields in this
section are as follows: Email, Phone, First name, Last name, Primary Address,
Secondary Address, Zip Code, City, Country, State.
To process an Online Banking transaction with the Virtual Terminal, please click on the
Virtual Terminal button and click on the Online Banking link. Some basic details will be
needed to process an Online Banking transaction.
For the Online Banking method and due to the asynchronous design, the following fields
/ addresses must be filled: notification_url, return_success_url, return_failure_url and
Select payment type.
The rest of the details are filled in the respective sections:
• Customer information and Billing Address – These are the sections where the
specific customer information is filled. Those may vary from optional to
mandatory, depending on the account configuration. The possible fields in this
section are as follows: Email, Phone, First name, Last name, Primary Address,
Secondary Address, Zip Code, City, Country, State.
To process a Bank Payout transaction with the Virtual Terminal, please click on the
Virtual Terminal button and click on the Bank Payout link. Some basic details will be
needed to process a Bank Payout transaction.
For the Bank Payout method and due to the asynchronous design, the following fields /
addresses must be filled: notification_url, return_success_url, return_failure_url and
Select payment type.
The rest of the details are filled in the respective sections:
• Customer information and Billing Address – These are the sections where the
specific customer information is filled. Those may vary from optional to
mandatory, depending on the account configuration. The possible fields in this
section are as follows: Email, Phone, First name, Last name, Primary Address,
Secondary Address, Zip Code, City, Country, State.
• Bank Payout specific fields: Payment type (customers will need to select a
payout subtype), Bank Code; Bank Name; Bank Branch; Bank Account Name;
Bank Account Number.
To process an RPN Payout transaction with the Virtual Terminal, please click on the
Virtual Terminal button and click on the RPN Payout link. Some basic details will be
needed to process an RPN Payout transaction.
RPN Payout specific fields: Bank Name, Sub Branch, Bank Account Name, Bank Card
Number, Province, Area.
9.44. Intersolve
9.45. Fashioncheque
To process a Fashioncheque transaction with the Virtual Terminal, please click on the
Virtual Terminal button and click on the Fashioncheque link. Some basic details will be
needed to process a Fashioncheque transaction.
Fashioncheque specific fields: Card number and Verification code.
To process a TCS transaction with the Virtual Terminal, please click on the Virtual
Terminal button and click on the TCS link. Some basic details will be needed to process
a TCS transaction.
TCS specific fields: Card number and Verification code.
9.47. Paycommerce
To process a Paycommerce transaction with the Virtual Terminal, please click on the
Virtual Terminal button and click on the Paycommerce link.
Select Merchant:
Click on Batch File to open PopUp to select and upload CSV file (in strictly defined
format, check the Paycommerce section in API documentation).
9.48. Neosurf
To process a Neosurf transaction with the Virtual Terminal, please click on the Virtual
Terminal button and click on the Neosurf link. Some basic details will be needed to
process a Neosurf transaction.
For the Neosurf method and due to the asynchronous design, the following fields /
addresses must be filled: notification_url, return_success_url and return_failure_url.
The rest of the details are filled in the respective sections:
• Customer information and Billing Address – These are the sections where the
specific customer information is filled. Those may vary from optional to
mandatory, depending on the account configuration. The possible fields in this
section are as follows: Email, Phone, First name, Last name, Primary Address,
Secondary Address, Zip Code, City, Country, State.
• Neosurf specific fields: Voucher Number.
• Customer information and Billing Address – These are the sections where the
specific customer information is filled. Those may vary from optional to
mandatory, depending on the account configuration. The possible fields in this
section are as follows: Email, Phone, First name, Last name, Primary Address,
Secondary Address, Zip Code, City, Country, State.
• Money Transfer Type – Business to Client or Business to Business
• Payer ID - ID of the Payer used to deliver the money through one of the three
services.
9.50. UPI
To process a UPI transaction with the Virtual Terminal, please click on the Virtual
Terminal button and click on the UPI link. Some basic details will be needed to process a
UPI transaction.
• Customer information and Billing Address – These are the sections where the
specific customer information is filled. Those may vary from optional to
mandatory, depending on the account configuration. The possible fields in this
section are as follows: Email, Phone, First name, Last name, Primary Address,
Secondary Address, Zip Code, City, Country, State.
• UPI specific fields: Virtual payment address.
9.51. Invoice
To process an Invoice transaction with the Virtual Terminal, please click on the Virtual
Terminal button and click on the Invoice link. Some basic details will be needed to
process an Invoice transaction.
For the Invoice method and due to the asynchronous design, the following fields /
addresses must be filled: notification_url, return_success_url and return_failure_url.
The rest of the details are filled in the respective sections:
• Customer information and Billing Address – These are the sections where the
specific customer information is filled. Those may vary from optional to
mandatory, depending on the account configuration. The possible fields in this
section are as follows: Email, Phone, Gender, First name, Last name, Primary
Address, Secondary Address, Zip Code, City, Country, State.
• Items – must be provided at least one item – up to five with several required
fields, such as: Item type, Name, Quantity, Unit price and Total amount.
To process an Invoice Capture transaction with the Virtual Terminal, please click on the
Virtual Terminal button and click on the Invoice Capture link. Some basic details will be
needed to process an Invoice Capture transaction.
• Items – must be provided at least one item – up to five with several required
fields, such as: Item type, Name, Quantity, Unit price and Total amount.
Invoice Refund is a transaction which transfers the money back to the end customer in
case if the customer is not satisfied by the service or similar case. Refund can be only
initiated on transactions with a financial impact such as Invoice Capture.
To perform an Invoice Refund transaction, click on the Virtual Terminal and click
Invoice Refund.
To process the Invoice Refund, please use the unique_id from a financial transaction and
input it in the field reference_id.
If the Refund is successful, a message showing that the refund was successful will be
shown.
• Customer information and Billing Address – These are the sections where the
specific customer information is filled. Those may vary from option to mandatory,
depending on the account configuration. The possible fields in this section are as
follows: Email, Phone, First name, Last name, Primary Address, Secondary
Address, Zip Code, City, Country, State.
BitPay Refund is a custom refund method which handles the asynchronous BitPay refund
workflow. BitPay refunds can only be done on former transactions. Therefore, the
Reference ID for the corresponding BitPay Sale transaction is mandatory. BitPay Refund
is an asynchronous transaction type.
When a BitPay Refund is requested, BitPay will send an email to the consumer with a
request to provide the refund crypto address. This request will be valid for three days and
will expire afterwards. When the crypto address is provided, the refund will be processed
(processing usually takes 24 hours).
A notification will be sent to the Merchant when the Bitpay refund is completed. Only
full refunds are supported at the moment.
BitPay Refunds can be voided only during the 24-hour processing period.
To process a BitPay Refund transaction with the Virtual Terminal, please click on the
Virtual Terminal button and click on the BitPay Refund link. Some basic details will be
needed to process a BitPay Refund transaction.
For the BitPay Refund method and due to the asynchronous design, the following fields /
addresses must be filled: notification_url, return_success_url and return_failure_url.
The rest of the details are filled in the respective sections:
• Customer information and Billing Address – These are the sections where the
specific customer information is filled. Those may vary from optional to
mandatory, depending on the account configuration. The possible fields in this
section are as follows: Email, Phone, First name, Last name, Primary Address,
Secondary Address, Zip Code, City, Country, State.
African Mobile Sale, otherwise known as Charge, is an APM used to process Mobile
network operator payments. It is an asynchronous payment method and will be approved
once African Mobile processes the payment with the Mobile network operator.
• Customer information and Billing Address – These are the sections where the
specific customer information is filled. Those may vary from optional to
mandatory, depending on the account configuration. The possible fields in this
section are as follows: Email, Phone, First name, Last name, Primary Address,
Secondary Address, Zip Code, City, Country, State.
• Operator – Name of the Mobile network operator (MNO) which should process
the transaction - VODACOM, SAFARICOM, AIRTEL, MTN.
• Target - Number of the Paybill for which the transaction is intended.
To process an Astropay Direct transaction with the Virtual Terminal, please click on the
Virtual Terminal button and click on the Astropay Direct link. Some basic details will be
needed to process an Astropay Direct transaction.
For the Astropay Direct method and due to the asynchronous design, the following fields
/ addresses must be filled: notification_url, return_success_url and return_failure_url.
The rest of the details are filled in the respective sections:
• Customer information and Billing Address – These are the sections where the
specific customer information is filled. Those may vary from optional to
mandatory, depending on the account configuration. The possible fields in this
section are as follows: Email, Phone, First name, Last name, Primary Address,
Secondary Address, Zip Code, City, Country, State.
• Astropay Direct specific fields: Consumer Reference.
To process a Bancontact transaction with the Virtual Terminal, please click on the Virtual
Terminal button and click on the Bancontact link. Some basic details will be needed to
process a Bancontact transaction.
For the Bancontact method and due to the asynchronous design, the following fields /
addresses must be filled: notification_url, return_success_url and return_failure_url.
The rest of the details are filled in the respective sections:
• Customer information and Billing Address – These are the sections where the
specific customer information is filled. Those may vary from optional to
mandatory, depending on the account configuration. The possible fields in this
section are as follows: Email, Phone, First name, Last name, Primary Address,
Secondary Address, Zip Code, City, Country, State.
9.61. QIWI
To process a QIWI transaction with the Virtual Terminal, please click on the Virtual
Terminal button and click on the QIWI link. Some basic details will be needed to process
a QIWI transaction.
For the QIWI method and due to the asynchronous design, the following fields /
addresses must be filled: notification_url, return_success_url and return_failure_url.
The rest of the details are filled in the respective sections:
• Customer information and Billing Address – These are the sections where the
specific customer information is filled. Those may vary from optional to
mandatory, depending on the account configuration. The possible fields in this
section are as follows: Email, Phone, First name, Last name, Primary Address,
Secondary Address, Zip Code, City, Country, State.
• QIWI specific fields: Site ID.
To process a MyBank transaction with the Virtual Terminal, please click on the Virtual
Terminal button and click on the MyBank link. Some basic details will be needed to
process a MyBank transaction.
For the MyBank method and due to the asynchronous design, the following fields /
addresses must be filled: notification_url, return_success_url and return_failure_url.
The rest of the details are filled in the respective sections:
• Customer information and Billing Address – These are the sections where the
specific customer information is filled. Those may vary from optional to
mandatory, depending on the account configuration. The possible fields in this
section are as follows: Email, Phone, First name, Last name, Primary Address,
Secondary Address, Zip Code, City, Country, State.
9.63. Giropay
To process a Giropay transaction with the Virtual Terminal, please click on the Virtual
Terminal button and click on the Giropay link. Some basic details will be needed to
process a Giropay transaction.
For the Giropay method and due to the asynchronous design, the following fields /
addresses must be filled: notification_url, return_success_url and return_failure_url.
The rest of the details are filled in the respective sections:
• Customer information and Billing Address – These are the sections where the
specific customer information is filled. Those may vary from optional to
mandatory, depending on the account configuration. The possible fields in this
section are as follows: Email, Phone, First name, Last name, Primary Address,
Secondary Address, Zip Code, City, Country, State.
• Giropay specific fields: BIC.
To process a Zimpler transaction with the Virtual Terminal, please click on the Virtual
Terminal button and click on the Zimpler link. Some basic details will be needed to
process a Zimpler transaction.
For the Zimpler method and due to the asynchronous design, the following fields /
addresses must be filled: notification_url, return_success_url and return_failure_url.
The rest of the details are filled in the respective sections:
• Customer information and Billing Address – These are the sections where the
specific customer information is filled. Those may vary from optional to
mandatory, depending on the account configuration. The possible fields in this
section are as follows: Email, Phone, First name, Last name, Primary Address,
Secondary Address, Zip Code, City, Country, State.
9.65. Safetypay
To process a Safetypay transaction with the Virtual Terminal, please click on the Virtual
Terminal button and click on the Safetypay link. Some basic details will be needed to
process a Safetypay transaction.
For the Safetypay method and due to the asynchronous design, the following fields /
addresses must be filled: notification_url, return_success_url and return_failure_url.
The rest of the details are filled in the respective sections:
• Customer information and Billing Address – These are the sections where the
specific customer information is filled. Those may vary from optional to
mandatory, depending on the account configuration. The possible fields in this
section are as follows: Email, Phone, First name, Last name, Primary Address,
Secondary Address, Zip Code, City, Country, State.
To process a PayU transaction with the Virtual Terminal, please click on the Virtual
Terminal button and click on the PayU link. Some basic details will be needed to process
a PayU transaction.
For the PayU method and due to the asynchronous design, the following fields /
addresses must be filled: notification_url, return_success_url and return_failure_url.
The rest of the details are filled in the respective sections:
• Customer information and Billing Address – These are the sections where the
specific customer information is filled. Those may vary from optional to
mandatory, depending on the account configuration. The possible fields in this
section are as follows: Email, Phone, First name, Last name, Primary Address,
Secondary Address, Zip Code, City, Country, State.
To process an Instant Transfer transaction with the Virtual Terminal, please click on the
Virtual Terminal button and click on the Instant Transfer link. Some basic details will be
needed to process an Instant Transfer transaction.
For the Instant Transfer method and due to the asynchronous design, the following fields
/ addresses must be filled: notification_url, return_success_url and return_failure_url.
The rest of the details are filled in the respective sections:
• Customer information and Billing Address – These are the sections where the
specific customer information is filled. Those may vary from optional to
mandatory, depending on the account configuration. The possible fields in this
section are as follows: Email, Phone, First name, Last name, Primary Address,
Secondary Address, Zip Code, City, Country, State.
• Instant Transfer specific fields: IBAN and BIC.
To process a Multibanco transaction with the Virtual Terminal, please click on the
Virtual Terminal button and click on the Multibanco link. Some basic details will be
needed to process a Multibanco transaction.
For the Multibanco method and due to the asynchronous design, the following fields /
addresses must be filled: notification_url, return_success_url and return_failure_url.
The rest of the details are filled in the respective sections:
• Customer information and Billing Address – These are the sections where the
specific customer information is filled. Those may vary from optional to
mandatory, depending on the account configuration. The possible fields in this
section are as follows: Email, Phone, First name, Last name, Primary Address,
Secondary Address, Zip Code, City, Country, State.
9.69. iDEAL
To process an iDEAL transaction with the Virtual Terminal, please click on the Virtual
Terminal button and click on the iDEAL link. Some basic details will be needed to
process an iDEAL transaction.
For the iDEAL method and due to the asynchronous design, the following fields /
addresses must be filled: notification_url, return_success_url and return_failure_url.
The rest of the details are filled in the respective sections:
• Customer information and Billing Address – These are the sections where the
specific customer information is filled. Those may vary from optional to
mandatory, depending on the account configuration. The possible fields in this
section are as follows: Email, Phone, First name, Last name, Primary Address,
Secondary Address, Zip Code, City, Country, State.
9.70. EPS
• Customer information and Billing Address – These are the sections where the
specific customer information is filled. Those may vary from optional to
mandatory, depending on the account configuration. The possible fields in this
section are as follows: Email, Phone, First name, Last name, Primary Address,
Secondary Address, Zip Code, City, Country, State.
To process a Pago Facil transaction with the Virtual Terminal, please click on the Virtual
Terminal button and click on the Pago Facil link. Some basic details will be needed to
process a Pago Facil transaction.
For the Pago Facil method and due to the asynchronous design, the following fields /
addresses must be filled: notification_url, return_success_url and return_failure_url.
The rest of the details are filled in the respective sections:
• Customer information and Billing Address – These are the sections where the
specific customer information is filled. Those may vary from optional to
mandatory, depending on the account configuration. The possible fields in this
section are as follows: Email, Phone, First name, Last name, Primary Address,
Secondary Address, Zip Code, City, Country, State.
• Pago Facil specific fields: Birth Date, Consumer Reference, and National ID.
9.72. PSE
• Customer information and Billing Address – These are the sections where the
specific customer information is filled. Those may vary from optional to
mandatory, depending on the account configuration. The possible fields in this
section are as follows: Email, Phone, First name, Last name, Primary Address,
Secondary Address, Zip Code, City, Country, State.
• PSE specific fields: Birth Date, Consumer Reference, and National ID.
9.73. Rapipago
To process a Rapipago transaction with the Virtual Terminal, please click on the Virtual
Terminal button and click on the Rapipago link. Some basic details will be needed to
process a Rapipago transaction.
For the Rapipago method and due to the asynchronous design, the following fields /
addresses must be filled: notification_url, return_success_url and return_failure_url.
The rest of the details are filled in the respective sections:
• Customer information and Billing Address – These are the sections where the
specific customer information is filled. Those may vary from optional to
mandatory, depending on the account configuration. The possible fields in this
section are as follows: Email, Phone, First name, Last name, Primary Address,
Secondary Address, Zip Code, City, Country, State.
• Rapipago specific fields: Birth Date, Consumer Reference, and National ID.
9.74. WebPay
• Customer information and Billing Address – These are the sections where the
specific customer information is filled. Those may vary from optional to
mandatory, depending on the account configuration. The possible fields in this
section are as following: Email, Phone, First name, Last name, Primary Address,
Secondary Address, Zip Code, City, Country, State.
• WebPay specific fields: Birth Date, Consumer Reference, and National ID.
9.75. Carulla
To process a Carulla transaction with the Virtual Terminal, please click on the Virtual
Terminal button and click on the Carulla link. Some basic details will be needed to
process a Carulla transaction.
For the Carulla method and due to the asynchronous design, the following fields /
addresses must be filled: notification_url, return_success_url and return_failure_url.
The rest of the details are filled in the respective sections:
• Customer information and Billing Address – These are the sections where the
specific customer information is filled. Those may vary from optional to
mandatory, depending on the account configuration. The possible fields in this
section are as follows: Email, Phone, First name, Last name, Primary Address,
Secondary Address, Zip Code, City, Country, State.
• Carulla specific fields: Birth Date, Consumer Reference, and National ID.
9.76. Davivienda
• Customer information and Billing Address – These are the sections where the
specific customer information is filled. Those may vary from optional to
mandatory, depending on the account configuration. The possible fields in this
section are as follows: Email, Phone, First name, Last name, Primary Address,
Secondary Address, Zip Code, City, Country, State.
• Davivienda specific fields: Birth Date, Consumer Reference, and National ID.
9.77. Surtimax
To process a Surtimax transaction with the Virtual Terminal, please click on the Virtual
Terminal button and click on the Surtimax link. Some basic details will be needed to
process a Surtimax transaction.
For the Surtimax method and due to the asynchronous design, the following fields /
addresses must be filled: notification_url, return_success_url and return_failure_url.
The rest of the details are filled in the respective sections:
• Customer information and Billing Address – These are the sections where the
specific customer information is filled. Those may vary from optional to
mandatory, depending on the account configuration. The possible fields in this
section are as follows: Email, Phone, First name, Last name, Primary Address,
Secondary Address, Zip Code, City, Country, State.
• Surtimax specific fields: Birth Date, Consumer Reference, and National ID.
To process an OXXO transaction with the Virtual Terminal, please click on the Virtual
Terminal button and click on the OXXO link. Some basic details will be needed to
process an OXXO transaction.
For the OXXO method and due to the asynchronous design, the following fields /
addresses must be filled: notification_url, return_success_url and return_failure_url.
The rest of the details are filled in the respective sections:
• Customer information and Billing Address – These are the sections where the
specific customer information is filled. Those may vary from optional to
mandatory, depending on the account configuration. The possible fields in this
section are as follows: Email, Phone, First name, Last name, Primary Address,
Secondary Address, Zip Code, City, Country, State.
• OXXO specific fields: Birth Date, Consumer Reference, and National ID.
9.79. Efecty
To process an Efecty transaction with the Virtual Terminal, please click on the Virtual
Terminal button and click on the Efecty link. Some basic details will be needed to
process an Efecty transaction.
For the Efecty method and due to the asynchronous design, the following fields /
addresses must be filled: notification_url, return_success_url and return_failure_url.
The rest of the details are filled in the respective sections:
• Customer information and Billing Address – These are the sections where the
specific customer information is filled. Those may vary from optional to
mandatory, depending on the account configuration. The possible fields in this
section are as follows: Email, Phone, First name, Last name, Primary Address,
Secondary Address, Zip Code, City, Country, State.
• Efecty specific fields: Birth Date, Consumer Reference, and National ID.
To process an Argencard transaction with the Virtual Terminal, please click on the
Virtual Terminal button and click on the Argencard link. Some basic details will be
needed to process an Argencard transaction.
For the Argencard method and due to the asynchronous design, the following fields /
addresses must be filled: notification_url, return_success_url and return_failure_url.
The rest of the details are filled in the respective sections:
• Customer information and Billing Address – These are the sections where the
specific customer information is filled. Those may vary from optional to
mandatory, depending on the account configuration. The possible fields in this
section are as follows: Email, Phone, First name, Last name, Primary Address,
Secondary Address, Zip Code, City, Country, State.
• Argencard specific fields: Birth Date, Consumer Reference, and National ID.
9.81. Naranja
To process a Naranja transaction with the Virtual Terminal, please click on the Virtual
Terminal button and click on the Naranja link. Some basic details will be needed to
process a Naranja transaction.
For the Naranja method and due to the asynchronous design, the following fields /
addresses must be filled: notification_url, return_success_url and return_failure_url.
The rest of the details are filled in the respective sections:
• Customer information and Billing Address – These are the sections where the
specific customer information is filled. Those may vary from optional to
mandatory, depending on the account configuration. The possible fields in this
section are as follows: Email, Phone, First name, Last name, Primary Address,
Secondary Address, Zip Code, City, Country, State.
• Naranja specific fields: Birth Date, Consumer Reference, and National ID.
To process a Nativa transaction with the Virtual Terminal, please click on the Virtual
Terminal button and click on the Nativa link. Some basic details will be needed to
process a Nativa transaction.
For the Nativa method and due to the asynchronous design, the following fields /
addresses must be filled: notification_url, return_success_url and return_failure_url.
The rest of the details are filled in the respective sections:
• Customer information and Billing Address – These are the sections where the
specific customer information is filled. Those may vary from optional to
mandatory, depending on the account configuration. The possible fields in this
section are as follows: Email, Phone, First name, Last name, Primary Address,
Secondary Address, Zip Code, City, Country, State.
• Nativa specific fields: Birth Date, Consumer Reference, and National ID.
9.83. Cabal
To process a Cabal transaction with the Virtual Terminal, please click on the Virtual
Terminal button and click on the Cabal link. Some basic details will be needed to process
a Cabal transaction.
For the Cabal method and due to the asynchronous design, the following fields /
addresses must be filled: notification_url, return_success_url and return_failure_url.
The rest of the details are filled in the respective sections:
• Customer information and Billing Address – These are the sections where the
specific customer information is filled. Those may vary from optional to
mandatory, depending on the account configuration. The possible fields in this
section are as follows: Email, Phone, First name, Last name, Primary Address,
Secondary Address, Zip Code, City, Country, State.
• Cabal specific fields: Birth Date, Consumer Reference, and National ID.
To process a Cencosud transaction with the Virtual Terminal, please click on the Virtual
Terminal button and click on the Cencosud link. Some basic details will be needed to
process a Cencosud transaction.
For the Cencosud method and due to the asynchronous design, the following fields /
addresses must be filled: notification_url, return_success_url and return_failure_url.
The rest of the details are filled in the respective sections:
• Customer information and Billing Address – These are the sections where the
specific customer information is filled. Those may vary from optional to
mandatory, depending on the account configuration. The possible fields in this
section are as follows: Email, Phone, First name, Last name, Primary Address,
Secondary Address, Zip Code, City, Country, State.
• Cencosud specific fields: Birth Date, Consumer Reference, and National ID.
9.85. Hipercard
To process a Hipercard transaction with the Virtual Terminal, please click on the Virtual
Terminal button and click on the Hipercard link. Some basic details will be needed to
process a Hipercard transaction.
For the Hipercard method and due to the asynchronous design, the following fields /
addresses must be filled: notification_url, return_success_url and return_failure_url.
The rest of the details are filled in the respective sections:
• Customer information and Billing Address – These are the sections where the
specific customer information is filled. Those may vary from optional to
mandatory, depending on the account configuration. The possible fields in this
section are as follows: Email, Phone, First name, Last name, Primary Address,
Secondary Address, Zip Code, City, Country, State.
• Hipercard specific fields: Birth Date, Consumer Reference, and National ID.
To process an Elo transaction with the Virtual Terminal, please click on the Virtual
Terminal button and click on the Elo link. Some basic details will be needed to process
an Elo transaction.
For the Elo method and due to the asynchronous design, the following fields / addresses
must be filled: notification_url, return_success_url and return_failure_url.
The rest of the details are filled in the respective sections:
• Customer information and Billing Address – These are the sections where the
specific customer information is filled. Those may vary from optional to
mandatory, depending on the account configuration. The possible fields in this
section are as follows: Email, Phone, First name, Last name, Primary Address,
Secondary Address, Zip Code, City, Country, State.
• Elo specific fields: Birth Date, Consumer Reference, and National ID.
9.87. Aura
To process an Aura transaction with the Virtual Terminal, please click on the Virtual
Terminal button and click on the Aura link. Some basic details will be needed to process
an Aura transaction.
For the Aura method and due to the asynchronous design, the following fields / addresses
must be filled: notification_url, return_success_url and return_failure_url.
The rest of the details are filled in the respective sections:
• Customer information and Billing Address – These are the sections where the
specific customer information is filled. Those may vary from optional to
mandatory, depending on the account configuration. The possible fields in this
section are as follows: Email, Phone, First name, Last name, Primary Address,
Secondary Address, Zip Code, City, Country, State.
• Aura specific fields: Birth Date, Consumer Reference, and National ID.
To process an Astropay Card transaction with the Virtual, Terminal please click on the
Virtual Terminal button and click on the Astropay Card link. Some basic details will be
needed to process an Astropay Card transaction.
For the Astropay Card method and due to the asynchronous design, the following fields /
addresses must be filled: notification_url, return_success_url and return_failure_url.
The rest of the details are filled in the respective sections:
• Customer information and Billing Address – These are the sections where the
specific customer information is filled. Those may vary from optional to
mandatory, depending on the account configuration. The possible fields in this
section are as follows: Email, Phone, First name, Last name, Primary Address,
Secondary Address, Zip Code, City, Country, State.
• Astropay Card specific fields: Consumer Reference.
To process a Banco Itaú transaction with the Virtual Terminal, please click on the Virtual
Terminal button and click on the Banco Itaú link. Some basic details will be needed to
process a Banco Itaú transaction.
For the Banco Itaú method and due to the asynchronous design, the following fields /
addresses must be filled: notification_url, return_success_url and return_failure_url.
The rest of the details are filled in the respective sections:
• Customer information and Billing Address – These are the sections where the
specific customer information is filled. Those may vary from optional to
mandatory, depending on the account configuration. The possible fields in this
section are as follows: Email, Phone, First name, Last name, Primary Address,
Secondary Address, Zip Code, City, Country, State.
• Banco Itaú specific fields: Birth Date, Consumer Reference, and National ID.
To process a Bradesco transaction with the Virtual Terminal, please click on the Virtual
Terminal button and click on the Bradesco link. Some basic details will be needed to
process a Bradesco transaction.
For the Bradesco method and due to the asynchronous design, the following fields /
addresses must be filled: notification_url, return_success_url and return_failure_url.
The rest of the details are filled in the respective sections:
• Customer information and Billing Address – These are the sections where the
specific customer information is filled. Those may vary from optional to
mandatory, depending on the account configuration. The possible fields in this
section are as follows: Email, Phone, First name, Last name, Primary Address,
Secondary Address, Zip Code, City, Country, State.
• Bradesco specific fields: Birth Date, Consumer Reference, and National ID.
To process a Tarjeta Shopping transaction with the Virtual Terminal, please click on the
Virtual Terminal button and click on the Tarjeta Shopping link. Some basic details will
be needed to process a Tarjeta Shopping transaction.
For the Tarjeta Shopping method and due to the asynchronous design, the following
fields / addresses must be filled: notification_url, return_success_url and
return_failure_url.
The rest of the details are filled in the respective sections:
• Customer information and Billing Address – These are the sections where the
specific customer information is filled. Those may vary from optional to
mandatory, depending on the account configuration. The possible fields in this
section are as follows: Email, Phone, First name, Last name, Primary Address,
Secondary Address, Zip Code, City, Country, State.
To process a BBVA Bancomer transaction with the Virtual Terminal, please click on the
Virtual Terminal button and click on the BBVA Bancomer link. Some basic details will
be needed to process a BBVA Bancomer transaction.
For the BBVA Bancomer method and due to the asynchronous design, the following
fields / addresses must be filled: notification_url, return_success_url and
return_failure_url.
The rest of the details are filled in the respective sections:
• Customer information and Billing Address – These are the sections where the
specific customer information is filled. Those may vary from optional to
mandatory, depending on the account configuration. The possible fields in this
section are as follows: Email, Phone, First name, Last name, Primary Address,
Secondary Address, Zip Code, City, Country, State.
• BBVA Bancomer specific fields: Birth Date, Consumer Reference, and National
ID.
To process a Boleto Bancario transaction with the Virtual Terminal, please click on the
Virtual Terminal button and click on the Boleto Bancario link. Some basic details will be
needed to process a Boleto Bancario transaction.
For the Boleto Bancario method and due to the asynchronous design, the following fields
/ addresses must be filled: notification_url, return_success_url and return_failure_url.
The rest of the details are filled in the respective sections:
9.94. Redpagos
To process a Redpagos transaction with the Virtual Terminal, please click on the Virtual
Terminal button and click on the Redpagos link. Some basic details will be needed to
process a Redpagos transaction.
For the Redpagos method and due to the asynchronous design, the following fields /
addresses must be filled: notification_url, return_success_url and return_failure_url.
The rest of the details are filled in the respective sections:
• Customer information and Billing Address – These are the sections where the
specific customer information is filled. Those may vary from optional to
mandatory, depending on the account configuration. The possible fields in this
section are as follows: Email, Phone, First name, Last name, Primary Address,
Secondary Address, Zip Code, City, Country, State.
• Redpagos specific fields: Birth Date, Consumer Reference, and National ID.
9.95. Santander
To process a Santander transaction with the Virtual Terminal, please click on the Virtual
Terminal button and click on the Santander link. Some basic details will be needed to
process a Santander transaction.
For the Santander method and due to the asynchronous design, the following fields /
addresses must be filled: notification_url, return_success_url and return_failure_url.
The rest of the details are filled in the respective sections:
To process a Santander Cash transaction with the Virtual Terminal, please click on the
Virtual Terminal button and click on the Santander Cash link. Some basic details will be
needed to process a Santander Cash transaction.
For the Santander Cash method and due to the asynchronous design, the following fields
/ addresses must be filled: notification_url, return_success_url and return_failure_url.
The rest of the details are filled in the respective sections:
• Customer information and Billing Address – These are the sections where the
specific customer information is filled. Those may vary from optional to
mandatory, depending on the account configuration. The possible fields in this
section are as follows: Email, Phone, First name, Last name, Primary Address,
Secondary Address, Zip Code, City, Country, State.
• Santander Cash specific fields: Birth Date, Consumer Reference, and National
ID.
9.97. Baloto
To process a Baloto transaction with the Virtual Terminal, please click on the Virtual
Terminal button and click on the Baloto link. Some basic details will be needed to
process a Baloto transaction.
For the Baloto method and due to the asynchronous design, the following fields /
addresses must be filled: notification_url, return_success_url and return_failure_url.
• Customer information and Billing Address – These are the sections where the
specific customer information is filled. Those may vary from optional to
mandatory, depending on the account configuration. The possible fields in this
section are as follows: Email, Phone, First name, Last name, Primary Address,
Secondary Address, Zip Code, City, Country, State.
• Baloto specific fields: Birth Date, Consumer Reference, and National ID.
To process an Empresa de Energia transaction with the Virtual Terminal, please click on
the Virtual Terminal button and click on the Empresa de Energia link. Some basic details
will be needed to process an Empresa de Energia transaction.
For the Empresa de Energia method and due to the asynchronous design, the following
fields / addresses must be filled: notification_url, return_success_url and
return_failure_url.
The rest of the details are filled in the respective sections:
• Customer information and Billing Address – These are the sections where the
specific customer information is filled. Those may vary from optional to
mandatory, depending on the account configuration. The possible fields in this
section are as follows: Email, Phone, First name, Last name, Primary Address,
Secondary Address, Zip Code, City, Country, State.
• Empresa de Energia specific fields: Birth Date, Consumer Reference, and
National ID.
• Customer information and Billing Address – These are the sections where the
specific customer information is filled. Those may vary from optional to
mandatory, depending on the account configuration. The possible fields in this
section are as follows: Email, Phone, First name, Last name, Primary Address,
Secondary Address, Zip Code, City, Country, State.
• Banco de Occidente specific fields: Birth Date, Consumer Reference, and
National ID.
To process a Banco do Brasil transaction with the Virtual Terminal, please click on the
Virtual Terminal button and click on the Banco do Brasil link. Some basic details will be
needed to process a Banco do Brasil transaction.
For the Banco do Brasil method and due to the asynchronous design, the following fields
/ addresses must be filled: notification_url, return_success_url and return_failure_url.
The rest of the details are filled in the respective sections:
• Customer information and Billing Address – These are the sections where the
specific customer information is filled. Those may vary from optional to
mandatory, depending on the account configuration. The possible fields in this
section are as follows: Email, Phone, First name, Last name, Primary Address,
Secondary Address, Zip Code, City, Country, State.
9.101. Refund
Refund is a transaction which transfers the money back to the end customer in case the
customer is not satisfied by the service or similar case. Refund can be only initiated on
transactions with a financial impact such as Sale, Capture, Sale3D.
To perform a Refund transaction, click on the Virtual Terminal and click on Refund link.
To process the Refund, please use the unique_id from a financial transaction and input it
in the field reference_id.
If the Refund is successful a message showing that the refund was successful will be
shown.
9.102. Void
Void can be used for cancelling the transactions from the following types: authorize,
capture, sale, refund, recurring sale, init recurring sale within the current day.
To Void a transaction via the Virtual Terminal, please click on the Virtual Terminal
button and then click the Void link.
To Void a transaction, please use the unique_id from the above listed transaction types
and input it in the field reference_id.
If the Void is successful a message showing that the void was successful will be shown.
Pay By Link is a payment method which provides merchants the possibility to send a
payment link to a customer via email or SMS (configurable). The option is available
through Virtual Terminal, where the merchant can generate a Pay By Link payment (if
the feature is enabled).
At the bottom of the page is where choosing which transaction type will be used, whether
the customer will have the option to pay later, or to receive payment reminders to
complete the purchase.
The customer can complete the payment by following the link that he has been provided
with. The URL redirects to the merchant’s WPF where the redirection workflows are the
same as the ones provided in the WPF section. For checking the status of any Pay By
Link initiated payment, the WPF reconcile API could be used.
Google Pay is an online payment system developed by Google. To process a Google Pay
transaction via Virtual Terminal, you just need to navigate to the Virtual Terminal section
and then click on Google Pay. The merchant needs to select an appropriate terminal that
supports Google Pay, set the transaction amount, and then select the desired payment
type (Authorize, Recurring or Sale).
Google Pay requests a token to represent the card a user is trying to add from the bank
which issued that card. Once the token is issued, this card is now “tokenised”. Google
Pay sends the encrypted cardholder and payment information to the Merchant and then
the token needs to be entered in the Payment token field.
The rest of the information is customer specific - Customer Information (Email and
Phone) and Billing Address (First Name, Last Name, Primary Address, Secondary
Address, Zip code, City, Country, and State).
Russian Mobile Sale is an APM used to process Mobile network operator payments.
All that is required from customers is to enter their mobile number in an online shop or
application and confirm payment by SMS.
To process a Russian Mobile Sale transaction via Virtual Terminal, you just need to
navigate to the Virtual Terminal section and then click on Russian Mobile Sale.
Russian Mobile Payout is an APM used to process Mobile network operator payments.
All that is required from customers is to enter their mobile number in an online shop or
application and confirm payment by SMS.
To process a Russian Mobile Payout transaction via Virtual Terminal, you just need to
navigate to the Virtual Terminal section and then click on Russian Mobile Payout.
• Customer information and Billing Address – These are the sections where the
specific customer information is filled. Those may vary from optional to
mandatory, depending on the account configuration. The possible fields in this
section are as follows: Email, Phone, First name, Last name, Primary Address,
Secondary Address, Zip Code, City, Country, State.
• Operator – Name of the Mobile network operator which should process the
transaction - Megafon, Beeline, MTS, Tele2.
• Target - Number of the Paybill for which the transaction is intended.
9.108. Pix
Pix is the brand created by the Central Bank of Brazil (BACEN). It is a new way of
receiving/sending money. It allows payments to be made instantly 24 hours a day, every
• Customer information and Billing Address – These are the sections where the
specific customer information is filled. Those may vary from optional to
mandatory, depending on the account configuration. The possible fields in this
section are as follows: Email, Phone, First name, Last name, Primary Address,
Secondary Address, Zip Code, City, Country, State.
• PIX specific fields – Consumer Reference (Consumer reference is a unique
consumer identifier) and Document ID (The document ID of the consumer).
9.109. eWallet
Payments to our Indian partner FSS are now possible via eWallet. It enables you to make
an eWallet transaction using one of the following wallets: Freecharge; Amazon Pay;
Phonepe. To process an eWallet transaction via Virtual Terminal, you just need to
navigate to the Virtual Terminal section and then click on eWallet. The merchant needs
to select an appropriate terminal that supports eWallet, set the transaction amount, and
populate the mandatory fields.
The mandatory fields are filled in the respective sections:
• Customer information and Billing Address – These are the sections where the
specific customer information is filled. Those may vary from optional to
mandatory, depending on the account configuration. The possible fields in this
section are as follows: Email, Phone, First name, Last name, Primary Address,
Secondary Address, Zip Code, City, Country, State.
10.Blacklists
We can blacklist a particular value for a merchant by making an ‘Add entry’. This means
that if the transaction data contains the data defined in the blacklist, the filter will be
triggered if added for the terminal. By using the blacklist filters fraudulent transactions
might be prevented from passing successfully through our gateway. Another function of
the “Blacklist” tool is to search in the blacklist database.
10.1. Blacklists
From the index page of the blacklist page, you could search for current entries in the
blacklist database. You can delete blacklist entries by first clicking on the “Actions”
button ( ) and then on the “Delete” button ( ). This action should be
done with caution. From the button “Export Files”, you can export the blacklist database
into a CSV or Excel file format.
• Name – This is the name of the particular blacklist type of entry, it can be: bin,
bin_name, bin_phone, card subtype, card type, country, email, first_name,
forwarded_ip, IBAN, last_name, mac_address, pan, pan_tail, password, phone,
region class, remote_ip, serial_number, session_id, ssn, user_id, user_level,
username.
• Value
• Date range From – To
• Merchant
• Masked PAN
• Terminal
• Created by
• Comment
*Note: Blacklist entries with comments which have a transaction ID associated are now
links and lead to the actual transaction.
• Name - This is the name of the particular blacklist type of entry, it can be: bin,
bin_name, bin_phone, card subtype, card type, country, email, first_name,
forwarded_ip, IBAN, last_name, mac_address, pan, pan_tail, password, phone,
region class, remote_ip, serial_number, session_id, ssn, user_id, user_level,
username.
• Value – This is the value of the particular entry; it depends on the type of entry
you have chosen to add.
• Comment – If you want to add any comment for later reviews.
• Blacklist Owner – Shows you a list with all available merchants/terminals –
select one to be an owner.
10.3. Stats
Shows a statistic of how many entries per entity are currently available in the blacklist
database.
You can import new entries into the blacklist database via file imports. This is very
helpful when you want to add a big number of new entries to the blacklist. First, click on
the “Browse” button and choose the file you want to import from your computer. After
you load the file click on the button “Upload Blacklists” to import the file entries.
The fields of the file must be separated using the character “;” (semicolon). The first line
of the file should contain a header with the name of the fields:
- Header: “type;owner_type;owner_id;name;value”
The next lines should contain the information of the entry that will be added to the
blacklist. Following are the possible values:
- Type: “w”
- Owner_type: “Merchant”
- Owner_id: the ID of the merchant entity. It can be found by going to the left-hand
menu Configuration -> Merchants and then choosing the appropriate merchant.
The table with the details that will be shown contains the ID.
From this tab, you can find and download any CSV or Excel exports of the blacklist
database you have made previously, so you do not have to re-generate and export them
again.
11.Whitelists
We can whitelist a particular value for a merchant by making an ‘Add entry’. By using
the whitelist, we can allow trusted cardholders to pass successfully through the gateway
while they are in the scope of a blacklist entry. Another function of the “Whitelists” tool
is to search in the whitelist database.
11.1. Whitelists
Note: All PANs are shown as hashed due to the PCI DSS regulations.
• Name – This is the name of the particular blacklist type of entry, it can be: bin,
bin_name, bin_phone, card subtype, card type, country, email, first_name,
forwarded_ip, IBAN, last_name, mac_address, pan, pan_tail, password, phone,
region class, remote_ip, serial_number, session_id, ssn, user_id, user_level,
username.
• Value
• Date range From – To
• Merchant
• Masked PAN
From this tab of the Whitelists functionality, you can add new entries to it. All the entries
added will be tied to your available merchants or terminals. The following fields are
present for it:
• Name - This is the name of the particular whitelist type of entry, it can be: bin,
bin_name, bin_phone, country, email, first_name, forwarded_ip, last_name,
mac_address, pan, pan_tail, password, phone, remote_ip, serial_number,
session_id, ssn, user_id, user_level, username.
• Value – This is the value of the particular entry; it depends on the type of entry
you have chosen to add.
• Comment – If you want to add any comment for later reviews.
• Whitelist Owner – Shows you a list with all available merchants/terminals –
select one to be an owner.
11.3. Stats
Shows a statistic of how many entries per entity are currently available in the whitelist
database.
You can import new entries into the whitelist database via file imports. This is very
helpful when you want to add a big number of new entries to the whitelist. First, click on
the “Browse” button and choose the file you want to import from your computer, after
you load the file click on the button “Upload Blacklists” to import the file entries.
The fields of the file must be separated using the character “;” (semicolon). The first line
of the file should contain a header with the name of the fields:
- Header: “type;owner_type;owner_id;name;value”
The next lines should contain the information of the entry that will be added to the
whitelist. Following are the possible values:
- Type: “w”
- Owner_type: “Merchant”
- Owner_id: the ID of the merchant entity. It can be found by going to the left-hand
menu Configuration -> Merchants and then choosing the appropriate merchant.
The table with the details that will be shown contains the ID.
From this tab, you can find and download any CSV or Excel exports of the whitelist
database you have made previously, so you do not have to re-generate and export them
again.
12.Risk Management
This tab contains Chargebacks, Retrieval Requests, SAFE, TC40 that have been imported
into Genesis from Omnipay.
12.1. Chargebacks
The Chargebacks functionality gives you the ability to search for particular chargebacks
and filter the results by choosing different search criteria. You can export the found
chargeback data into CSV or Excel file formats by clicking on the button “Export Files”.
Search options:
• ARN
• Item type – this is the type of chargeback record: 1st chargeback, 2nd chargeback,
1st chargeback reversal, 2nd chargeback reversal, transfer reversal, re-
presentment, chargeback transfer to merchant acc, chargeback transfer to writeoff
account acq, chargeback to payment account retail.
If you want to open a particular chargeback for more information, please click on the
Action>>View Details button.
The Retrieval Requests functionality gives you the ability to search for particular
retrieval requests and filter the results by choosing different search criteria. You can
export the found retrieval requests data into CSV or Excel file formats by clicking on the
button “Export Files”.
Search options:
• ARN
• Merchants
• Original transaction date From – To
• Post date From – To
• Import date From - To
• Add search filter – Reseller subtype, Reason code, Transaction ID
12.3. SAFE
The SAFE functionality gives you the ability to search for particular fraud SAFE data
and filter the results by choosing different search criteria. You can export the found
retrieval requests data into CSV or Excel file formats by clicking on the button “Export
Files”.
Search options:
• ARN
• Merchant
• Fraud type – Lost, Stolen, Card Not Received as Issued, Fraudulent Application,
Issuer-Reported Counterfeit, Account Takeover, Card Not Present, Multiple
Imprint Fraud, Best-out Collusive Merchant, Acquirer-reported counterfeit
• Transaction date From – To
• Add search filter – Amount, Currency, Reseller subtype
The TC40 functionality gives you the ability to search for particular fraud TC40 data and
filter the results by choosing different search criteria. You can export the found retrieval
requests data into CSV or Excel file formats by clicking on the button “Export Files”.
Search options:
• ARN
• Merchant
• Fraud type – Lost, Stolen, Card Not Received as Issued, Fraudulent Application,
Issuer-Reported Counterfeit, Account Takeover, Card Not Present, Multiple
Imprint Fraud, Best-out Collusive Merchant, Acquirer-reported counterfeit
• Purchase date From – To
• Add search filter – Amount, Currency, Reseller subtype
From this tab you can find and download any CSV or Excel exports of the blacklist
database you have made previously, so you don’t have to re-generate and export them
again.
13.Billing
After successful login, please navigate to “Billing” from the left menu panel. Under
Billing menu, you can find and export Interchange Details and PayCommerce Batches
Interchange details could be filtered by various conditions – after expanding the Search
area search criteria could be applied.
You can click on “Show Transaction” to view Payment Transaction Details. By clicking
on “Toggle” you can see details of why the transaction has Failed.
Filtered data from Interchange details could be exported both in CSV and xls format.
Generated files could be found and downloaded from the Export Files section under the
Billing menu.
14.Users
This is the section where we can edit, configure, and create more users to be able to
access the Merchant user consoles by certain procedures.
Once you log in to the Merchant console with administrative privilege you need to click
on the Users tab, and you will be redirected to the Users section.
• Once you are on the Merchant users page simply click on the “New User” button
( )
• The Create user form is displayed.
• Here you need to fill in the required fields such as: Login, Email, First and Last
name
• Under the Role field, select the role that you want to apply for that user
• Under the Merchant field, select the Merchant to which this user will be assigned
• Select the Transaction types (Virtual Terminals) that you would like to have
enabled for the user
• Select if the user can make Exports or not.
• Two factor Authentication allows to enable 2FA for the user, which upon first log
in will be prompted to scan a QR code with a third-party authentication
application of their choosing.
Once the 2FA is activated for the user, upon every log in attempt the user will be
prompted to enter an OTP from the authentication application.
The “Edit” button ( ) is available on the Users form as well under the “Actions”
button ( ), where you will also find the “Delete” function ( ).