Customize Your API Integration
Supported Protocols
The table below enables you to assess the logistics involved when integrating with API.
Both the protocols, REST and NVP, offer the same functionality. However, there might be certain factors to consider before you make your decision.
REST | NVP | |
---|---|---|
When to Use |
With complex integrations that include a web application connected to an application server, database, and web server. This protocol is also suitable for simple integrations. | With simple integrations that include a web page submitting a form to the web server. |
Technical Skills Required |
Basic knowledge of HTTP and the skills to formulate an HTTP request in the preferred server-side scripting language. Basic knowledge of the JSON data-interchange format. See http://www.json.org/ |
Basic knowledge of HTTP and the skills to formulate an HTTP request in the preferred server-side scripting language. |
Software Requirements |
None | None |
Authentication |
Authentication information such as password are included in the HTTP headers, rather than the body of the request. | Authentication information is included in the body of the Transaction Request. |
Usage of HTTPS POST | POST is typically used when you want the system to create a new entry in the collection addressed by the URL. | POST is the only valid HTTP method for the NVP protocol and thus used with all transaction operations. |
Usage of HTTPS PUT | PUT is typically used when the URL contains a member of the collection. | PUT is not a supported method with the NVP protocol. |
Usage of HTTPS GET | GET is only enabled for retrieve operations. | GET is not a supported method with the NVP protocol. |
Transaction Operations
If you are integrated to the gateway via API, you can use API operations to process transactions, retrieve transaction details, store card details, etc. To perform an operation, you must have the requisite privilege on your merchant profile with the gateway. To check which operations are available for you to use, contact your payment service provider.
Gateway Security
The Mastercard GatewayAPI supports two models of authentication: merchant certificates or passwords. Each model has its advantages and disadvantages. Depending on your integration you may need to select features that are only offered by one model.
Payment Methods
A range of payment methods are available with this type of integration.
Additional Features
API supports a wide range of additional features.