Razorpay

About Razorpay:

Razor Pay is a leading payment platform offering a powerful API for seamless online transactions via cards, UPI, net banking, and wallets. It ensures quick integration, real-time tracking, and top-notch security.

Implemented Features:

Feature Level of Support
Sale Implemented
Credit Implemented
3D Secure 2 Full Integration Implemented

Authentication and Security Credentials:

  • Username – Key Id
  • Password – Key Secret

Supported Parameters:

KEY NAME FORMAT MANDATORY DESCRIPTIONS
apiVersion Numerical Required “1.0.1”
apiType Alphabetical Required “pxyhpci”
userName Alphanumeric Required API Username
userPassKey Alphanumeric Required API PassKey
pxyCreditCard.creditCardNumber Numerical Required HostedPCI Token Representing Credit Card
pxy.CreditCard.cardCodeVerification Numerical Optional HostedPCI Token Representing CVV Code
pxyCreditCard.expirationMonth Numerical Required Expiration month with 2 digits for example, for December use “12”
pxyCreditCard.expirationYear Numerical Required Expiration year with 4 digits for example, for 2025, use “2025”
pxyTransaction.txnCurISO Alphabetical Required 3 letter ISO Currency Code for example, “USD” or “CAD”
pxyTransaction.txnAmount Numerical Required Amount to Authorize, for example for $10.50 use 10.50
pxyTransaction.merchantRefId Numerical Required Merchant reference number can be order id or invoice id
pxyTransaction.txnPayName Alphanumeric Required HostedPCI payment profile name, for example “DEF”
pxyTransaction.txnComment Alphabetical Optional Short comment
pxyCustomerInfo.email Alphanumeric Optional Customer’s Email Address
pxyCustomerInfo.customerIP Numerical Optional Customer’s IP Address
pxyCustomerInfo.billingLocation.firstName Alphabetical Optional Customer’s First Name
pxyCustomerInfo.billingLocation.lastName Alphabetical Optional Customer’s Last Name
pxyCustomerInfo.billingLocation.phoneNumber Numerical Optional Billing Phone Number
pxyCustomerInfo.billingLocation.fax Numerical Optional Billing Fax Phone Number
pxyCustomerInfo.billingLocation.companyName Alphanumeric Optional Billing Company Name
pxyCustomerInfo.billingLocation.address Alphanumeric Optional Customer’s Billing Address
pxyCustomerInfo.billingLocation.city Alphabetical Optional Customer’s Billing City
pxyCustomerInfo.billingLocation.state Alphabetical Optional Customer’s Billing State or Province
pxyCustomerInfo.billingLocation.zipCode Numerical Optional Customer’s Billing Zip Code or Postal Code
pxyCustomerInfo.billingLocation.country Alphabetical Optional Customer’s Billing Country
pxyCustomerInfo.billingLocation.tax1 Numerical Optional Billing Tax 1

API Endpoint URL:

https://[HPCI_API_HOSTENAME]/iSynSApp/paymentAuth.action

API Request Body:

apiVersion=1.0.1&apiType=pxyhpci&userName=[APIuserName]&userPassKey=[APIPassKey]&pxyCreditCard.creditCardNumber=[CreditCardToken]&pxyCreditCard.cardCodeVerification=[CVVToken]&pxyCreditCard.expirationMonth=[ExpiryMonth]&pxyCreditCard.expirationYear=[ExpiryYear]&pxyTransaction.txnCurISO=[Currency]&pxyTransaction.txnAmount=[Amount]&pxyTransaction.merchantRefId=[UniqueMerchantRefID]&pxyTransaction.txnPayName=[ProfileName]&pxyTransaction.txnComment=[ShortComment]&pxyCustomerInfo.billingLocation.firstName=[CustomerFirstName]&pxyCustomerInfo.billingLocation.lastName=[CustomerLastName]&pxyCustomerInfo.billingLocation.address=[BillingStreetAddress]&pxyCustomerInfo.billingLocation.city=[BillingCity]&pxyCustomerInfo.billingLocation.state=[State/Province]&pxyCustomerInfo.billingLocation.zipCode=[ZipCode/PostalCode]&pxyCustomerInfo.billingLocation.country=[Country]&pxyCustomerInfo.shippingLocation.firstName=[ShippingFirstName]&pxyCustomerInfo.shippingLocation.lastName=[ShippingLastName]&pxyCustomerInfo.shippingLocation.address=[ShippingStreetAddress]&pxyCustomerInfo.shippingLocation.city=[ShippingCity]&pxyCustomerInfo.shippingLocation.state=[ShippingState/Province]&pxyCustomerInfo.shippingLocation.zipCode=[ShippingZipCode/PostalCode]&pxyCustomerInfo.shippingLocation.country=[ShippingCountry]

Razorpay 3D Secure 2 Implementation

In order to implement 3D Secure 2, the Razorpay payment profile must include the 3DS Callback URL during the payment profile setup.

PARAMETER NAME Possible VALUE
3DS Callback URL https://ccframe.hostedpci.com/iSynSApp/appUserVerify3DResp!verifyResp.action

3ds 2.0 Raozr Pay “verifyenroll” call

  • In Order to implement ThreeDSecure 2.0 with Razor Pay the following parameters are required.
  • The table below contains the parameter required for the verifyenroll call.
PARAMETERS VALUES
pxyCustomerInfo.browserAcceptHeader [browserAcceptHeader]
pxyCustomerInfo.browserUserAgentHeader [browserUserAgentHeader]
pxyThreeDSecAuth.callMode [reportall]
pxyTransaction.txnPayName [3dsecProfileName]
pxyThreeDSecAuth.actionName [verifyenroll]

3ds 2.0 Razor Pay “verifyresp” call

  • If ‘verifyenroll’ was successful it will return parameters required for ‘verifyresp’ call.
  • The table below contains parameters required to make the second auth call with Razor Pay 3ds 2.0.
PARAMETERS VALUES
pxyThreeDSecAuth.authTxnId [pxyResponse.threeDSTransactionId] – returned from the ‘verifyenroll’ call]
pxyTransaction.txnPayName [3dPayProfileName]
pxyThreeDSecAuth.actionName [verifyresp]