====== API Specification ====== ~~TOC~~ \\ Welcome to the API Specification. Here you will find all necessary information to help you understand your integration to our Payment gateway. Click HERE to access our api documenation. ===== Things You Should Know First ===== \\ This section helps you to understand the elements for your solution's integration such as which integration method to use, how to configure your account to perform each integration, how to use the custom fields, how to calculate the hash parameters of requests and responses, etc.

Special Fields and Parameters

HASH Calculation, Card Types, Custom Fields, Dynamic Descriptors, Multi-currency Terminal ID, Signature Field

Response Codes and Messages

Specific response codes and messages which may be returned in different features...

Account Updater Background Notification

A longer and more detailed explanation of how this important mechanism works...

===== The Hosted Page Integration Method ===== \\ The Hosted Page (HP) is an integration method where the entry of some sensitive data is handled by the Payment Gateway so the merchant’s servers are not exposed to this data. This is advisable so as to reduce the security overhead of the integrated solution. For this scenario, %CompanyName becomes the responsible party for maintaining the security and integrity of the sensitive data sent to these pages. These Hosted Pages are also highly stylized so that they look more appealing to the customers and improves their overall experience. For more details on that consult **[[merchant:existing_merchant:selfcare_system:settings:pay_pages|Pay Pages]]**. Cardholders are redirected to a page at the Payment Gateway. Upon the customer clicking the ‘submit’ button on that page, all data are collected, processed and the Payment Gateway sends the processing result back to the Merchant's site, also redirecting the Account Holder to the Merchant's result page, in a transparent way. The following features are available for this integration method:

Payment

Payment and pre-authorization

Background Validation

Checks the transaction

Payment

Payment using Apple Pay technology

Payment

Payment using Google Pay technology

Secure Token

Secure Token registration and update

Subscription

Subscription and stored subscription registration

Bulk Payments

Large payment file submission and result request

===== The RESTful Integration Method =====

Our APIs are built around REST principles and OpenAPI Specification definitions. Complying to such industry standards means that we can offer developers a much better experience by exposing predictable resource-oriented URL's as well as a comprehensive range of HTTP response codes and verbs. Moreover, you have the possibility to enable and take full advantage of HATEOAS controls to provide out-of-the-box Discoverability and Functional-Awareness for your integrations.

Get started on building full-featured payment applications and join us in the Revolution of Intelligent Retail.

Merchant API

Merchant API Documentation

Boarding API

Boarding API Documentation

===== The XML Integration Method ===== \\ The XML integration method allows a Merchant's solution to integrate directly with the Payment Gateway, perform specific “feature modeled” calls whereby the Payment Gateway processes a request and sends back a response showing the result of the transaction requested or the errors related to it. The following features are available for this integration method: