.. _endpoints: Endpoints ######### .. toctree:: :maxdepth: 1 .. contents:: :local: .. role:: ex .. role:: code Endpoint is uniquely identified terminal in Payment Gateway, which is assigned to the Merchant and has to be provided in the commands within Payment Gateway API. Endpoint search and KPI ======================= .. |g| image:: ../_static/images/10/pic100new.png .. |h| image:: ../_static/images/10/pic101new.png | This screen contains all Endpoints created for the Merchant in the system: | .. figure:: ../_static/images/10/endnew.png :scale: 70 % :align: center :alt: pic102 merchant faq | | |g| The Endpoint is enabled. | |h| The Endpoint is disabled. | | In case of a large amount of Endpoints, search can be used: | .. image:: ../_static/images/10/spnew.png :width: 750 :align: center :alt: pic103 merchant faq | | In order to monitor Endpoint activity, Key Performance Indicators (KPI) are used, such as Merchant earnings and others. | The KPI submenu opens by pressing the :ex:`Detailed` button on the Endpoint search screen. See details in :ref:`kpi`. | Click on the Endpoint name to open the detailed information about this Endpoint. Endpoint details ================= | Endpoint details screen contains information about configured options on this Endpoint, its ID, limits and linked Project. The Endpoint inherits its currency from the Project it's linked to. | It is important to note that the Endpoint settings (such as limits, payment forms, client definition, etc) override the Project settings. | To view the filters configured on the Endpoint, use the "Fraud protection filters" tab. | To view the necessity of additional fields on payment form, use the "API Fields" tab. | To work with other configuration options, see the information below. .. _endpoint_messages: Message Templates ================= | Message templates can be used to send SMS or E-mail messages to customer after each successful transaction. Merchant must provide their message server credentials to Payneteasy support manager in order to send such messages from Merchant address. Templates are created using the :ex:`Template` button. Example of filling the form: | .. figure:: ../_static/images/10/shnew.png :scale: 50 % :align: center :alt: pic105 merchant faq | | Example of a message template in the form: | .. image:: ../_static/images/10/engnew.png :width: 700 :align: center :alt: pic106 merchant faq | | |g| Message sending is enabled. | |h| Message sending is disabled. .. _endpoint_forms: Payment Form =============== It is possible to configure custom payment forms on Endpoint or Master Endpoint. For configuration please see `Forms Customization `_ in integration documentation. Provide the customized forms to Payneteasy support manager for installation. Installed form names will be visible on Endpoint details screen. .. _endpoint_callbacks: Callbacks =============== Callback can be configured at the Endpoint level by using Create Callback utility. To set up new callback, go to the bottom of Endpoint details screen and click the “Add Callback” button. There are several parameters, which can be defined in the configuration window: * Transaction type. * URL address - is the fully defined URL with all the parameters Merchant’s target page or script would require. Example: https://www.merchant.com/sale_completed. * Comment if it is required. | .. image:: ../_static/images/pic68new.png :width: 400 :align: center :alt: pic68 merchant_callback | .. _endpoint_bnb: Buy Now Button ====================== Buy Now Button integration is relevant for Merchants who has limited portfolio of products to sell. It is the easiest way to integrate with Payneteasy. This way of integration doesn’t require much technical effort. Buy Now Button integration also allows Merchant (or Connecting Party which represents Merchant) to exclude itself from storing, processing, or transmitting Payer’s cardholder data or other sensitive payment details. Such data is submitted by Payer on Payneteasy hosted customer details form and payment form in PCI DSS certified environment. Buy Now Button Setup -------------------------------- To configure Buy Now Button for Merchant’s website follow these instructions: • Find the relevant Endpoint • Go to :ex:`Buy Now Items` tab • Click :ex:`Add item` • Fill in the required fields. Buy Now Button Required Fields ---------------------------------------- .. list-table:: :widths: 20, 50, 25 :header-rows: 1 :class: longtable table-text-justify * - Parameter Name - Description - Value * - :code:`Amount` - Amount to be charged. The amount has to be specified in the highest units with :ex:`.` delimiter. For instance, :ex:`10.5` for USD means 10 US Dollars and 50 Cents. - | ``Necessity``: Required | ``Type``: Numeric | ``Length``: 10 * - :code:`Description` - The item’s description. - | ``Necessity``: Required | ``Type``: String | ``Length``: 64k * - :code:`redirect_url` - The URL to the page where the Payer will be redirected after transaction is completed. - | ``Necessity``: Required | ``Type``: String | ``Length``: 1024 * - :code:`Destination` - Destination to where the payment goes. It is useful for Merchants who let their payers to top up their accounts with bank card (Mobile phone accounts, game accounts etc.). Sample values are: :ex:`+9999999999`; :ex:`mail@example.com` etc. This value can be used by the fraud monitoring system. - | ``Necessity``: Optional | ``Type``: String | ``Length``: 128 * - :code:`Payment tool` - Payment methods. - | ``Necessity``: Optional | ``Type``: String | ``Length``: 128 Buy Now Button Payment Form Fields ------------------------------------------- To configure the fields to be shown on payment form, ask Payneteasy support manager to: 1. Go to :ex:`API fields` on the proper Endpoint. 2. Mark each needed :ex:`API field` as :ex:`Visible` and/or :ex:`Required`. 3. Save :ex:`API fields` and preview the payment form. .. warning:: | It is strictly advised to create separated Endpoints for Buy Now Button because activating this option might lead to errors with other types of integration. Also: | 1. Buttons cannot be removed, only entire Endpoint can be disabled to stop transactions via Buy Now Button. | 2. Transaction amount change on payment form will not be supported if any Buy Now Button is configured on this Endpoint. .. _endpoint_balances: Account Balance =============== Each Connecting Party has a merchant user account created in Payment Gateway. Merchant accounts can check current balances via :ex:`Common` tab on Endpoints. Balances also can be requested via API `by Endpoint `_ or `by Merchant `_. .. note:: Please contact Payneteasy support to enable this feature. See example of endpoint window with current balances below: .. image:: ../_static/images/get_balance/balancesendpoint.png :alt: balancesendpoint :align: center :width: 870