Image
About SafeCharge:

SafeCharge has developed the industry’s first Native+ Payments Engine. Native, because it has been built from the ground-up as a platform to cover the full payment value chain, providing merchants with all the benefits of an end-to-end secure payment processing solution. And + because it also enables a connection to other payment and risk management partners.

Implemented Features:

Feature Level of Support
Auth Implemented
Sale (Auth+Capture) Implemented
Capture Implemented
Void Implemented
Credit Implemented
Gateway Tokenization Implemented
Authentication and Security Credentials:

  • Marchant ID
  • Marchant Key
  • Merchant Site ID
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.merchantAccountName Alphabetical Optional This field is used to present the account name on the clients statement
pxyTransaction.merchantPhoneNum Numerical Optional Display phone number on the clients statement
pxyTransaction.merchantProductName Alphabetical Optional Display the product name on the clients statement
pxyTransaction.txnPayName Alphanumeric Required HostedPCI payment profile name, for example “DEF”
pxyCustomerInfo.browserUserAgentHeader Alphanumeric Optional The customers browsers header
pxyCustomerInfo.customerIP Numerical Optional The customers IP address used for the purchase
pxyCustomerInfo.customerId Numerical Optional A specified Id created by merchant to identify a customer
pxyCustomerInfo.email Alphanumeric Required Customer's Email 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.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 Required Customer's Billing Country
pxyCustomerInfo.billingLocation.district Alphanumeric Required This is the customer county
pxyCustomerInfo.shippingLocation.firstName Alphabetical Optional Customer's First Name for Shipping
pxyCustomerInfo.shippingLocation.lastName Alphabetical Optional Customer's Last Name for Shipping
pxyCustomerInfo.shippingLocation.phoneNumber Numerical Optional Shipping Phone Number
pxyCustomerInfo.shippingLocation.address Alphanumeric Optional Customer's Shipping Address
pxyCustomerInfo.shippingLocation.address2 Alphanumeric Optional Secondary Shipping Address
pxyCustomerInfo.shippingLocation.city Alphabetical Optional Customer's Shipping City
pxyCustomerInfo.shippingLocation.state Alphabetical Optional Customer's Shipping State or Province
pxyCustomerInfo.shippingLocation.zipCode Alphabetical Optional Customer's Shipping Zip Code or Postal Code
pxyCustomerInfo.shippingLocation.country Alphabetical Optional Customer's Shipping Country
pxyCustomerInfo.shippingLocation.district Alphanumeric Required This is the customer county

API Sample

Resource URL:
https://[HPCI_API_HOSTENAME]/iSynSApp/paymentAuth.action
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]