Secure Serverity

Introduction

API Reference

API Endpoints & Authentication

All requests to the Secure Serverity API are sent via the HTTP POST method to one of our API endpoint URLs.

HTTP Request Method: POST

Production API Endpoint For CC: https://secureserverity.com/transaction/doTransaction

Production API Endpoint For eCheck: https://secureserverity.com/transaction/echeck

All calls to the Secure Serverity API require merchant authentication.

Hosted Checkout

Using only general HTML, Hosted checkout is the easiest way to add Credit Card Processing to a new or existing e-Commerce website.

Features

Hosted Checkout is designed specifically for merchants who typically have products. The ease of deployment, which is literally allows semi and non-technical merchants to add purchase links or buttons to their products online

Hosted Checkout is perfect for merchants:

Hosted Checkout only uses HTML forms; it's easy to integrate
Hosted Checkout allows the merchant to customize the checkout page's appearance, retaining the look and feel of their website.
Full Back Office access allowing merchants to manually key sales and voids, as well as view reporting via Secure Serverity.

Transaction Flow

Get Products

If you are executing any Transaction with Secure Serverity firstly you can get product list form Server otherwise Transaction is not happened.

Note: If Your type is not Open Merchant

Production API Endpoint For Products: https://secureserverity.com/transaction/get_products

Field Name	Type	Example	Description
apikey *	string	ABXC5405046SAD	API KEY

<option value=''>Sorry No Product Found.</option>

Transaction Api

A prospect create then send the Transactional Info sent to Secure Serverity.

Field Name	Type	Example	Description
bill_fname	string	Jorge	First Name of Customer
bill_lname	string	Nava	Last Name of Customer
bill_email	string	Jorge@gmail.com	Valid Email Address (Email Receipt and Order Confirmation is sent for this Email)
bill_mobile	String	2025550191	Valid Phone
bill_add_1	String	250 Conaway Street	Address
bill_add_2	String	250 Conaway Street	Address
bill_city	String	Clearwater	City
bill_state	Char	UT	State (ISO-3166-2)
bill_zip	Char	84109	Valid Zipcode
bill_country	Char	US	Country (ISO-3166-2)
is_ship_same	int	1	If Shipping address is same user 1 else 0
ship_fname	string	Jorge	First Name of Customer
ship_lname	string	Nava	Last Name of Customer
ship_email	string	Jorge@gmail.com	Valid Email Address (Email Receipt and Order Confirmation is sent for this Email)
ship_mobile	String	2025550191	Valid Phone
ship_add_1	String	250 Conaway Street	Address
ship_add_2	String	250 Conaway Street	Address
ship_city	String	Clearwater	City
ship_state	Char	UT	State (ISO-3166-2)
ship_zip	Char	84109	Valid Zipcode
ship_country	Char	US	Country (ISO-3166-2)
apikey	String	ABXC5405046SAD	API KEY
product_name	String	Test Product	Product Name
amount	String	29.95	Total Amount
product_id	String	GCC02	If you are fixed product merchant you have to pass product ID
card_number	String	4242424242424242	Credit card number
exp_month	char	0822	Credit card expiration (ie. 0711 = 7/2011)
exp_year	string	2021	Credit card expiration Year
cvc	string	123	Card security code
description	string	Test Description	description
ip_address	String	12.15.15.10	Current IP Address to Charge Customer
Website	String	https://www.yourdomain.com	Website to Charge Product.
is_recurring	int	1	Example: 0 = Not recurring, 1 = Recurring
recurring_days	String	30	If you want to add recurring please pass Recurring days

apikey product_name amount ip_address bill_fname bill_lname bill_email bill_mobile bill_add_1 bill_add_2 bill_country bill_state bill_city bill_zip is_ship_same ship_fname ship_lname ship_email ship_mobile ship_add_1 ship_add_2 ship_country ship_state ship_city ship_zip card_number exp_month exp_year cvc description is_recurring recurring_days recurring_type FOR 3DS dsTransId acsTransId eci status protocolVersion scaIndicator

Transaction Refund Api

