Web Services

Search…
Web Services
To call any of the below API you need to create an object of class PayUWebServiceResponse and call the respective methods, you will get the result in completion handler of the method. If there is any error in the parameters passed by merchant then it will give the error in errorMessage string else you will get the parsed object.
1
PayUWebServiceResponse *webServiceResponse = [PayUWebServiceResponse new];
Copied!
1 Fetch Payment Option
This API will give payment option enabled for merchant and saved card.
To integrate this API call the method getPayUPaymentRelatedDetailForMobileSDK as below:
1
[webServiceResponse getPayUPaymentRelatedDetailForMobileSDK:self.paymentParamForPassing withCompletionBlock:^(PayUModelPaymentRelatedDetail *paymentRelatedDetails, NSString *errorMessage, id extraParam) {
2
​
3
if (errorMessage) {
4
    // Something went wrong errorMessage is having the Detail
5
}else{
6
    // It is good to go & paymentRelatedDetails  is having the full detail of it
7
}
8
}];
Copied!
Note:
1.paymentRelatedDetails.availablePaymentOptionsArray gives you all the available payment options for you.
2.paymentRelatedDetails.oneTapStoredCardArray, paymentRelatedDetails.storedCardArray, paymentRelatedDetails.netBankingArray, paymentRelatedDetails.cashCardArray, paymentRelatedDetails.EMIArray, paymentRelatedDetails.NoCostEMIArray gives available OneTapCard,StoredCard, NetBanking, CashCard, EMI and NoCostEMI
2 VAS
This API is used to get the list of down NetBanking and down cardbin
To integrate this API call the method callVASForMobileSDKWithPaymentParam as below
1
[webServiceResponse callVASForMobileSDKWithPaymentParam:self.paymentParamForPassing];
Copied!
Now to check whether the particular NetBanking is down or not just pass the bankCode or cardbin (first 6 digit of cardnumber) to it and in completionBlock you will get the response as below
1
[webServiceResponse getVASStatusForCardBinOrBankCode:@"AXIB" withCompletionBlock:^(id ResponseMessage, NSString *errorMessage, id extraParam) {
2
    	if (errorMessage == nil) {
3
        		if (ResponseMessage == nil) {
4
			        // It means given NetBanking code or cardnumber is not down i.e. it is in good to go condition
5
        		}else{
6
            		NSString * responseMessage = [NSString new];
7
            		responseMessage = (NSString *) ResponseMessage;
8
			        // It means given NetBanking code or cardnumber is down and you can display the responseMessage if you want or you can customize it
9
        		}
10
    	}else{
11
		    // Something went wrong errorMessage is having the Detail
12
    	}
13
	}];
Copied!
3 Delete Store Card
This API is helpful in Deleting StoredCard.
To integrate this API call the method deleteStoredCard as below
1
[webServiceResponse deleteStoredCard:self.paymentParamForPassing withCompletionBlock:^(NSString *deleteStoredCardStatus, NSString *deleteStoredCardMessage, NSString *errorMessage, id extraParam) {
2
            if (errorMessage) {
3
        // Something went wrong errorMessage is having the Detail
4
            }
5
            else{
6
        //It is good to go & deleteStoredCardMessage is having the full detail of it
7
            }
8
        }];
Copied!
4 Get Offer Status
This API is helpful in checking whether offer is available for given cardNumber or not and if available then it will return the discount amount.
To integrate this API call the method getOfferStatus as below
1
[webServiceResponse getOfferStatus:self.paymentParamForPassing withCompletionBlock:^(PayUModelOfferStatus *offerStatus, NSString *errorMessage, id extraParam) {
2
    if (errorMessage == nil) {
3
        //It is good to go & offerStatus.discount contains the discounted amount if there is any offer & offerStatus.msg contains the message why offer is not available
4
    }
5
    else{
6
        // Something went wrong errorMessage is having the Detail
7
    }
8
}];
Copied!
5 CheckOfferDetails:
This API is helpful in getting details of offerkey, whether the given offer key is valid or not. If we provide the amount to this API then this API gives the discount value also. We can use this API for payment mode such as CC/DC, StoreCard, OneTap Card and NetBanking To integrate this API call the method getOfferDetails
5.1 For CCDC:
Set the cardnumber in paymentParamForPassing object as below:
1
self.paymentParamForPassing.cardNumber = @”5123456789012346”;
2
self.paymentParamForPassing.hashes.offerDetailsHash = @"hash";
Copied!
After setting cardNumber call the method getOfferDetails by passing second parameter as PAYMENT_PG_CCDC as below:
1
[webServiceResponse
2
getOfferDetails:self.paymentParamForPassing forPaymentType:PAYMENT_PG_CCDC withCompletionBlock:^(PayUModelOfferDetails *offerDetails, NSString *errorMessage, id extraParam) {
3
      if (errorMessage) {
4
        // Something went wrong errorMessage is having the Detail
5
      }
6
      else{
7
        // offerDetails object is having the detail of the offer key
8
      }
9
    }];
