Chase Paymentech
About Chase Paymentech:
Chase Paymentech is the payment processing and merchant acquiring business of JPMorgan Chase (NYSE: JPM). Paymentech payment platforms support businesses of all sizes to process payments, including credit, debit, and digital, alternative, mobile payment options. Since 2006, Paymentech has been consistently ranked as the number one payment processor by Internet Retailer (Top 500 Guide). Paymentech can authorize payment transactions in more than 130 currencies. The company also provides business analytics, payment fraud detection, and data security solutions.
In 2012, Chase Paymentech processed 29.5 billion transactions with a value of $655.2 billion.
Implemented Features:
| Feature | Level of Support |
|---|---|
| Auth | Implemented |
| Sale (Auth+Capture) | Implemented |
| Capture | Implemented |
| Void | Implemented |
| Credit | Implemented |
| 3DS 2 Passthrough | Implemented |
| Gateway Tokenization | Implemented |
Authentication and Security Credentials:
- Merchant ID
- Bin
- Terminal ID
In order for Payments to be delivered to Chase clients have to whitelist our Submitter ID on your merchant account.
Submitter ID: 980491
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.billingLocation.firstName | Alphabetical | Optional | Customer’s First Name |
| pxyCustomerInfo.billingLocation.lastName | Alphabetical | Optional | Customer’s Last Name |
| pxyCustomerInfo.email | Alphanumeric | Optional | Customer’s Email Address |
| pxyOrder.description | Alphabetical | Optional | Description |
| pxyCustomerInfo.billingLocation.phoneNumber | Numerical | Optional | Billing Phone Number |
| pxyCustomerInfo.billingLocation.address | Alphanumeric | Optional | Customer’s Billing Address |
| pxyCustomerInfo.billingLocation.address2 | Alphanumeric | Optional | Secondary 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 |
| pxyOrder.shippingReference | Alphanumeric | Optional | Shipping Reference |
Additional Parameters
| KEY NAME | FORMAT | DESCRIPTIONS |
|---|---|---|
| pxyTransaction.merchantAccountName | Alphabetical | Required for Soft Descriptors |
| pxyTransaction.merchantProductName | Alphabetical | Required for Soft Descriptors |
| pxyTransaction.merchantPhoneNum | Alphabetical | Required for Soft Descriptors |
| pxyTransaction.merchantCity | Alphabetical | Required to qualify for Visa’s lowest Direct Marketing interchange rate |
| pxyTransaction.merchantEmail | Alphabetical | Required to qualify for Visa’s lowest Direct Marketing interchange rate |
| pxyTransaction.merchantUrl | Alphabetical | Required to qualify for Visa’s lowest Direct Marketing interchange rate |
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]
Chase Paymentech 3DS implementation with Cardinal Commerce
Chase Paymentech has been implemented with Cardinal Commerce for 3DS pass-through Authentication.
In Order to implemented 3DS Authentication with Chase Paymentech follow the Cardinal Commerce 3D Secure documentation page.
The parameters listed on the page are required along with the mandatory AUTH transaction parameters to make a successful 3DSecure transaction.
Chase Paymentech 3DS 1.0 “verifyenroll” Parameters
| PARAMETER | VALUES |
|---|---|
| pxyThreeDSecAuth.authSessionID | [cruiseSessionId returned within threeDSValuesObj in hpciSiteSuccessHandlerV4 and later versions] |
| pxyThreeDSecAuth.authOrderId | [threeDSOrderId returned within threeDSValuesObj in hpciSiteSuccessHandlerV4 and later versions] |
| pxyThreeDSecAuth.actionName | [verifyenroll] |
| pxyTransaction.txnPayName | [3ds payment profile name] |
Chase Paymentech 3DS 1.0 “Verifyresp” call
| PARAMETERS | VALUE |
|---|---|
| pxyTransaction.txnPayName | [3ds payment profile name] |
| pxyThreeDSecAuth.actionName | [verifyenroll] |
| pxyThreeDSecAuth.authSessionId | [cruiseSessionId returned within threeDSValuesObj in hpciSiteSuccessHandlerV4 and later versions] |
| pxyThreeDSecAuth.authTxnId | [response from the first API call “pxyResponse.threeDSXid”] |
| pxyThreeDSecAuth.paReq | [response from the first API call “pxyResponse.threeDSPARequest”] |
| pxyThreeDSecAuth.protocolVersion | [response from the first API call “pxyResponse.threeDSProtoVersion”] |
| pxyThreeDSecAuth.authECI | [response from the first API call “pxyResponse.threeDSECI”] |
Chase Paymentech 3DS 2.0 “verifyenroll” Parameters
| PARAMETERS | VALUE |
|---|---|
| pxyTransaction.txnPayName | [3ds payment profile name] |
| pxyThreeDSecAuth.actionName | [verifyenroll] |
| pxyThreeDSecAuth.callMode | reportall |
| pxyThreeDSecAuth.authSessionId | [cruiseSessionId returned within threeDSValuesObj in hpciSiteSuccessHandlerV4 and later versions] |
| pxyThreeDSecAuth.authOrderId | [threeDSOrderId returned within threeDSValuesObj in hpciSiteSuccessHandlerV4 and later versions] |
| pxyCustomerInfo.browserUserAgentHeader | [UserAgentHeader] |
| pxyCustomerInfo.browserAcceptHeader | [Browser Accept Header] |
3DS 2.0 “verifyresp” Parameters
| PARAMETERS | VALUE |
|---|---|
| pxyTransaction.txnPayName | [3ds payment profile name] |
| pxyThreeDSecAuth.actionName | [verifyenroll] |
| pxyThreeDSecAuth.authSessionId | [cruiseSessionId returned within threeDSValuesObj in hpciSiteSuccessHandlerV4 and later versions] |
| pxyThreeDSecAuth.authCAVV | [response from the first API call “pxyResponse.threeDSCAVV”] |
| pxyThreeDSecAuth.authTxnId | [response from the first API call “pxyResponse.threeDSXid”] |
| pxyThreeDSecAuth.authAcsUrl | [response from the first API call “pxyResponse.threeDSAcsUrl”] |
| pxyThreeDSecAuth.paReq | [response from the first API call “pxyResponse.threeDSPARequest”] |
| pxyThreeDSecAuth.protocolVersion | [response from the first API call “pxyResponse.threeDSProtoVersion”] |
| pxyThreeDSecAuth.authECI | [response from the first API call “pxyResponse.threeDSECI”] |
| pxyThreeDSecAuth.paRes | [response from the first API call “pxyResponse.threeDSARS”] |
| pxyThreeDSecAuth.dirSrvTxnId | [response from the first API call “pxyResponse.threeDSDirSrvTransactionId”] |
Chase Paymentech Gateway Tokenization
Parameters Required for Gateway Tokenization:
| PARAMETERS | VALUE |
|---|---|
| pxyCreditCard.creditCardNumber | [HostedPCI Token] |
| pxyCreditCard.cardCodeVerification | [HostedPCI CVV place holder] |
| pxyCreditCard.expirationMonth | [Credit Card expire month] |
| pxyCreditCard.expirationYear | [Credit Card expire year] |
| pxyTransaction.txnPayName | [Profile Name provided by HostedPCI] |
| pxyCustomerInfo.billingLocation.firstName | [Client’s first name as it appears on the card] |
| pxyCustomerInfo.billingLocation.lastName | [Client’s last name as it appears on the card] |
Chase Paymentech Gateway Tokenization API Call
Request:
pxyCreditCard.creditCardNumber=4444000015201111&apiVersion=1.0.1&userPassKey=[APIPasskey]&pxyCreditCard.expirationMonth=09&pxyCreditCard.expirationYear=2022&pxyCustomerInfo.billingLocation.lastName=Customer&pxyCustomerInfo.billingLocation.firstName=Test&userName=[APIUsername]&pxyCreditCard.cardCodeVerification=200&pxyTransaction.txnPayName=DEF_CHASE&apiType=pxyhpci
Response:
status=success&operId=&tokenId=583540704&mappedCC=4444000015201111&ccBIN=&pxyResponse.threeDSEnrolled=&pxyResponse.threeDSAcsUrl=&pxyResponse.threeDSErrorDesc=&pxyResponse.processorRefId=&pxyResponse.processorType=ponResponse&pxyResponse.threeDSMessageId=&pxyResponse.threeDSSessionId=&pxyResponse.cardOnFileIssuerId=&pxyResponse.mappedParams=txnResponse.ccTypeEst%3DVISA&pxyResponse.threeDSARS=&pxyResponse.threeDSOrderId=&pxyResponse.gatewayToken.status=&pxyResponse.responseStatus.name=&pxyResponse.responseAVS2=&pxyResponse.responseStatus=approved&pxyResponse.gatewayToken=117423672&pxyResponse.responseAVS1=&pxyResponse.responseAVS4=&pxyResponse.responseStatus.description=Profile+Request+Processed&pxyResponse.threeDSCAVV=&pxyResponse.responseAVS3=&pxyResponse.gatewayToken.fullNativeResp=&pxyResponse.threeDSXid=&pxyResponse.threeDSProtoVersion=&pxyResponse.responseStatus.reasonCode=A&pxyResponse.threeDSPARequest=&pxyResponse.responseCVV1=&pxyResponse.threeDSECI=&pxyResponse.responseCVV2=&pxyResponse.fullNativeResp=CustomerState%3D%26SwitchSoloStartDate%3D%26CustomerZIP%3D%26SwitchSoloIssueNum%3D%26CustomerMerchantID%3D700000203057%26CCExpireDate%3D0922%26ProfileProcStatus%3D0%26CustomerPhone%3D%26ECPAccountType%3D%26ECPBankPmtDlv%3D%26Status%3DA%26isGood%3DY%26CTIAffluentCard%3D%26CTIPINlessDebitCard%3D%26AVSCode%3D%26ECPAccountDDA%3D%26CVV2ResponseCode%3D%26CTISignatureDebitCard%3D%26CTIIssuingCountry%3D%26AccountUpdaterEligibility%3DN%26CTILevel3Eligible%3D%26CustomerAccountType%3DCC%26Message%3DProfile%2BRequest%2BProcessed%26TxRefNum%3D%26CustomerProfileAction%3DCREATE%26CustomerProfileMessage%3DProfile%2BRequest%2BProcessed%26CCAccountNum%3D444433XXXXXX1111%26isError%3DN%26OrderDefaultDescription%3D%26CustomerEmail%3D%26RespTime%3D%26CustomerAddress2%3D%26CustomerName%3DTEST%2BCUSTOMER%26isApproved%3DY%26CustomerProfileOrderOverrideInd%3DNO%26CTICommercialCard%3D%26CustomerAddress1%3D%26CustomerBin%3D000002%26isQuickResponse%3DN%26ResponseCode%3D%26AuthCode%3D%26CustomerCity%3D%26ECPAccountRT%3D%26CTIHealthcareCard%3D%26CTIPrepaidCard%3D%26OrderDefaultAmount%3D%26isDeclined%3DN%26CTIPayrollCard%3D%26CustomerRefNum%3D117423672%26CTIDurbinExemption%3D&pxyResponse.threeDSAcsPageData=&pxyResponse.gatewaySubToken2=&pxyResponse.threeDSTransactionId=&pxyResponse.gatewaySubToken1=&pxyResponse.gatewaySubToken3=&pxyResponse.merchantRefId=&pxyResponse.threeDSErrorId=&pxyResponse.txnPayName=DEF_CHASE&pxyResponse.responseStatus.code=&pxyResponse.threeDSSRS=