A prospect create then send the Transactional Info sent to Secure Serverity.

HTTP Request Method: POST

Production API Endpoint For CC Refund: https://secureserverity.com/transaction/dorefundtransaction

Field Name	Type	Example	Description
apikey *	string	ABXC5405046SAD	API KEY

Example php CURL

$url = https://secureserverity.com/transaction/dorefundtransaction/'; $postdata = array( 'apikey' => 'ABXC5405046SAD', 'amount' => '2.50', 'transactionid' => '8885425147'); $ch = curl_init($url); curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); curl_setopt($ch, CURLOPT_POSTFIELDS, $postdata); // execute! $response = curl_exec($ch); // close the connection, release resources used curl_close($ch);

Transaction Void Api

A prospect create then send the Transactional Info sent to Secure Serverity.

HTTP Request Method: POST

Production API Endpoint For CC Refund: https://secureserverity.com/transaction/dovoidtransaction

Field Name	Type	Example	Description
apikey *	string	ABXC5405046SAD	API KEY

Example php CURL

$url = https://secureserverity.com/transaction/dovoidtransaction/'; $postdata = array( 'apikey' => 'ABXC5405046SAD', 'amount' => '2.50', 'transactionid' => '8885425147'); $ch = curl_init($url); curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); curl_setopt($ch, CURLOPT_POSTFIELDS, $postdata); // execute! $response = curl_exec($ch); // close the connection, release resources used curl_close($ch);

Transaction Alert Api

A prospect create then send the Transactional Info sent to Secure Serverity.

HTTP Request Method: POST

Production API Endpoint For CC Refund: https://secureserverity.com/transaction/doalerttransaction

Field Name	Type	Example	Description
apikey *	string	ABXC5405046SAD	API KEY

Example php CURL

$url = https://secureserverity.com/transaction/doalerttransaction/'; $postdata = array( 'apikey' => 'ABXC5405046SAD', 'amount' => '2.50', 'authcode' => '154A2U', 'Type' => 'Fraud or RDR', 'transactionid' => '8885425147'); $ch = curl_init($url); curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); curl_setopt($ch, CURLOPT_POSTFIELDS, $postdata); // execute! $response = curl_exec($ch); // close the connection, release resources used curl_close($ch);

Transaction Chargeback Api

A prospect create then send the Transactional Info sent to Secure Serverity.

HTTP Request Method: POST

Production API Endpoint For CC Refund: https://secureserverity.com/transaction/dochargebacktransaction

Field Name	Type	Example	Description
apikey *	string	ABXC5405046SAD	API KEY

Example php CURL

$url = https://secureserverity.com/transaction/dochargebacktransaction/'; $postdata = array( 'apikey' => 'ABXC5405046SAD', 'amount' => '2.50', 'authcode' => '154A2U', 'transactionid' => '8885425147'); $ch = curl_init($url); curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); curl_setopt($ch, CURLOPT_POSTFIELDS, $postdata); // execute! $response = curl_exec($ch); // close the connection, release resources used curl_close($ch);

Hosted Checkout Examples

The demos on this page are slightly enhanced beyond what's outlined in their respective Detail & Code areas. Mainly, the code examples are a great foundation to build and customize upon.

The Javascript in this example is used to:

In this example file are included getcountry.php, getstate.php and getproduct.php,api.php all this information are coming via our api. Please mention your api credentials in this variable.

$api = 'YOUR API KEY HERE';

Example php CURL

