API Specification
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, Worldnet Payments 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 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 Tokens
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.
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:
Payment
Payment, pre-auth, pre-auth completion, refund, unreferenced refund, transaction status update, and more...
Payment
Payment using Apple Pay technology
Payment
Payment using Google Pay technology
Pay Link
Management of pay links. Create, retrieve links and send them to customers.
eInvoice
Management of eInvoices. Create, cancel, retrieve links and send them to customers.
Account Verification
Verification of card accounts' validity
Secure Tokens
Secure token registration, update, delete, consult and search
Subscription
Stored subscription registration, update and delete. Subscription registration, update, delete and pay. Subscription notification
3D Secure
3D Secure transaction check
Terminal
Consult terminals' configurations