Ukrcard en
    Ukrcard en
    • Overview
    • Integration
    • Recipes
    • General Concepts
    • Merchant dashboard
    • References
      • Transaction processing flows
      • Response Codes
      • Test Data
    • Our Restful API
      • E-Commerce acquiring
        • /Payment
        • /Preauthorization
        • /CancelPreauthorization
        • /Completion
        • /Confirm
        • /ConfirmExt
        • /Reverse
        • /Refund
        • /Verify
      • Transfers
        • /р2рTransfer
        • /Confirm
        • /ConfirmExt
        • /Reverse
        • /Refund
        • /Verify
      • Cards and accounts (UAPI)
        • cards/{PanID}
        • 3. PUT changeCardLimit-baseparam/limits/
      • Payment transactions using tokens
        • /Payment
        • /Preauthorization
        • /Confirm
        • /ConfirmExt
        • /р2рTransfer
        • /Panbytoken
      • Apple Pay
        • /PaymentAppleD
        • /PaymentAppleE
      • Google Pay
        • /PaymentGoogleD
        • /PaymentGoogleE

    General Concepts

    Подивится українською

    One-step and two-step payment#

    One-step payment – a transaction for payment of goods/services made using bank cards, which does not require additional confirmation (one request initiates simultaneous blocking and debiting of funds from the card).
    A two-step payment (delayed) purchase consists of two consecutive parts:
    pre-authorisation
    completion
    Pre-authorization blocks the amount of funds on the client's account. Blocked funds must be debited or unblocked in full or in part no later than 30 calendar days for MPS Mastercard cards and no later than 7 calendar days for MPS Visa cards.
    Completion of the transaction performs a financial write-off of the full amount or part of the blocked funds. The amount of the final transaction must not exceed the amount of the previous authorization.
    Two-stage payment is widely used in the field of trade and services, where advance booking (hotels, equipment and car rental services) or purchase of goods with subsequent delivery (online stores, delivery services) is used.
    In the case of using the Two-stage payment service, you should pay attention to the rules of cancellation and returns, which differ from the general rules of other services.

    PCI DSS#

    The Payment Card Industry Data Security Standard (PCI DSS) is an information security standard for organisations that handle payment information such as credit card details.
    Please note that if you plan to collect your customer's card details within your environment and send it to our API, you must ensure that your system components are PCI DSS compliant. This is particularly important if you plan to store any of the information.
    To avoid having to worry about PCI DSS, we recommend using the Checkout pages of PSPs already integrated with us (list), which are ready-made payment processing solutions without the need to process or store payment information, or use our Checkout product.

    Common terms#

    Issuer - The bank, credit union or other financial institution that issues credit and debit cards to consumers. Once a card transaction has started and routed to the issuer through the card scheme, the issuing bank will have to determine whether they have enough funds or credit to cover the amount requested. If the transaction is authorised, they are responsible for billing the cardholder for his purchases.
    Acquirer - The financial institutions that connect merchants with card schemes by routing the card transaction through the relevant scheme. Also known as an acquiring bank.
    Client - system or person interacting with the payment gateway.
    Payer — a natural or legal person who makes a payment with his card for the services of a merchant in payment gateway.
    Order - the elementary essence of the payment gateway describing an order in some online store or its analogue.
    One-step payment —One-step payment – a transaction for payment of goods/services made using bank cards, which does not require additional confirmation (one request initiates simultaneous blocking and debiting of funds from the card). This type of payment is preferable if the product or service is provided immediately after payment.
    Two-step payment — transaction for payment of goods/services that requires additional confirmation (Completion), i.e. payment is made in two stages. At the first stage, the availability and blocking of the payer's funds is checked (pre-authorization); then, in the second stage, the company either confirms the need to write off funds or cancels the blocking of funds. The debit amount may differ slightly from the blocking amount.
    Hold (Blocking funds) - The state of the amount of funds intended for reimbursement of the transaction, from the moment of successful authorization to the moment of completion of settlements between participating banks. At this stage, the funds are still in the payer's account, but are no longer available for use on the card.
    Refund — Refund is a financial transaction where a previously processed payment is reversed, and funds are returned to the customer. Typically initiated by a merchant, a refund can be triggered for various reasons, such as product returns, cancellations, or resolution of disputes.
    Reversal — A payment reversal is the return of funds to a cardholder's bank account. Payment reversals can be initiated for various reasons, such as fraud, out-of-stock items, funds taken out for the wrong amount, or product returns.
    3D Secure (3DS) — protocol of additional authentication of the Payer, based on the concept of three domains: acquirer, issuer and compatibility. 3D Secure (3DS) is an additional layer of security in online credit and debit card transactions. This protocol is designed to authenticate the cardholder's identity during the payment process, reducing the risk of unauthorized transactions and fraud liability for merchants and issuers. The process involves three key participants - a cardholder, a merchant, and an issuer. Once customers enter their card details, they are redirected to a page where they must enter a one-time code sent to their mobile or email.

    Electronic Commerce Indicator (ECI)#

    Electronic Commerce Indicator (ECI) is a figure provided by the Directory Server and the Access Control System (ACS). It signifies the result of the authentication request made for 3DS transactions. This ECI value serves as a guide for merchants, helping them decide whether to move forward with a transaction.
    Basically, standard credit card authorizations are accompanied by a string of numbers either approving or denying the transaction. ECI indicators are like an extra authorization step that incorporates 3DS technology into the checkout process.
    ECI indicators appear as simple two-digit codes. However, the codes can vary from one card network to the next, as we’ll see below.

    Increasing payment conversion#

    In the field of e-commerce, conversion is one of the most important indicators. With correct integration and an intuitive client interface, one of the main ways to improve performance is to transfer additional parameters, increasing the probability of working with frictionless flow.
    Additional parameters allow you to obtain more complete information about customers and their payment transactions, allowing you to significantly reduce the risks of fraud and eliminate excessive blocking of transactions by the Issuing Bank. The transfer of additional parameters is available during order registration and in payment services in the jsonParams or additionalParameters blocks according to the description of the service documentation.
    Previous
    Recipes
    Next
    Merchant dashboard
    Built with