$url = https://secureserverity.com/transaction/doTransaction/'; $postdata = array( 'product_name' => 'Test Product', 'amount' => 20, 'bill_fname' => 'Jorge', 'bill_lname' => 'Nava', 'bill_email' => 'Jorge@gmail.com', 'bill_mobile' => '2025550191', 'bill_add_1' => '250 Conaway Street', 'bill_add_2' => "250 Conaway Street", 'bill_country' => 'US', 'bill_state' => 'UT', 'bill_city' => 'Clearwater', 'bill_zip' => '84109', 'card_number' => '4242424242424242', 'exp_month' => '12', 'exp_year' => '2024', 'cvc' => '123', 'description' => 'Test Description', 'ip_address' => 12.15.15.10 , 'apikey' => 'ABXC5405046SAD', 'is_ship_same' => 1, 'recurring_type' => 0, 'authenticationValue' => AJkBBxcodQAAAMNPhAKGdAAAAAA=, 'dsTransId' => 6a8d08b7-a7c1-4557-861a-248f56691e03, 'acsTransId' => e2cfd297-3bfd-457e-bbdf-8f6910e14b0f, 'eci' => 05, 'status' => Y, 'protocolVersion' => 2.1.0, 'scaIndicator' => false, ); $ch = curl_init($url); curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); curl_setopt($ch, CURLOPT_POSTFIELDS, $postdata); // execute! $response = curl_exec($ch); // close the connection, release resources used curl_close($ch);

eCheck Checkout Examples

The demos on this page are slightly enhanced beyond what's outlined in their respective Detail & Code areas. Mainly, the code examples are a great foundation to build and customize upon.

The Javascript in this example is used to:

In this example file are included getcountry.php, getstate.php and getproduct.php,api.php all this information are coming via our api. Please mention your api credentials in this variable.

$api = 'YOUR API KEY HERE';

Php

cURL

$url = https://secureserverity.com/transaction/echeck; $postdata = array( 'apikey' => 'Your API Key', 'bill_name' => 'Jorge', 'bill_mobile' => '2025550191', 'bill_email' => 'jorge@gmail.com', 'bill_add_1' => '250 Conaway Street', 'bill_add_2' => '250 Conaway Street', 'bill_country' => 'US', 'bill_state' => 'UT', 'bill_city' => 'Clearwater', 'bill_zip' => '84109', 'amount' => 50, 'account_number' => '9876543210', 'routing_number' => '125000105', 'company_name' => 'Company Name', 'bank_name' => 'Washington', 'desp' => 'Test Description', ); $ch = curl_init($url); curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); curl_setopt($ch, CURLOPT_POSTFIELDS, $postdata); // execute! $response = curl_exec($ch); // close the connection, release resources used curl_close($ch);

Wordpress Plugin Documentation

Gateway Integration for Woocommerce

Secure Serverity Woocommerce Plugin is directly connected to Secure Serverity Application any order run on your website is automatically show on Secure Serverity.

Is easy to help or track your order simultaneously both website and Secure Serverity.

Secure Serverity payment plugin gives Woocommerce ecommerce sites the ability to accept VISA, MasterCard, Discover and American Express cards for payment. The payment plugin is designed for simple integration and support. In order to fully utilize this document, you will need to be familiar with Woocommerce, PHP plugins and computer file systems.

Although Secure Serverity has taken every precaution to ensure error free operation, installations tend to yield surprises. It is best that you verify and make new backups your Woocommerce site before proceeding with integration.

To Install Secure Serverity Woocoomerce Plugin Into Your Website Do The Following:

To install a plugin you generally just need to put the plugin file into your 'wp-content/plugins' directory. Once a plugin is installed, you may activate it or deactivate it from the Plugins menu in your WP administration.

Generally the Plugin installation is a straight-forward process. In most cases it is enough to upload the plugin under the 'wp-content/plugins' directory for the WordPress installation and activate it from the administrator backend.

The removal is also straight-forward in most cases. Simply remove the directory for the plugin you would like to uninstall and it will be automatically deactivated.

After Activated Secure Serverity Woocommerce Plugin Do The Following:

1. After activaton select "woocommerce" from the left panel followed by "settings" then select the "checkout" tab. Click on Secure Serverity Settings.

2. Fill the Title Name which is show on checkout page.

3. Fill the Secure Serverity API KEY provided by Secure Serverity.

4. Select Accepted Card Type.

5. Save this setting.

Security & Data Protection

We never store card details. All transactions are processed in real time through the bank’s secure payment gateway using industry-standard encryption.

Bank Decline Code