Copied!
5.2 For StoredCard/OneTapCard:
If merchant want to check offer for one particular storedcard then set the cardtoken as below:
1
self.paymentParamForPassing.cardToken = @”643567vbhbvgh5678gvv77b”;
2
self.paymentParamForPassing.hashes.offerDetailsHash = @"hash";
Copied!
If merchant want to check offer for all storedcard then set cardToken as empty or nil:
1
    self.paymentParamForPassing.cardToken = nil;
2
    self.paymentParamForPassing.hashes.offerDetailsHash = @"hash";
Copied!
Note: For StoredCard/OneTapCard, you must set userCredentials inside your payment params After setting cardToken call the method getOfferDetails by passing second parameter as PAYMENT_PG_STOREDCARD as below:
1
[webServiceResponse
2
getOfferDetails:self.paymentParamForPassing forPaymentType:PAYMENT_PG_STOREDCARD withCompletionBlock:^(PayUModelOfferDetails *offerDetails, NSString *errorMessage, id extraParam) {
3
      if (errorMessage) {
4
        // Something went wrong errorMessage is having the Detail
5
      }
6
      else{
7
        // offerDetails object is having the detail of the offer key
8
      }
9
    }];    
Copied!
5.3 For NetBanking:
In case merchants want to know whether any particular Net Banking is eligible for offer then set the bankcode as below:
1
    self.paymentParamForPassing.bankCode = @”AXIB”;
2
    self.paymentParamForPassing.hashes.offerDetailsHash = @"hash";
Copied!
In case Merchant wants to know the list of net bankings which are eligible for any particular Offer then set bankCode as nil or empty as below:
1
    self.paymentParamForPassing.bankCode = nil;
2
    self.paymentParamForPassing.hashes.offerDetailsHash = @"hash";
Copied!
After setting bankcode call the method getOfferDetails by passing second parameter as PAYMENT_PG_NET_BANKING as below:
1
[webServiceResponse
2
getOfferDetails:self.paymentParamForPassing forPaymentType:PAYMENT_PG_NET_BANKING withCompletionBlock:^(PayUModelOfferDetails *offerDetails, NSString *errorMessage, id extraParam) {
3
      if (errorMessage) {
4
        // Something went wrong errorMessage is having the Detail
5
      }
6
      else{
7
        // offerDetails object is having the detail of the offer key
8
      }
9
    }];
Copied!
6 GetEMIAmountAccordingToInterest:
This API is helpful in getting details of all the available EMI’s. For this API, you need to set amount in the payment params as below:
1
    self.paymentParamForPassing.amount = @"100";
2
    self.paymentParamForPassing.hashes.EMIDetailsHash = @"hash";
Copied!
To integrate this API call the method getEMIAmountAccordingToInterest as below
1
[webServiceResponse
2
getEMIAmountAccordingToInterest:self.paymentParamForPassing withCompletionBlock:^(NSDictionary *dictEMIDetails, NSString *errorMessage, id extraParam) {
3
      if (errorMessage) {
4
        // Something went wrong errorMessage is having the Detail
5
      }
6
      else{
7
        // dictEMIDetails is having the EMI detail
8
      }
9
    }];
Copied!
7 Get User Cards:
This API is helpful in getting all the Stored Card for particular user. For this API, you need to set userCredentials in the payment params as below:
1
    self.paymentParamForPassing.userCredentials = @"gtKFFx:UmangArya";
2
    self.paymentParamForPassing.hashes.getUserCardHash = @"hash";
Copied!
To integrate this API call the method getUserCards as below
1
[webServiceResponse
2
getUserCards:self.paymentParamForPassing withCompletionBlock:^(NSDictionary *dictStoredCard, NSString *errorMessage, id extraParam){
3
      if (errorMessage) {
4
        // Something went wrong errorMessage is having the Detail
5
      }
6
      else{
7
        // dictStoredCard is having all the storedcard information
8
      }
9
    }];
