Developers - Easy API's for all your Business needs

PayServices Shopping Cart Developers' API
Please note:

All PayServices APIs require a Merchant Account.
To create a merchant account, go to the Structure tab of your Personal Account, at the top right of the window there is a tab called "Merchant Account".
Click on this tab and you will be able to create a new merchant account.
Once the merchant account is created, reload the page and at the top right of your screen under the menu button "Structure" you will find a drop down menu that allows you to switch from your Personal to your newly created Merchant account.

Where to find the Gateway Username & Password?
It can be found on the Account Structure page of your Merchant account.

In order to be able to use the APIs, you need to add the IP address of your server on the "IP White List" from the structure tab of your Merchant Account.
It has never been so easy to accept online payments from customers visiting your website.
Integrate using our simple and secure Shopping Cart API.

From your PayServices Merchant Account, go to the "Settings" screen and get your Gateway Username and Password.

Integrate using the following source code in your application, and start receiving online payments today!

In order to test your code once the integration is completed, you have the ability to put your account in test mode. For this purpose there is a parameter "test_mode" that is available within the API. While [test_mode = 1] it means that all your transactions via the Shopping Cart will go as normal like "the real thing", the only difference being that no money will be settled.

Note: Unless your Merchant Account's status is "Verified by PayServices", all your transactions will be forced into test mode. Once your Merchant Account will be verified, the [test_mode] parameter will be working according to the value that you specify (either 1 [ON] or 0 [OFF]).
Step by Step API:

1) Use "doShoppingCartIDRequest" with your merchant credentials and make a request to our server to create a new Shopping Cart for your customer's order.

2) Use "doShoppingCartPullUp" for every product you'd like to add to the newly created Shopping Cart with your Merchant's credentials, the shopping cart's reference from the previous query, the product_ref and quantity. The product_ref can be found in your Inventory.
PHP
Ruby
ASP.NET
Last Update: Mar 9, 2017
With our great API, you also have the option to redirect your customers to the Highly Secure PayServices.com Payment page and allow them purchase products and/or services that are not listed in your online inventory. To do so, you need to use the custom fields that are present in the code to specify at least an item reference, title and price. With this API, you are even able to list items in the shopping cart in various currencies.

Those will be automatically converted to the Shopping Cart Main currency using the PayServices.com Dynamic Currency Convertor.
It is also possible to purchase using a Shopping Cart Main Currency that will be different from your default Merchant's Currency.

Note(s): The product_ref_custom field is sensitive and only accepts alphanumeric characters, as well dots and hyphens. The product_currency should be in the decimal format with a dot as the decimal separator (e.g.: 10.00). The product_vat is a percentage value.

For all queries, if one or more parameters are not valid, the query will return a self-explanatory error message.

The complete list is: MISSING_USERNAME / MISSING_PASSWORD / INVALID_LOGIN / INVALID_CURRENCY / MISSING_CART_REF / INVALID_CART_REF / INVALID_PRODUCT_REF_CUSTOM / MISSING_PRODUCT / INVALID_PRODUCT_REF / INVALID_PRODUCT / INVALID_PRODUCT_PRICE / INVALID_PRICE / MISSING_PRODUCT_QUANTITY / INVALID_QUANTITY / INVALID_VAT / INVALID_DISCOUNT_PERCENTAGE / INVALID_DISCOUNT_AMOUNT / INVALID_DISCOUNT_TYPE / INVALID_SPLIT_FEES / INVALID_LANG / INVALID_ORDER_NUMBER

As long as your Merchant's credentials and product IDs are correct values, you should never get one of these.
3) When all products are pulled up in the Shopping Cart and the query "doShoppingCartPullUp" returns a "SUCCESS" value, all you need is to redirect the customer to the PayServices' secure payment page using:
When the payment will be completed, the customer will be automatically redirected to your website and you will be notified in your account that you received a new payment.

Hereunder a sample script to perform the above explained task:
PHP
Ruby
ASP.NET
Last Update: Mar 9, 2017
The "username" and the "password" that you need to connect through our API are different than those used to access your PayServices Account.

After a successfull Merchant Application, the system will deliver for your account a unique username and a unique password.