Response Code	Reason	Description
100	Transaction was Approved	Transaction was Approved
200	Transaction was Declined by Processor	The customer's bank is unwilling to accept the transaction. The reasons for this response can vary – the customer will need to contact their bank for more details.
201	Do not Honor	The customer's bank is unwilling to accept the transaction. The customer will need to contact their bank for more details regarding this decline.
202	Insufficient funds.	The account did not have sufficient funds to cover the transaction amount at the time of the transaction.
203	Over limit.	The attempted transaction exceeds the withdrawal limit of the account. The customer will need to contact their bank to change the account limits or use a different payment method.
204	Transaction not allowed.	The customer's bank is declining the transaction for unspecified reasons, possibly due to an issue with the card itself. They will need to contact their bank or use a different payment method.
220	Incorrect payment information.	Incorrect payment information.
221	No such card issuer.	This decline code could indicate that the submitted card number does not correlate to an existing card-issuing bank or that there is a connectivity error with the issuer. The customer will need to contact their bank for more information.
222	No card number on file with issuer.	The submitted card number is not on file with the card-issuing bank. The customer will need to contact their bank.
223	Expired card.	The card is expired. The customer will need to use a different payment method.
224	Invalid expiration date.	The customer entered an invalid payment method or made a typo in their card expiration date. Have the customer correct their payment information and attempt the transaction again – if the decline persists, they will need to contact their bank.
225	Invalid card security code.	The customer entered in an invalid security code or made a typo in their card information. Have the customer attempt the transaction again – if the decline persists, the customer will need to contact their bank.
226	Invalid PIN.	Can mean Invalid PIN or missing PIN. Some cards can be set to always require a PIN.
240	Call issuer for further information.	Call issuer for further information.
250	Pick up card.	The customer’s card has been reported as lost or stolen by the cardholder and the card-issuing bank has requested that merchants keep the card and call the number on the back to report it. As an online merchant, you don’t have the physical card and can't complete this request – obtain a different payment method from the customer.
251	Lost card.	The card used has likely been reported as lost. The customer will need to contact their bank for more information.
252	Stolen card.	The card used has likely been reported as stolen. The customer will need to contact their bank for more information.
253	Fraudulent card.	The customer’s bank suspects fraud – they will need to contact their bank for more information.
260	Declined with further instructions available. (See response text)	Declined with further instructions available.
261	Declined-Stop all recurring payments.	Declined-Stop all recurring payments.
262	Declined-Stop this recurring program.	Declined-Stop this recurring program.
263	Declined-Update cardholder data available.	The submitted card has expired or been reported lost and a new card has been issued. Reach out to your customer to obtain updated card information.
264	Declined-Retry in a few days.	Declined-Retry in a few days.
300	Duplicate transaction	transaction was rejected by gateway.
400	Transaction Error Returned by Processor
410	Invalid Merchant Configuration
420	Communication Error
441	Invalid Transaction Information
461	Unsupported Card Type
440	Processor Format Error
460	Processor Feature not Available

Gateway Decline Reason

