.. _manager_endpoint_bnb:

Buy Now Button
##############

.. toctree::
  :maxdepth: 1

.. contents::
  :local:

.. role:: ex

.. role:: code



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:
 • Go to :ex:`API fields` on the proper Endpoint.
 • Mark each needed :ex:`API field` as :ex:`Visible` and/or :ex:`Required`.
 • 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.