Knowing Your Input Fields
Proper values for the input fields help simplify the process of handling orders and transactions. Particularly recovering lost transactions, regardless of the method you choose to generate these values, manually or automatically using a script.
Prerequisites
Before performing a test transaction, prepare the values for the fields that require your input.
Transaction or Order identifiers and references
For more information about field types, validation rules, and what operations require the Mandatory Order Identifier and Reusing Order Identifier fields, see the API Reference.
Order identifier
It is a unique identifier for an order included in the URL for REST to distinguish itself from any other orders you create. This field is mandatory and must be unique for every order you create against your merchant profile. When you perform a subsequent transaction against an order, for example, refund, capture, or void, you must supply the Order ID that corresponds to the initial Authorization or Pay.
Reusing order identifier
From API version 15 and later, if the initial transaction for an order fails, you can submit another initial transaction for this order without creating a new order. This is useful in scenarios where the payer may wish to retry a failed transaction with different payment details. For example, a different credit card or an alternative payment method such as PayPal.
Order ID API Reference[REST][NVP]
Transaction identifier
The identifier for a transaction included in the URL for REST to distinguish itself from the other transactions within this order. This field is mandatory and must be unique for transactions you create within an order. A unique Transaction ID is useful for retrieving transactions at a later stage. Qualify a Transaction ID with an Order ID for a successful retrieve operation.
The Merchant Administration displays the Transaction ID on the Financial Transaction Details page.
Transaction Identifier API Reference[REST][NVP]
Order reference
It is an optional identifier to provide meaningful business-based identifier in the Mastercard Gateway. This is an optional field. For example, a shopping cart number, an order number, or an invoice number. Use the Order Reference as a search criterion in Merchant Administration.
Order Reference API Reference[REST][NVP]
Transaction reference
It is an optional identifier to identify the transaction within the Mastercard Gateway. This is an optional field. You can set this value at the transaction level as it does not have any uniqueness constraint. You can search for a transaction using this field in Merchant Administration.
Transaction Reference API Reference[REST][NVP]
Correlation ID
A transient identifier used to match up your requests to the Mastercard Gateway with the responses. This is an optional field. The Mastercard Gateway returns the value you provide in the response to the request. You can use the Correlation ID with all API requests.
You can match entries in response files with corresponding entries in request files, regardless of the order in which responses are returned.