Integration Guide

Server-to-Server

The legacy flow such as the PayU Hosted Checkout and Merchant Hosted Checkout involves intermediate browser hops. Server-to-Server (S2S) involves communication between the merchant’s server and PayU servers that operate in the backend. S2S is unlike the legacy flow, where the data is fetched through a direct call on the customer’s browser, and its progress can be witnessed through the change of the URLs.

Suggest Edits

Prerequisites for S2S workflow

The prerequisites for integrating with S2S are:

  • You must have Payment Card Industry Data Security Standard (PCI-DSS) certification, which is mandatory for all entities seeking to store, process, and transmit cardholder data.
  • Sufficient technical bandwidth dedicated to managing the end-to-end web checkout processes in-house consistently.

👍

Before you Begin:

  • PayU strongly recommends you test your integration using the test merchant Key or Salt. To create a test merchant account, refer to Register for a Merchant Account on Dashboard. After you create a test merchant account, you can access the test Key or Salt as described in Generate Merchant Key and Salt on PayU Dashboard.
  • PayU recommends you to integrate with Test environment initially. For merchants registered before August 3rd, 2023, use the following URL to sign up for the Test environment:

https://uat-onepayuonboarding.payu.in/app/account/signup

Benefits of S2S workflow

The benefits of the S2S flow are:

  • Delivers a better functional experience by eliminating intermediate browser hops that consume the customer’s internet bandwidth and procedural lags.
  • Reduces the number of jumps in the forward leg, so the S2S flow significantly reduces the probability of errors.

With the above benefits, there are reduced chances of customers abandoning shopping cart during their shopping experience.

Customer journey

The merchant server hosts the complete data sets necessary to take the customer from your website to the bank’s website and send it directly to the PayU server that operates in the backend. Unlike the Merchant Hosted Checkout integration, your customer will not be redirected to the bank site for OTP. This section describes the customer experience with S2S Flow.

To get started with Server-to-Server integration, refer to General Integration.

Step 1: The customer completes shopping at your website and initiates a transaction with card credentials.

Step 2: The customer enters the CVV and proceeds to complete the payment.

Step 3: The merchant collects the Bank OTP for authentication where the customer needs to complete the transaction by using the OTP sent by the bank to the registered mobile number.

Cards Server-to-Server integration

PayU offers the following S2S integrations to collect card payments:

📘

Note:

If you are using legacy integration of decoupled flow for S2S, refer to Legacy Flow for Server-to-Server.

UPI Server-to-Server Integration

The UPI integration for S2S in general is described in the following sections:

The UPI S2S integration for PhonePe Offers and Omnichannel is described in the following sections:

The UPI Number Mapper API describes how to get VPA for the given UPI number.

Updated about 1 month ago