Razorpay Payment Integration

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]