The JavaScript SDK helps you to communicate with the Ingenico Connect Client API. It's primary features are:
- handling of all the details concerning the encryption of the payment details,
- convenient JavaScript wrapper around the API calls and responses,
- localization of various labels and messages,
- user-friendly formatting (masking) of payment data such as card numbers and expiry dates,
- validation of input, and
- a check to determine to which payment provider a card number is associated.
Its use is demonstrated by an example application that is also included. This application constructs the user interface elements used throughout the payment process from API responses on the fly.
See the Ingenico ePayments Developer Hub for more information on how to use the API.
This repository consists out of three main components:
- The source code of the SDK itself:
/src/example-app/js-sdk/ - The source code of the example application:
/src/example-app/ - A distributable folder containing the result of the builds of the previous two components:
/dist/
/dist/gcsdk.js- The concatenated but not minified full SDK source/dist/gcsdk.min.js- The minified version ofgcsdk.js/dist/gcsdk.noEncrypt.js- The concatenated but not minified SDK source without the encryption components/dist/gcsdk.noEncrypt.min.js- The minified version ofgcsdk.noEncrypt.js
If you would like to use the example application to base your own implementation on we advice to use the version that has been built. It already contains the minified SDK instead of the SDK source code like in the version of the application in /src/example-app/.
This repository uses gulp to build. Assuming you have npm and gulp installed, building is straightforward:
- If it exists remove the
distfolder. - From the root of the project install all dependencies:
npm install. - From the same location run gulp:
gulp. - The result of the build will have been written to the
distfolder.