Reason	Frontend Notes	Internal Notes
Merchant account is disabled	Your account is disabled. Please contact customer support.	F01 This account is currently inactive. Please contact your administrator for assistance.
If CC not allowed to merchant	API transaction is disabled for your account, please contact customer support.	F02 API transactions are disabled for your account. Please reach out to the administrator.
If merchant product type is not open and product code not available	This product not supported.please contact customer support.	F03 The selected product is not available.Please reach out to the administrator.
All IP block for particular country	Unfortunately, services are not available in your region at this time.	F04 Restricted IP for the Country! Not Authorized to process an order
Block particular IP	You are permanently blocked, please contact customer support for more information.	F05 Restricted IP! Not Authorized to process an order
Check Incoming IP Address is valid or not	You are permanently block, please contact customer support for more information.	F06 Restricted IP! Not Authorized to process an order
If transaction failed (n) times with perticular ip address	You are temporarily block, please contact customer support for more information.	F07 Due to repeated failed transaction attempts, Transaction has been blocked. Please contact administrator.
If transaction failed within 1 min then blocked for 10 min	You are temporarily blocked. Please try again after 10 minutes.	F08 Multiple failed attempts transaction has been temporarily blocked. Please try again after 10 minutes or contact administrator.
Particular card number	You are permanently blocked, please contact customer support for more information.	F09 The transaction is blocked due to the Restricted Card Number
Particular BIN number	This particular card /bin is Blocked. Please try a different card.	F10 The card you used is from a blocked BIN. Please use a different card.
Particular email address (proton.com/proton.me)	You are permanently block, please contact customer support for more information.	F11 Transaction Blocked due to restricted email address (proton.com / Proton.me)
Particular customer name (sadio mane)	You are permanently block, please contact customer support for more information.	F12 Transaction Blocked due to restricted Customer
If gateway not found	Gateway Assigning Error, please contact with administrator.	F13 Gateway Assigning Error, please contact with administrator.
If customer exists (check with email/phone) and customer status is marked blocked/fraud in our system	You are permanently blocked, please contact customer support for more information.	F14 Customer Permanently blocked in our system
If customer exists (check with email/phone) and if transaction is not recurring type and customer has continuously 5 failed transaction within 24 hour	You are temporarily blocked. Please try again next day.	F16 Multiple failed attempts transaction has been temporarily blocked. Please contact administrator.
If customer not exists (check with card number) and is blocked/fraud	You are permanently blocked, please contact customer support for more information.	F17 Customer Permanently blocked in our system
If customer not exists (check with card number) and if transaction is not recurring type and customer has continuously 5 failed transaction within 24 hour	You are temporarily blocked. Please try again next day.	F20 Multiple failed attempts transaction has been temporarily blocked. Please contact administrator.
If merchant prooduct type is 'fixed' and product id available and currency is USD and product available in our system and product amount in our system not equal to given amount	Something Went Wrong! Please contact the administrator.	F21 Product type is 'fixed' and amount which is not previously mentioned is attempted
If merchant prooduct type is 'fixed' and product id available and currency is USD and product not available in our system	Something Went Wrong! Please contact the administrator.	F22 Product type is 'fixed' and a product which is not previously mentioned is been attempted
If merchant prooduct type is 'fixed' and product code available and product available in our system and product amount in our system not equal to given amount	Product not found.Please contact the administrator.	F23 Product type is 'fixed' and amount which is not previously mentioned is been attempted
If merchant prooduct type is 'fixed' and product code available and product not available in our system	Product not found	F24 Prooduct type is 'fixed' and a product which is not previously mentioned is been attempted
If merchant prooduct type is 'fixed' and product code available and product available in our system and product currency in our system not equal to given currency	Currency not supported	F25 Product type is 'fixed' and a currency which is not previously mentioned is been attempted
If merchant api key not available	Invalid API Key	F26 API transactions are disabled for your account. Please reach out to the administrator.
Card type not supported	Card type not supported	F27 The transaction is blocked due to the Restricted Card Type
Bin number error (xxxxxx)	Bin number error (xxxxxx)	F28 The transaction is blocked due to the Restricted Bin Number
Monthly transaction limit expired.	Monthly transaction limit expired.	F29 Monthly transaction limit expired.Please reach out to the administrator.
Daily transaction limit expired.	Daily transaction limit expired.	F30 Daily transaction limit expired.Please reach out to the administrator.
Amount is greater than maximum ticket size.	Amount is greater than maximum ticket size.	F31 Amount processed is Higher than maximum Ticket.Please reach out to the administrator.
Amount is less than minimum ticket size.	Amount is less than minimum ticket size.	F32 Amount processed is less that minumum Ticket.Please reach out to the administrator.
Country not supported	Country not supported	F33 Restricted Country! Not Authorized to process an order
Default	Transaction has been failed. Please contact with administrator for this error.	F34 Multiple failed attempts transaction has been temporarily blocked. Please try again after 10 minutes or contact administrator.
Gateway not supported (vip / non-vip)	Your attempt as failed. Please contact support or choose another payment method.	F35 FTD transaction, whitelisting required, contact customer support.