Using our API, you can manage the complete lifecycle of a transaction in your application, from settlement and refunding to voids. Although all these calls can be managed in our transaction processing and reconciliation tool, Ecommerce Portal, using the API means you don't have to log in to different interfaces.

In this guide, we'll give you an overview of each request type, examples of request and response values, as well as how to handle them.

Capture (Settle)

This request type is used to capture a Delayed Capture transaction, placing it in the next settlement file to be sent to the Acquirer. The amount of time the funds can remain ring-fenced on the customer's card may vary between different Issuers and Acquirers. The card schemes (for example, Visa and MasterCard) also have their own rules around how long transactions can wait to be captured. Please consult with Global Payments (or your Acquirer) for more information.

Transactions can be captured for up to 115% of the original authorization amount.

Sample request

Refund (Rebate)

A Refund is a reversal to an existing successfully captured authorization. For the request to be accepted, you must supply the original Order ID, Payments Reference (pasref) and Auth Code from the authorization response. Transactions can be refunded for up to 115% of the original authorization amount and the original currency must also be sent in the request.

To process a refund you must supply the Rebate Password which you can set with a member of our support team (note: this is a different password than the Refund Password). This password must be hashed using the SHA-1 algorithm before being added to the request.

Sample request

Void (Cancel)

Before settlement, it is possible to Void an Authorization, Offline, Refund or Credit request. If the transaction has already been placed in the next settlement file, this will remove it. If using Delayed Capture, this will cancel the initial authorization. If the transaction has been settled or batched, then it cannot be voided. This request requires the Order ID and Payments Reference (pasref) from the original transaction.

Sample request

Multi-Capture

Multi-capture (also known as split-shipment) is used to process transactions with multiple items that are shipped at different times or from multiple vendors, distribution centers, or store locations. To use this functionality, in the original authorization request, the Autosettle Flag must be set to MULTI. You can capture the transaction any number of times, up to 115% of the original authorization amount.

This service must adhere to compliance rules outlined by the card brands (for example, Visa and Mastercard) to ensure that the merchant qualifies for the optimum interchange rate for their transaction.

In addition, the time the funds can remain ring-fenced on the customer's card varies among different Issuers and Acquirers. The card brands also have their own rules around how long transactions can wait to be captured. For more information, contact your account manager with us or your Acquirer.

To process a refund against a multi-capture authorization, the following must be sent in the refund request:

• Take the original Order ID of the authorization and add a preceding '_multisettle_' to it. For example: '_multisettle_wgH8RjewQ16gIWJ5bqQKGA'
• The Payments Reference (pasref) sent in the refund must also be the one returned in the response of the last multi-capture request, not the original authorization.

Multi-capture works on logic. If you don’t include the estimated number of transactions in your request, our system will default to a maximum of five capture requests for a multi-auth transaction. The fifth capture request will be considered the final one, even if the final flag is not present. Once the transaction counter is reached, even the original amount is not fully settled.

Consider this typical scenario:

1. As usual, after five capture partial amounts, the next capture is not allowed unless we void the previous five that were settled.
2. Once we void all five previous captures, they are allowed only for the multi-auth's remaining amount. For example: multiauthAmt – sum of captures = 100 - 80 = 20
3. To set the multi-capture counter equator to counter five, we must bypass the multi-capture transaction five-counters condition if the following field will be sent in the request: <estnumtxn>...</estnumtxn>

Authorization

As mentioned above, in the original authorization you must indicate that this transaction will be captured multiple times; set the Autosettle Flag to MULTI.

To avail of interchange optimization, you must indicate the number of future captures. This can be done either in the initial authorization request or in one of the subsequent multi-capture requests (see below).

Global Payments recommend that if at the time of authorization you know the number of captures you intend to process; include it in the request. That way, you don’t have to include any flag in subsequent multi captures. The value can always be modified in the subsequent multi-capture requests.

If you don’t supply this information, Global Payments will automatically estimate the number of subsequent captures to be 5. As outlined, this can be overridden in the multi-captures requests themselves.

Sample Request

Multi-Capture Request

When you’re ready to capture part of a transaction you can send the specific multi-capture request to Global Payments. You can edit the estimated number of captures, or indicate that this is the last capture for this transaction.

Sample request

Generate Hash

Follow the steps in this section to build the request security hash, concatenate the specified fields and hash them using the SHA-1 algorithm, concatenate the hashed string with your Shared Secret, hash it again, and add the resulted string to the request.

Build the Request Hash

Use the dropdown below to select a request type: Capture, Refund or Void. After making a selection, the steps on how to build the request hash for that type are provided.

Check Hash

Follow the steps in this section to build the response security hash, concatenate the specified fields and hash them using the SHA-1 algorithm, concatenate the hashed string with your Shared Secret, hash it again, and add the resulted string to the request.

Check the Response Hash

Use the dropdown below to select a request type: Capture, Refund or Void. After making a selection, the steps on how to check the response hash for that type are provided.