GatewayPay Documentation
    GatewayPay Documentation
    • GatewayPay API Documentation
    • Authentication
    • Callbacks
    • Testing
    • Domains and IP Addresses
    • Account
      • Get Account profile details
        GET
      • Get Account balances
        GET
      • Get Account payment options
        GET
    • H2H flow
      • Status List
      • Create Payment Invoice
        POST
      • Send Card Data to the Gateway
        POST
      • Full List of Payment Services
        GET
      • Get Service Data by ID
        GET
      • Check Status of Payment Invoice by ID
        GET
      • Get list of Payment Invoices
        GET
    • Refunds
      • Refund
        POST
    • Cards Whitelist API
      • JSON
        POST
      • CSV
        POST
    • APM - Deposits
      • Bank Transfers - Turkey
        POST
    • APM - Payouts
      • Bank Transfers - Turkey (Invoice Initiation)
        POST
      • Bank Transfers - Turkey (Invoice processing)
        POST

    H2H flow

    Host-to-host Integration for Payments#

    Organisations that meet PCI DSS requirements can use Host-to-Host (H2H) integration to accept card payments.
    Please apply a request to our support team to clarify the requirements and enable H2H payment mode for your account.

    H2H interaction scheme#

    h2h-sequence.png
    1.
    The client creates an order on the merchant's website.
    2.
    The merchant creates a payment invoice. Having received the invoice, GatewayPay:
    Initiates a transaction on the provider side
    Sends a reply with the payment's bearer token
    Sends a Callback to the merchant notifying him of the successful creation of the invoice
    3.
    Merchant displays payment form data on its side.
    4.
    The client enters payment details that the merchant sends to the GatewayPay Card Gateway. And GatewayPay forwards the debit request to the issuer.
    5.
    If an additional step of payment confirmation is required (3DSecure or another verification type), the merchant receives the data to display the verification page. The client confirms the payment, and the issuer obtains the sent data.
    6.
    The issuer returns the payment results and completes the transaction.
    7.
    The payment status is recorded and forwarded to the merchant.
    8.
    The merchant displays the payment status to the client on the pages of the website page.
    9.
    GatewayPay sends a Callback to the merchant notifying them of the payment status.
    10.
    The merchant can reconcile payment by ID or get a complete list of invoice data using a private API to check transaction status. Daily transactional reports are also available on the portal.
    Modified at 2024-10-09 10:52:17
    Previous
    Get Account payment options
    Next
    Status List
    Built with