Note(s): The system is case-sensitive and string restrictive, which means that e.g. if a parameter must be an integer, the system will only allow an integer. Otherwise it will return an error.

In order to know if the payment was processed successfully, you have two options:

1/ Play with the return url to your website and maybe add some token to it.
2/ Add the following file to your website at: www.yourdomain.com/PayServicesPostCartStatus.php

Immediately right after that the payment was processed and successful, our server will send a POST via cURL, using exactly the same method to use to build the shopping cart, to this file on your domain. In the POST query, there will be the $cart_ref and the $amount that was charged excluding taxes.

A sample can be found hereunder:
PHP
Ruby
ASP.NET
Last Update: Mar 9, 2017
The amount is in Decimal format.
e.g.: 2199.99

Note(s): To be able to use this system, you need to activate it from your Merchant's Account Structure. You also need an SSL certificate on your website.

You can rename PayServicesPostCartStatus.php and tell us the new name under your Merchant's settings.
Note: It is highly recommended to use the PayServices eID in order to facilitate & quicken the checkout process. However, if you do not use it on your site, you still have the possibility to pre-fill the checkout form on the PayServices Secure Payment page with your customer's details by passing the following extra parameters to the pay.php URL while doing the redirection to the Payment Page:

firstName / lastName / country / address_1 / address_2 / city / state / postalCode / phone / email

country must be e.g.: "USA", "BEL", etc.
PayServices.com is
IPv6 Ready
PayServices Connect/eID API
Mall & Product API
Shopping Cart API
Invoice & Contact API
Authenticator
Donations API
Others
PayServices.com Website Seal
Make your website look more serious by adding PayServices' website seal to let your customers know that you use our great and secure payment platform.

While customers will be able to click on the seal, they will be redirected to your online store on PayServices.com and will be able to review your Business' details and make sure you are entirely legal, as well browse and buy your products.
Your Merchant's Reference ID ($merchant_ref) can be found in your PayServices.com Account under the Merchant's section.