Copied!
8 Verify Payment:
This web-service is used to reconcile the transaction with PayU. When we post back the final response to you (merchant), we provide a list of parameters (including the status of the transaction – For example, success, failed etc). On a few occasions, the transaction response is initiated from our end, but it doesn’t reach you due to network issues or user activity (like refreshing the browser etc). We strongly recommend that this API is used to reconcile with PayU’s database once you receive the response. This will protect you from any tampering by the user and help in ensuring safe and secure transaction experience. For this API, you need to set transactionID inside your payment params as below:
1
    self.paymentParamForPassing.transactionID = @"tnxID1|txnID2|txnID3";
2
    self.paymentParamForPassing.hashes.verifyTransactionHash = @"hash";
Copied!
Multiple txnID can be sent by using pipe Symbol(|) as seprator. To integrate this API call the method verifyPayment as below
1
[webServiceResponse
2
verifyPayment:self.paymentParamForPassing withCompletionBlock:^(NSDictionary *dictVerifyPayment, NSString *errorMessage, id extraParam) {
3
      if (errorMessage) {
4
        // Something went wrong errorMessage is having the Detail
5
      }
6
      else{
7
        // dictVerifyPayment is having the verifyPayment detail
8
      }
9
    }];
Copied!
9 Edit User Card:
This API is used to edit the details of an existing stored card in the vault. Only Card Name and Name on card can be edited. For this API, you need to set following parameter in the payment params as below:
1
self.paymentParamForPassing.userCredentials = @"gtKFFx:UmangArya";
2
self.paymentParamForPassing.cardToken = @"745d72e2fd9b7e88824fef4e7ed7dac1f";
3
self.paymentParamForPassing.cardName = @"UmangHDFC";
4
self.paymentParamForPassing.cardMode = @"CC";
5
self.paymentParamForPassing.cardType = @"MAST";
6
self.paymentParamForPassing.nameOnCard = @"testHDFC";
7
self.paymentParamForPassing.cardNo = @"5123456789012346";
8
self.paymentParamForPassing.expiryMonth = @"11";
9
self.paymentParamForPassing.expiryYear = @"2019";
10
self.paymentParamForPassing.hashes.editUserCardHash = @"hash";
Copied!
To integrate this API call the method editUserCard as below
1
[webServiceResponse
2
editUserCard:self.paymentParamForPassing withCompletionBlock:^(PayUModelStoredCard *objStoredCard, NSString *errorMessage, id extraParam){
3
      if (errorMessage) {
4
        // Something went wrong errorMessage is having the Detail
5
      }
6
      else{
7
        // objStoredCard object is having the updated stored card parameters
8
      }
9
    }];
Copied!
10 Check Is Domestic:
This API is used to detect whether a particular bin number is international or domestic. It is also useful to determine the card’s issuing bank, the card type brand – i.e, Visa, Master etc and also the Card Category – i.e. Credit/Debit etc. Bin number is the first 6 digits of a Credit/Debit card. For this API, you need to set cardNumber in the payment params as below:
1
self.paymentParamForPassing.cardNumber = @"512345";
2
self.paymentParamForPassing.hashes.checkIsDomesticHash = @"hash";
Copied!
To integrate this API call the method checkIsDomestic as below
1
[webServiceResponse
2
checkIsDomestic:self.paymentParamForPassing withCompletionBlock:^(PayUModelCheckIsDomestic *checkIsDomestic, NSString *errorMessage, id extraParam) {
3
      if (errorMessage) {
4
        // Something went wrong errorMessage is having the Detail
5
      }
6
      else{
7
        // checkIsDomestic object is having the required detail
8
      }
9
    }];
Copied!
11 Get Transaction Info:
This API is used to extract the transaction details between two given time periods. The API takes the input as two dates along with time (initial and final), between which the transaction details are needed. The output would consist of the status of the API (success or failed) and all the transaction details in an array format. For this API, you need to set startTime and endTime in the payment params as below:
1
self.paymentParamForPassing.startTime = @"2014-01-12 16:00:00";
2
self.paymentParamForPassing.endTime = @"2014-01-12 16:00:50";
3
self.paymentParamForPassing.hashes.getTransactionInfoHash = @"hash";
Copied!
To integrate this API call the method getTransactionInfo as below
1
[webServiceResponse
2
getTransactionInfo:self.paymentParamForPassing withCompletionBlock:^(NSArray *arrOfGetTxnInfo, NSString *errorMessage, id extraParam) {
3
      if (errorMessage) {
4
        // Something went wrong errorMessage is having the Detail
5
      }
6
      else{
7
        // arrOfGetTxnInfo is the array of PayUModelGetTxnInfo which is having detail of transaction
8
      }
9
    }];
Copied!
12 Save User Card:
This API is used for saving a card to the vault. For this API, you need to set following parameter in the payment params as below:
1
 self.paymentParamForPassing.userCredentials = @"gtKFFx:UmangArya";
2
 self.paymentParamForPassing.cardName = @"UmangHDFC";
3
 self.paymentParamForPassing.cardMode = @"CC";
4
 self.paymentParamForPassing.cardType = @"MAST";
5
 self.paymentParamForPassing.nameOnCard = @"testHDFC";
6
 self.paymentParamForPassing.cardNo = @"5123456789012346";
7
 self.paymentParamForPassing.expiryMonth = @"11";
8
 self.paymentParamForPassing.expiryYear = @"2019";
9
 self.paymentParamForPassing.duplicateCheck = @"1";// duplicateCheck = 1 means in response you will get duplicate count otherwise not
10
 self.paymentParamForPassing.hashes.saveUserCardHash = @"hash";
Copied!
To integrate this API call the method saveUserCard as below:
1
[webServiceResponse
2
saveUserCard:self.paymentParamForPassing withCompletionBlock:^(PayUModelStoredCard *objStoredCard, NSString *errorMessage, id extraParam) {
3
      if (errorMessage) {
4
        // Something went wrong errorMessage is having the Detail
5
      }
6
      else{
7
        // objStoredCard is having the newly save card details
8
        // objStoredCard.duplicateCardCount gives the number of duplicate card found for that merchant for this card
9
      }
10
    }];

11
    
Copied!
13 GetBinInfo:
This API is used to detect whether a particular bin number is international or domestic. It is also useful to determine the card’s issuing bank, the card type brand – i.e, Visa, Master etc and also the Card Category – i.e. Credit/Debit etc. Bin number is the first 6 digits of a Credit/Debit card. This API is also helpful in knowing whether the cardbin is eligible for SI or not. For this API, you need to set cardNumber in the payment params as below
This API is used for saving a card to the vault. For this API, you need to set following parameter in the payment params as below:
1
self.paymentParamForPassing.cardNumber = @"512345";
2
// set below flag to true, to know whether the given cardBin support standing instructions
3
self.paymentParamForPassing.isSIInfo = TRUE;
4
self.paymentParamForPassing.hashes.getBinInfoHash = @"hash";
Copied!
To integrate this API call the method saveUserCard as below:
1
[webServiceResponse
2
getBinInfo:self.paymentParamForPassing withCompletionBlock:^(NSArray<PayUModelCheckIsDomestic *> *allBin, NSString *errorMessage, id extraParam) {
3
      if (errorMessage) {
4
        // Something went wrong errorMessage is having the Detail
5
      }
6
      else{
7
        // checkIsDomestic object is having the required detail
8
      }
9
    }];
Copied!
​
14 GetCheckoutDetails API:
It provides information of additionalCharges, bank down status, tax info enabled on a merchant key. Calling this API is similar like other Web Services, the only difference is that it requires a JSON in var1 as below
1
{
2
  "requestId": "1632372121462",
3
  "transactionDetails": {
4
    "amount": 5000
5
  },
6
  "customerDetails": {
7
    "mobile": "9999999999"
8
  },
9
  "filters": {
10
    "paymentOptions": {
11
      "emi": {
12
        "cardless": "ZESTMON"
13
      }
14
    }
15
  },
16
  "useCase": {
17
    "getExtendedPaymentDetails": true,
18
    "checkCustomerEligibility": true
19
  }
20
}
Copied!
here, requestId is a random unique number passed in request.
For this API you need to set amount, checkAdditionalCharges, checkDownStatus, checkTaxSpecification, checkCustomerEligibility, phoneNumber in the payment params as below:
1
self.paymentParamForPassing.checkAdditionalCharges = true;
2
self.paymentParamForPassing.checkDownStatus = true;
3
self.paymentParamForPassing.checkTaxSpecification = true;
4
self.paymentParamForPassing.checkCustomerEligibility = true;
5
self.paymentParam.phoneNumber = @"<Client's 10 digit Mobile Number>";
6
self.paymentParamForPassing.amount = @"5000";
7
self.paymentParamForPassing.hashes.getCheckoutDetailsHash = @"hash";
Copied!
To integrate this API call the method getCheckoutDetail as below:
1
[webServiceResponse
2
getCheckoutDetail:self.paymentParamForPassing withCompletionBlock:^(NSArray<PayUModelPaymentRelatedDetail *> *paymentRelatedDetails, NSString *errorMessage, id extraParam) {
3
      if (errorMessage) {
4
        // Something went wrong errorMessage is having the Detail
5
      }
6
      else{
7
        // paymentRelatedDetails object is having the required detail
8
      }
9
    }];