Unless the specified Merchant's Reference is valid, the seal will not redirect to your Online Store but to PayServices.com main page.
Supported Languages
Language
ISO 639-2
Arabic
ara
Chinese
zho
Dutch
nld
English
eng
French
fra
German
deu
Hebrew
heb
Italian
ita
Polish
pol
Romanian
ron
Russian
rus
Spanish
spa
Whenever you need to send a language code, please use the corresponding ISO 639-2 code.
Supported Hard Currencies
Name
ISO 4217
Australian Dollar ($)
AUD
Canadian Dollar ($)
CAD
Czech Koruna (Kč)
CZK
Danish Krone (kr)
DKK
Digital Austrian Schilling (A€S)
DATS
Digital Finnish Markka (F€M)
DFIM
Digital German Mark (D€M)
DDEM
Euro (€)
EUR
Hong Kong Dollar ($)
HKD
Hungarian Forint (Ft)
HUF
Icelandic Krona (kr)
ISK
Japanese Yen (¥)
JPY
Mexican Peso ($)
MXN
New Israeli Shekel (₪)
ILS
New Zealand Dollar ($)
NZD
Norwegian Krone (¤)
NOK
Polish Zloty (zł)
PLN
Pound Sterling (£)
GBP
Romanian Leu (lei)
RON
Russian Ruble (руб)
RUB
Singapore Dollar ($)
SGD
South African Rand (R)
ZAR
Swedish Krona (kr)
SEK
Swiss Franc (CHF)
CHF
Thai baht (฿)
THB
Turkish Lira (¤)
TRY
United States Dollar ($)
USD
Whenever you need to send a hard currency code, please use the corresponding ISO 4217 code.
Supported Complementary Currencies
Name
PSI 2014
Alabama State Dollar (AL$)
ALSD
Alaska State Dollar (AK$)
AKSD
American Samoa State Dollar (AS$)
ASSD
Arizona State Dollar (AZ$)
AZSD
Arkansas State Dollar (AR$)
ARSD
California State Dollar (CA$)
CASD
CarbonCredits (¤)
CO2C
Clix (¤)
CLIX
Colorado State Dollar (CO$)
COSD
Connecticut State Dollar (CT$)
CTSD
DUSIERA (¤)
DUSI
Delaware State Dollar (DE$)
DESD
Digital Belgian Franc (B€F)
DBEF
Digital Brazilian Real (¤)
DBRL
Digital Cedi (GH$)
DGHS
Digital Congolose Franc (DC)
CDFD
Digital Egyptian Pound (¤)
DEGP
Digital Estonian Kroon (E€K)
DEEK
Digital French Franc (€FF)
DFRF
Digital Irish Pound (I€P)
DIEP
Digital Italian Lira (¤)
DITL
Digital Jordanian Dinar (¤)
DJOD
Digital Kenyan Shilling (¤)
DKES
Digital Latvian Lats (¤)
DLVL
Digital Saudi Riyal (¤)
DSAR
Digital Somoni (¤)
DTJK
Digital Tanzanian Shilling (¤)
DTZS
Digital UAE Dirham (¤)
DAED
Digital Venezuelan Bolivar (Bs.D)
VBSD
Digital Zimbabwean Dollar ($)
DZWD
District of Columbia State Dollar (DC$)
DCSD
Euro Drachma (€₯)
EUDR
Florida State Dollar (FL$)
FLSD
Georgia State Dollar (GA$)
GASD
Guam State Dollar (GU$)
GUSD
Hawaii State Dollar (HI$)
HISD
Idaho State Dollar (ID$)
IDSD
Illinois State Dollar (IL$)
ILSD
Indiana State Dollar (IN$)
INSD
Iowa State Dollar (IA$)
IASD
Kansas State Dollar (KS$)
KSSD
Kentucky State Dollar (KY$)
KYSD
Lion Dollar (L$)
LUSD
Lion Euro (L€)
LEUR
Lion Pound (L£)
LGBP
Lion Shekel (L₪)
LILS
Louisiana State Dollar (LA$)
LASD
Maine State Dollar (ME$)
MESD
Maryland State Dollar (MD$)
MDSD
Massachusetts State Dollar (MA$)
MASD
Michigan State Dollar (MI$)
MISD
Minnesota State Dollar (MN$)
MNSD
Mississippi State Dollar (MS$)
MSSD
Missouri State Dollar (MO$)
MOSD
Montana State Dollar (MT$)
MTSD
Nebraska State Dollar (NE$)
NESD
Nevada State Dollar (NV$)
NVSD
New Hampshire State Dollar (NH$)
NHSD
New Jersey State Dollar (NJ$)
NJSD
New Mexico State Dollar (NM$)
NMSD
New York State Dollar (NY$)
NYSD
North Carolina State Dollar (NC$)
NCSD
North Dakota State Dollar (ND$)
NDSD
North Mariana Islands State Dollar (MP$)
MPSD
Ohio State Dollar (OH$)
OHSD
Oklahoma State Dollar (OK$)
OKSD
OrIsrael (¤)
ORIL
Oregon State Dollar (OR$)
ORSD
Pennsylvania State Dollar (PA$)
PASD
Puerto Rico State Dollar (PR$)
PRSD
Rhode Island State Dollar (RI$)
RISD
South Carolina State Dollar (SC$)
SCSD
South Dakota State Dollar (SD$)
SDSD
Tennessee State Dollar (TN$)
TNSD
Texas State Dollar (TX$)
TXSD
U.S. Virgin Islands State Dollar (VI$)
VISD
Utah State Dollar (UT$)
UTSD
Vermont State Dollar (VT$)
VTSD
Virginia State Dollar (VA$)
VASD
Washington State Dollar (WA$)
WASD
West Virginia State Dollar (WV$)
WVSD
Wisconsin State Dollar (WI$)
WISD
Wyoming State Dollar (WY$)
WYSD
Whenever you need to send a complementary currency code, please use the corresponding PSI 2014 code.
Supported Crypto Currencies
Name
PSI 2014
BitCoin (¤)
UBTC
Whenever you need to send a crypto currency code, please use the corresponding PSI 2014 code.
Download Sources
Download Butterfly Secure Browser