Copied!
15 Lookup API:
This is used when integrating Multi-Currency Payments. Follow below steps to integrate this API:
Pre-requisites
Kindly connect with your Key Account Manager at PayU to get below credentials -
1.Merchant Access Key
2.Merchant Secret Key
Create Request
Lookup Api needs a JSON request. Product Type need to be passed either as DCC or MCP. DCC means Direct Currency Conversion, i.e it returns the conversion prices for card currency only. To get all enabled currencies on Merchant Access Key along with their conversion prices, use product type as MCP. For DCC, cardBin is mandatory, while for MCP cardBin is not required
Below is example request for MCP as product type
1
{   
2
  "merchantAccessKey":"E5ABOXOWAAZNXB6JEF5Z", 
3
  "baseAmount":
4
  {     
5
    "value":10000.00,      
6
     "currency":"INR"   
7
   },   
8
    "merchantOrderId":"OBE-JU89-13151-110",   
9
    "productType":"MCP",   
10
    "signature":"be5a56667354d9e2ea5ea1c6af78b0afc1894eb2"
11
  }
Copied!
For this API you need to set total amount, lookupAPI Hash, lookuprequestId in the payment params as below:
1
self.paymentParamForPassing.amount = @"Total amount";
2
self.paymentParamForPassing.hashes.lookupApiHash = @"HMACSHA1 Signature";
3
self.paymentParamForPassing.lookupRequestId = @"Any unique id";
Copied!

PFB details for params used in Lookup API
Parameter Name
Description
Amount
Transaction Amount
Card Bin
First 6 digits of card number
Currency
Base Currency of Transaction ("INR")
Merchant Access Key
Merchant Access Key provided by PayU
Merchant OrderId
A unique request id for Lookup API request
Product Type
Use MCP to get all enabled currency on Merchant Access Key or DCC to get direct currency conversion for card currency
Signature
Hmac SHA1 hash created with formula explained below
To calculate signature, Create HmacSHA1 hash of below data
1
Signature =HMAC-SHA1(data, key);
2
Data = baseCurrency+merchantOrderId+baseAmount
3
Key = Secret Key shared with the merchant at the time of on-boarding
4
​
5
​
6
Example data = INROBE-JU89-13151-11010000.00
Copied!
To integrate this API call the method mcpLookup as below:
1
[webServiceResponse
2
mcpLookup:self.paymentParamForPassing withCompletionBlock:^(PayUModelMultiCurrencyPayment *paymentRelatedDetails, NSString *errorMessage, id extraParam) {
3
      if (errorMessage) {
4
        // Something went wrong errorMessage is having the Detail
5
      }
6
      else{
7
        // PayUModelMultiCurrencyPayment object is having the required detail
8
      }
9
}];
Copied!
16 Check Sodexo Card Balance:
This can be used to fetch detail of Sodexo card with source id
1
self.paymentParamForPassing.sodexoSourceId = @"<Sodexo source id>;
2
self.paymentParamForPassing.hashes.checkBalanceApiHash =  @"hash";
Copied!
​
To integrate this API call the method fetchSodexoCardDetails as below:
1
[webServiceResponse
2
fetchSodexoCardDetails.paymentParamForPassing withCompletionBlock:^(PayUModelSodexoCardDetail *sodexoCardDetail, NSString *errorMessage, id extraParam) {
3
      if (errorMessage) {
4
        // Something went wrong errorMessage is having the Detail
5
      }
6
      else{
7
        // sodexoCardDetail object is having the required detail
8
      }
9
    }];
Copied!
Hash Calculation
Hash formula for check balance is
1
    sha512(key|check_balance|{"sodexoSourceId":"<sodexoSouceId>"}|SALT)
Copied!
​
Seamless
Objective C-Non-Seamless
Last modified 10d ago
Copy link
Contents
Pre-requisites
Create Request