# Automated Fuel Dispenser
source: https://developer.mastercard.com/mastercard-gateway/documentation/gateway-features/trans-enrich-data/cardholder-present-data/automated-fuel-disp/index.md

Automated Fuel Dispenser (AFD) transactions occur when cardholders use payment cards at fuel pumps in card-present or unattended environments. Merchants request authorization before dispensing fuel to help ensure transaction approval.

Mastercard and Visa have revised their standards to improve authorization accuracy, support partial approvals, and enable timely clearing through advice messages. Merchants identify AFD transactions using **MCC 5542** and apply the appropriate **Card Acceptor Terminal (CAT)** indicators based on the transaction type and channel.

## Scheme support {#scheme-support}

AFD support is available for the Mastercard and Visa.

## WS API support {#ws-api-support}

WS API supports AFD on the following API operations from **version 100** and later.

|          Field           |    Supported Enumeration    | API Operation | API Version |
|--------------------------|-----------------------------|---------------|-------------|
| `order.fuelDispenseType` | `AUTOMATIC_FUEL_DISPENSING` | Authorization | V100        |

## Use case execution {#use-case-execution}

The following table describes the supported AFD use cases, including the corresponding API operations and required e-commerce and card-present parameters.

|        Use Case Execution        |                                                               Description                                                                |     API Operation      |                                    E-commerce                                    |                                                                                                 Card Present                                                                                                  |
|----------------------------------|------------------------------------------------------------------------------------------------------------------------------------------|------------------------|----------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| **Preauthorization Request**     | Identify the Authorization Request (MTI 0100) as a preauthorization for a maximum or selected fuel amount.                               | `AUTHORIZE`            | `transaction.source=INTERNET` `order.fuelDispenseType=AUTOMATIC_FUEL_DISPENSING` | `order.fuelDispenseType=AUTOMATIC_FUEL_DISPENSING` `posTerminal.cardholderActivated:` - `AUTOMATED_DISPENSING_MACHINE_WITH_PIN` - `ELECTRONIC_COMMERCE` - `SELF_SERVICE_TERMINAL` - `TRANSPONDER_TRANSACTION` |
| **Authorization Advice Request** | Send an Authorization Advice (MTI 0120) with the final transaction amount within 60 minutes in the U.S., Canada, and most other regions. | `UPDATE_AUTHORIZATION` | Not applicable                                                                   | Not applicable                                                                                                                                                                                                |
| **Capture Request**              | Submit the Capture request to complete the transaction.                                                                                  | `CAPTURE`              | Not applicable                                                                   | Not applicable                                                                                                                                                                                                |
| **Void Request**                 | Voids the Preauthorization or the Authorization Advice.                                                                                  | `VOID`                 | Not applicable                                                                   | Not applicable                                                                                                                                                                                                |

### Important notes {#important-notes}

* Do not use `UPDATE_AUTHORIZATION` with a zero amount to cancel an authorization advice (0120).
* Always follow an Authorization with an `UPDATE_AUTHORIZATION` request.
* Perform the Capture only after a successful `UPDATE_AUTHORIZATION` request.
* Do not perform a Capture directly after Authorization.
* Ensure that the update amount does not exceed the initial authorization.
* If the `UPDATE_AUTHORIZATION` request (0120), also known as a confirmation advice, fails due to a timeout, resend the transaction. The gateway automatically voids the transaction and does not attempt to retry.

## WS API examples {#ws-api-examples}

### Example of AFD Pre-Authorization request with AUTOMATED_DISPENSING_MACHINE_WITH_PIN {#example-of-afd-pre-authorization-request-with-automated_dispensing_machine_with_pin}

Applicable for the [Authorize](https://developer.mastercard.com/mastercard-gateway/documentation/api-reference/v100/rest/api-ops/index.md#transaction) transaction and the **Visa** scheme.

```json
{
  {
      "apiOperation": "AUTHORIZE",
      "order": {
          "amount": "200",
          "currency": "AUD",
          "certainty": "ESTIMATED",
          "fuelDispenseType": "AUTOMATIC_FUEL_DISPENSING",
          "merchantCategoryCode": "5542"
      },
      "sourceOfFunds": {
          "provided": {
              "card": {
                  "emvRequest": {
                      "57": ";4508750015741019=3901201",
                      "5F34": "001",
                      "9F1A": "036",
                      "9A": "260528",
                      "9F27": "80",
                      "9C": "00",
                      "9F36": "0004",
                      "9F37": "9DB698C2",
                      "9F26": "3E70F7BD01E7D905",
                      "5A": "4508750015741019",
                      "9F09": "0002",
                      "9F41": "00001147",
                      "9F34": "420302",
                      "9F02": "000000010000",
                      "9F35": "21",
                      "9F10": "01154088001400000001",
                      "9F33": "E0F8C8",
                      "5F2A": "036",
                      "82": "0080",
                      "84": "A0000000041010",
                      "95": "0200008000",
                      "9F66": "27000000"
                  },
                  "expiry": {
                      "month": "01",
                      "year": "39"
                  },
                  "number": "4508750015741019",
                  "pin": {
                      "encryptionState": "VALID",
                      "initializationVector": "0000000000000000",
                      "keySerialNumber": "FFFF0000000004100499",
                      "payload": "04EA6480BEDCB938"
                  }
              }
          },
          "type": "CARD"
      },
      "posTerminal": {
          "address": {
              "street": "45 Park Ave",
              "city": "New York",
              "stateProvince": "NY",
              "postcodeZip": "10017",
              "country": "USA",
              "company": "City Parking Services"
          },
          "attended": "UNATTENDED",
          "cardPresenceCapability": "CARD_PRESENT",
          "cardholderActivated": "AUTOMATED_DISPENSING_MACHINE_WITH_PIN",
          "inputCapability": "CHIP",
          "lane": "PUMP0001",
          "location": "MERCHANT_TERMINAL_ON_PREMISES",
          "panEntryMode": "CONTACTLESS",
          "onlineReasonCode": "OVER_FLOOR_LIMIT",
          "pinEntryCapability": "PIN_SUPPORTED",
          "pinLengthCapability": 6
      },
      "transaction": {
          "source": "CARD_PRESENT"
      }
  }
}
```

```json

 {
     "authorizationResponse": {
         "commercialCard": "!01",
         "commercialCardIndicator": "0",
         "date": "0604",
         "posData": "1000004001500",
         "posEntryMode": "071",
         "processingCode": "003000",
         "responseCode": "00",
         "returnAci": "Y",
         "stan": "171809",
         "time": "085859",
         "transactionIdentifier": "678901112200024",
         "validationCode": "4444"
     },
     "gatewayEntryPoint": "WEB_SERVICES_API",
     "merchant": "CYG_S2I_MER2",
     "order": {
         "amount": 200,
         "authenticationStatus": "AUTHENTICATION_NOT_IN_EFFECT",
         "certainty": "ESTIMATED",
         "chargeback": {
             "amount": 0,
             "currency": "AUD"
         },
         "creationTime": "2026-06-04T08:58:58.731Z",
         "currency": "AUD",
         "fuelDispenseType": "AUTOMATIC_FUEL_DISPENSING",
         "id": "AKS_83189443",
         "lastUpdatedTime": "2026-06-04T08:58:59.143Z",
         "merchantAmount": 200,
         "merchantCategoryCode": "5542",
         "merchantCurrency": "AUD",
         "status": "AUTHORIZED",
         "totalAuthorizedAmount": 200,
         "totalCapturedAmount": 0,
         "totalDisbursedAmount": 0,
         "totalRefundedAmount": 0
     },
     "posTerminal": {
         "address": {
             "city": "New York",
             "company": "City Parking Services",
             "country": "USA",
             "postcodeZip": "10017",
             "stateProvince": "NY",
             "street": "45 Park Ave"
         },
         "attended": "UNATTENDED",
         "cardPresenceCapability": "CARD_PRESENT",
         "cardholderActivated": "AUTOMATED_DISPENSING_MACHINE_WITH_PIN",
         "inputCapability": "CHIP",
         "lane": "PUMP0001",
         "location": "MERCHANT_TERMINAL_ON_PREMISES",
         "onlineReasonCode": "OVER_FLOOR_LIMIT",
         "panEntryMode": "CONTACTLESS",
         "pinEntryCapability": "PIN_SUPPORTED",
         "pinLengthCapability": 6
     },
     "response": {
         "acquirerCode": "00",
         "acquirerMessage": "Approved",
         "gatewayCode": "APPROVED",
         "gatewayRecommendation": "NO_ACTION"
     },
     "result": "SUCCESS",
     "sourceOfFunds": {
         "provided": {
             "card": {
                 "brand": "VISA",
                 "emvRequest": {
                     "82": "0080",
                     "84": "A0000000041010",
                     "95": "0200008000",
                     "5F2A": "036",
                     "5F34": "001",
                     "9A": "260528",
                     "9C": "00",
                     "9F02": "000000010000",
                     "9F09": "0002",
                     "9F10": "01154088001400000001",
                     "9F1A": "036",
                     "9F26": "3E70F7BD01E7D905",
                     "9F27": "80",
                     "9F33": "E0F8C8",
                     "9F34": "420302",
                     "9F35": "21",
                     "9F36": "0004",
                     "9F37": "9DB698C2",
                     "9F41": "00001147",
                     "9F66": "27000000"
                 },
                 "emvResponse": {
                     "71": "0102030405060708090A",
                     "91": "2263BCC1C2D9C4420013"
                 },
                 "expiry": {
                     "month": "1",
                     "year": "39"
                 },
                 "fundingMethod": "DEBIT",
                 "issuerCountryCode": "GBR",
                 "number": "450875xxxxxx1019",
                 "pin": {
                     "encryptionState": "VALID",
                     "keySerialNumber": "FFFF0000000004100499"
                 },
                 "scheme": "VISA",
                 "sequenceNumber": "001",
                 "storedOnFile": "NOT_STORED",
                 "trackDataProvided": true
             }
         },
         "type": "CARD"
     },
     "timeOfLastUpdate": "2026-06-04T08:58:59.143Z",
     "timeOfRecord": "2026-06-04T08:58:58.776Z",
     "transaction": {
         "acquirer": {
             "batch": 20260605,
             "date": "0605",
             "id": "CYG_TESTACQ_S2I",
             "merchantId": "9808",
             "transactionId": "678901112200024"
         },
         "amount": 200,
         "authenticationStatus": "AUTHENTICATION_NOT_IN_EFFECT",
         "authorizationCode": "065859",
         "currency": "AUD",
         "id": "AKS_16507344",
         "receipt": "615508171809",
         "source": "CARD_PRESENT",
         "stan": "171809",
         "terminal": "0001",
         "type": "AUTHORIZATION"
     },
     "version": "100"
 }
```

Applicable for the [Authorize](https://developer.mastercard.com/mastercard-gateway/documentation/api-reference/v100/rest/api-ops/index.md#transaction) tansaction and the **Mastercard** scheme.

```json
{
    "apiOperation": "AUTHORIZE",
    "order": {
        "amount": "200",
        "currency": "AUD",
        "certainty": "ESTIMATED",
        "fuelDispenseType": "AUTOMATIC_FUEL_DISPENSING",
        "merchantCategoryCode": "5542"
    },
    "sourceOfFunds": {
        "provided": {
            "card": {
                "emvRequest": {
                    "57": ";5462899999997111=3901201",
                    "5F34": "001",
                    "9F1A": "036",
                    "9A": "260528",
                    "9F27": "80",
                    "9C": "00",
                    "9F36": "0004",
                    "9F37": "9DB698C2",
                    "9F26": "3E70F7BD01E7D905",
                    "5A": "5462899999997111",
                    "9F09": "0002",
                    "9F41": "00001147",
                    "9F34": "420302",
                    "9F02": "000000010000",
                    "9F35": "21",
                    "9F10": "01154088001400000001",
                    "9F33": "E0F8C8",
                    "5F2A": "036",
                    "82": "0080",
                    "84": "A0000000041010",
                    "95": "0200008000",
                    "9F66": "27000000"
                },
                "expiry": {
                    "month": "01",
                    "year": "39"
                },
                "number": "5462899999997111",
                "pin": {
                    "encryptionState": "VALID",
                    "initializationVector": "0000000000000000",
                    "keySerialNumber": "FFFF0000000004100499",
                    "payload": "13C2BB6FA3A53D68"
                }
            }
        },
        "type": "CARD"
    },
    "posTerminal": {
        "address": {
            "street": "45 Park Ave",
            "city": "New York",
            "stateProvince": "NY",
            "postcodeZip": "10017",
            "country": "USA",
            "company": "City Parking Services"
        },
        "attended": "UNATTENDED",
        "cardPresenceCapability": "CARD_PRESENT",
        "cardholderActivated": "AUTOMATED_DISPENSING_MACHINE_WITH_PIN",
        "inputCapability": "CHIP_AND_MAGNETIC_STRIPE",
        "lane": "PUMP0001",
        "location": "MERCHANT_TERMINAL_ON_PREMISES",
        "panEntryMode": "CONTACTLESS",
        "onlineReasonCode": "OVER_FLOOR_LIMIT",
        "pinEntryCapability": "PIN_SUPPORTED",
        "pinLengthCapability": 6
    },
    "transaction": {
        "source": "CARD_PRESENT"
    }
}
```

### Example of AFD Pre-Authorization request with SELF_SERVICE_TERMINAL {#example-of-afd-pre-authorization-request-with-self_service_terminal}

Applicable for the [Authorize](https://developer.mastercard.com/mastercard-gateway/documentation/api-reference/v100/rest/api-ops/index.md#transaction) transaction.

```json

{
    "apiOperation": "AUTHORIZE",
    "order": {
        "amount": "200",
        "currency": "AUD",
        "certainty": "ESTIMATED",
        "fuelDispenseType": "AUTOMATIC_FUEL_DISPENSING",
        "merchantCategoryCode":"5542"
    },
    "sourceOfFunds": {
        "provided": {
            "card": {
                "expiry": {
                    "month": "12",
                    "year": "39"
                },
                "number": "5123456789012346"
            }
        },
        "type": "CARD"
    },
    "posTerminal": {
        "address": {
            "street": "45 Park Ave",
            "city": "New York",
            "stateProvince": "NY",
            "postcodeZip": "10017",
            "country": "USA",
            "company": "City Parking Services"
        },
        "attended": "UNATTENDED",
        "cardPresenceCapability": "CARD_PRESENT",
        "cardholderActivated": "SELF_SERVICE_TERMINAL",
        "inputCapability": "CONTACTLESS_CHIP",
        "lane": "PUMP0101",
        "location": "MERCHANT_TERMINAL_ON_PREMISES",
        "panEntryMode": "CONTACTLESS"
    },
    "transaction": {
        "source": "CARD_PRESENT"
    }
}
```

```json
{
    "authorizationResponse": {
        "commercialCardIndicator": "3",
        "date": "0527",
        "financialNetworkCode": "XYZ",
        "financialNetworkDate": "2026-05-27",
        "posData": "1000004002300",
        "posEntryMode": "910",
        "processingCode": "003000",
        "responseCode": "00",
        "stan": "170767",
        "time": "083129",
        "transactionIdentifier": "063129"
    },
    "gatewayEntryPoint": "WEB_SERVICES_API",
    "merchant": "CYG_S2I_MER2",
    "order": {
        "amount": 200.00,
        "authenticationStatus": "AUTHENTICATION_NOT_IN_EFFECT",
        "certainty": "ESTIMATED",
        "chargeback": {
            "amount": 0,
            "currency": "AUD"
        },
        "creationTime": "2026-05-27T08:31:28.770Z",
        "currency": "AUD",
        "fuelDispenseType": "AUTOMATIC_FUEL_DISPENSING",
        "id": "AKS_68813727",
        "lastUpdatedTime": "2026-05-27T08:31:29.352Z",
        "merchantAmount": 200.00,
        "merchantCategoryCode": "5542",
        "merchantCurrency": "AUD",
        "status": "AUTHORIZED",
        "totalAuthorizedAmount": 200.00,
        "totalCapturedAmount": 0.00,
        "totalDisbursedAmount": 0.00,
        "totalRefundedAmount": 0.00
    },
    "posTerminal": {
        "address": {
            "city": "New York",
            "company": "City Parking Services",
            "country": "USA",
            "postcodeZip": "10017",
            "stateProvince": "NY",
            "street": "45 Park Ave"
        },
        "attended": "UNATTENDED",
        "cardPresenceCapability": "CARD_PRESENT",
        "cardholderActivated": "SELF_SERVICE_TERMINAL",
        "inputCapability": "CONTACTLESS_CHIP",
        "lane": "PUMP0101",
        "location": "MERCHANT_TERMINAL_ON_PREMISES",
        "panEntryMode": "CONTACTLESS",
        "pinEntryCapability": "UNKNOWN"
    },
    "response": {
        "acquirerCode": "00",
        "acquirerMessage": "Approved",
        "gatewayCode": "APPROVED",
        "gatewayRecommendation": "NO_ACTION"
    },
    "result": "SUCCESS",
    "sourceOfFunds": {
        "provided": {
            "card": {
                "brand": "MASTERCARD",
                "expiry": {
                    "month": "12",
                    "year": "39"
                },
                "fundingMethod": "DEBIT",
                "issuerCountryCode": "LBR",
                "number": "512345xxxxxx2346",
                "scheme": "MASTERCARD",
                "storedOnFile": "NOT_STORED"
            }
        },
        "type": "CARD"
    },
    "timeOfLastUpdate": "2026-05-27T08:31:29.352Z",
    "timeOfRecord": "2026-05-27T08:31:28.820Z",
    "transaction": {
        "acquirer": {
            "batch": 20260528,
            "date": "0528",
            "id": "CYG_TESTACQ_S2I",
            "merchantId": "9808",
            "transactionId": "063129"
        },
        "amount": 200.00,
        "authenticationStatus": "AUTHENTICATION_NOT_IN_EFFECT",
        "authorizationCode": "063129",
        "currency": "AUD",
        "id": "AKS_29958235",
        "receipt": "614708170767",
        "source": "CARD_PRESENT",
        "stan": "170767",
        "terminal": "0001",
        "type": "AUTHORIZATION"
    },
    "version": "100"
}
```

### Example of AFD Pre-Authorization Request with ECOM Scheme Token Device Payment {#example-of-afd-pre-authorization-request-with-ecom-scheme-token-device-payment}

Applicable for the [Authorize](https://developer.mastercard.com/mastercard-gateway/documentation/api-reference/v100/rest/api-ops/index.md#transaction) transaction and the **Mastercard** scheme.

```json

{
    "apiOperation": "AUTHORIZE",
    "transaction": {
        "source": "INTERNET"
    },
    "order": {
        "currency": "AUD",
        "amount": "200",
        "certainty": "ESTIMATED",
        "fuelDispenseType": "AUTOMATIC_FUEL_DISPENSING",
        "merchantCategoryCode": "5542"
    },
    "sourceOfFunds": {
        "type": "SCHEME_TOKEN",
        "provided": {
            "card": {
                "expiry": {
                    "month": "01",
                    "year": "39"
                },
                "devicePayment": {
                    "eciIndicator": "1"
                },
                "number": "5123456789012346",
                "securityCode": "123",
                "storedOnFile": "STORED"
            }
        }
    }
}
```

```json
{
    "authorizationResponse": {
        "cardSecurityCodeError": "M",
        "commercialCardIndicator": "3",
        "date": "0604",
        "financialNetworkCode": "XYZ",
        "financialNetworkDate": "2026-06-04",
        "posData": "1025104006600",
        "posEntryMode": "812",
        "processingCode": "003000",
        "responseCode": "00",
        "stan": "171805",
        "time": "044208",
        "transactionIdentifier": "024208",
        "transactionLinkIdentifier": "R006CzlPT5SYwrvfkbxAqw"
    },
    "gatewayEntryPoint": "WEB_SERVICES_API",
    "merchant": "CYG_S2I_MER2",
    "order": {
        "amount": 200.00,
        "authenticationStatus": "AUTHENTICATION_NOT_IN_EFFECT",
        "certainty": "ESTIMATED",
        "chargeback": {
            "amount": 0,
            "currency": "AUD"
        },
        "creationTime": "2026-06-04T04:42:08.134Z",
        "currency": "AUD",
        "fuelDispenseType": "AUTOMATIC_FUEL_DISPENSING",
        "id": "AKS_29045623",
        "lastUpdatedTime": "2026-06-04T04:42:08.620Z",
        "merchantAmount": 200.00,
        "merchantCategoryCode": "5542",
        "merchantCurrency": "AUD",
        "status": "AUTHORIZED",
        "totalAuthorizedAmount": 200.00,
        "totalCapturedAmount": 0.00,
        "totalDisbursedAmount": 0.00,
        "totalRefundedAmount": 0.00
    },
    "response": {
        "acquirerCode": "00",
        "acquirerMessage": "Approved",
        "cardSecurityCode": {
            "acquirerCode": "M",
            "gatewayCode": "MATCH"
        },
        "gatewayCode": "APPROVED",
        "gatewayRecommendation": "NO_ACTION"
    },
    "result": "SUCCESS",
    "sourceOfFunds": {
        "provided": {
            "card": {
                "brand": "MASTERCARD",
                "deviceSpecificExpiry": {
                    "month": "1",
                    "year": "39"
                },
                "deviceSpecificNumber": "512345xxxxxx2346",
                "expiry": {
                    "month": "1",
                    "year": "39"
                },
                "fundingMethod": "UNKNOWN",
                "issuerCountryCode": "LBR",
                "number": "xxxxxxxxxxxxxxxx",
                "scheme": "MASTERCARD",
                "storedOnFile": "STORED"
            }
        },
        "type": "SCHEME_TOKEN"
    },
    "timeOfLastUpdate": "2026-06-04T04:42:08.620Z",
    "timeOfRecord": "2026-06-04T04:42:08.249Z",
    "transaction": {
        "acquirer": {
            "batch": 20260604,
            "date": "0604",
            "id": "CYG_TESTACQ_S2I",
            "merchantId": "9808",
            "transactionId": "024208"
        },
        "amount": 200.00,
        "authenticationStatus": "AUTHENTICATION_NOT_IN_EFFECT",
        "authorizationCode": "024208",
        "currency": "AUD",
        "id": "AKS_24858260",
        "receipt": "615504171805",
        "source": "INTERNET",
        "stan": "171805",
        "terminal": "0001",
        "type": "AUTHORIZATION"
    },
    "version": "100"
}
```

### Example of AFD Authorization Advice request {#example-of-afd-authorization-advice-request}

Applicable for the [Update Authorization](https://developer.mastercard.com/mastercard-gateway/documentation/api-reference/v100/rest/api-ops/index.md#transaction) or Advice transaction.

```json
{
     "apiOperation": "UPDATE_AUTHORIZATION",
     "transaction": {
         "amount": "100",
         "currency": "AUD"
     }
 }
```

```json
{
    "authorizationResponse": {
        "commercialCard": "!01",
        "commercialCardIndicator": "0",
        "date": "0604",
        "posData": "1000004001500",
        "posEntryMode": "071",
        "processingCode": "003000",
        "responseCode": "00",
        "returnAci": "Y",
        "stan": "171809",
        "time": "085917",
        "transactionIdentifier": "678901112200024",
        "validationCode": "4444"
    },
    "gatewayEntryPoint": "WEB_SERVICES_API",
    "merchant": "CYG_S2I_MER2",
    "order": {
        "amount": 100,
        "certainty": "ESTIMATED",
        "chargeback": {
            "amount": 0,
            "currency": "AUD"
        },
        "creationTime": "2026-06-04T08:58:58.731Z",
        "currency": "AUD",
        "fuelDispenseType": "AUTOMATIC_FUEL_DISPENSING",
        "id": "AKS_83189443",
        "lastUpdatedTime": "2026-06-04T08:59:17.566Z",
        "merchantAmount": 100,
        "merchantCategoryCode": "5542",
        "merchantCurrency": "AUD",
        "status": "AUTHORIZED",
        "totalAuthorizedAmount": 100,
        "totalCapturedAmount": 0,
        "totalDisbursedAmount": 0,
        "totalRefundedAmount": 0
    },
    "posTerminal": {
        "address": {
            "city": "New York",
            "company": "City Parking Services",
            "country": "USA",
            "postcodeZip": "10017",
            "stateProvince": "NY",
            "street": "45 Park Ave"
        },
        "attended": "UNATTENDED",
        "cardPresenceCapability": "CARD_PRESENT",
        "cardholderActivated": "AUTOMATED_DISPENSING_MACHINE_WITH_PIN",
        "inputCapability": "CHIP_AND_MAGNETIC_STRIPE",
        "lane": "PUMP0001",
        "location": "MERCHANT_TERMINAL_ON_PREMISES",
        "onlineReasonCode": "OVER_FLOOR_LIMIT",
        "panEntryMode": "CONTACTLESS",
        "pinEntryCapability": "PIN_SUPPORTED",
        "pinLengthCapability": 6
    },
    "response": {
        "acquirerCode": "00",
        "acquirerMessage": "Approved",
        "gatewayCode": "APPROVED"
    },
    "result": "SUCCESS",
    "sourceOfFunds": {
        "provided": {
            "card": {
                "brand": "VISA",
                "emvResponse": {
                    "71": "0102030405060708090A",
                    "91": "2263BCC1C2D9C4420013"
                },
                "expiry": {
                    "month": "1",
                    "year": "39"
                },
                "fundingMethod": "DEBIT",
                "issuerCountryCode": "GBR",
                "number": "450875xxxxxx1019",
                "scheme": "VISA",
                "sequenceNumber": "001",
                "storedOnFile": "NOT_STORED",
                "trackDataProvided": true
            }
        },
        "type": "CARD"
    },
    "timeOfLastUpdate": "2026-06-04T08:59:17.566Z",
    "timeOfRecord": "2026-06-04T08:59:17.206Z",
    "transaction": {
        "acquirer": {
            "batch": 20260605,
            "date": "0605",
            "id": "CYG_TESTACQ_S2I",
            "merchantId": "9808",
            "transactionId": "678901112200024"
        },
        "amount": 100,
        "authorizationAdjustmentAmount": -100,
        "authorizationCode": "065859",
        "currency": "AUD",
        "id": "AKS_16239080",
        "receipt": "615508172839",
        "source": "CARD_PRESENT",
        "stan": "172839",
        "terminal": "0002",
        "type": "AUTHORIZATION_UPDATE"
    },
    "version": "100"
}
```

### Example of Capture {#example-of-capture}

Applicable for the [Capture](https://developer.mastercard.com/mastercard-gateway/documentation/api-reference/v100/rest/api-ops/index.md#transaction) transaction.

```json
 {
     "apiOperation": "CAPTURE",
     "transaction": {
         "amount": "180",
         "currency": "AUD"
     }
 }
```

```json
 {
      "authorizationResponse": {
          "commercialCardIndicator": "3",
          "date": "0527",
          "financialNetworkCode": "MCC",
          "financialNetworkDate": "2026-05-27",
          "posData": "1000004002300",
          "posEntryMode": "910",
          "processingCode": "003000",
          "responseCode": "00",
          "stan": "170767",
          "time": "083129",
          "transactionIdentifier": "063129"
      },
      "gatewayEntryPoint": "WEB_SERVICES_API",
      "merchant": "CYG_S2I_MER2",
      "order": {
          "amount": 180.00,
          "certainty": "ESTIMATED",
          "chargeback": {
              "amount": 0,
              "currency": "AUD"
          },
          "creationTime": "2026-05-27T08:31:28.770Z",
          "currency": "AUD",
          "fuelDispenseType": "AUTOMATIC_FUEL_DISPENSING",
          "id": "AKS_68813727",
          "lastUpdatedTime": "2026-05-27T08:32:02.399Z",
          "merchantAmount": 180.00,
          "merchantCategoryCode": "5542",
          "merchantCurrency": "AUD",
          "status": "CAPTURED",
          "totalAuthorizedAmount": 180.00,
          "totalCapturedAmount": 180.00,
          "totalDisbursedAmount": 0.00,
          "totalRefundedAmount": 0.00
      },
      "posTerminal": {
          "address": {
              "city": "New York",
              "company": "City Parking Services",
              "country": "USA",
              "postcodeZip": "10017",
              "stateProvince": "NY",
              "street": "45 Park Ave"
          },
          "attended": "UNATTENDED",
          "cardPresenceCapability": "CARD_PRESENT",
          "cardholderActivated": "SELF_SERVICE_TERMINAL",
          "inputCapability": "CONTACTLESS_CHIP",
          "lane": "PUMP0101",
          "location": "MERCHANT_TERMINAL_ON_PREMISES",
          "panEntryMode": "CONTACTLESS",
          "pinEntryCapability": "UNKNOWN"
      },
      "response": {
          "acquirerCode": "00",
          "acquirerMessage": "Approved",
          "gatewayCode": "APPROVED"
      },
      "result": "SUCCESS",
      "sourceOfFunds": {
          "provided": {
              "card": {
                  "brand": "MASTERCARD",
                  "expiry": {
                      "month": "12",
                      "year": "39"
                  },
                  "fundingMethod": "DEBIT",
                  "issuerCountryCode": "LBR",
                  "number": "512345xxxxxx2346",
                  "scheme": "MASTERCARD",
                  "storedOnFile": "NOT_STORED"
              }
          },
          "type": "CARD"
      },
      "timeOfLastUpdate": "2026-05-27T08:32:02.399Z",
      "timeOfRecord": "2026-05-27T08:32:02.133Z",
      "transaction": {
          "acquirer": {
              "batch": 20260528,
              "date": "0528",
              "id": "CYG_TESTACQ_S2I",
              "merchantId": "9808",
              "settlementDate": "2026-05-28",
              "timeZone": "+1000",
              "transactionId": "063129"
          },
          "amount": 180.00,
          "authorizationCode": "063129",
          "currency": "AUD",
          "id": "AKS_558703889",
          "receipt": "614708170767",
          "source": "CARD_PRESENT",
          "stan": "174917",
          "terminal": "0001",
          "type": "CAPTURE"
      },
      "version": "100"
  }
```

### Example of Void {#example-of-void}

Applicable for the [Void](https://developer.mastercard.com/mastercard-gateway/documentation/api-reference/v100/rest/api-ops/index.md#transaction) transaction.

```json
 {
     "apiOperation": "VOID",
     "transaction": {
         "targetTransactionId": "AKS_17832046"
     }
 }
```

```json
 {
    "authorizationResponse": {
        "commercialCardIndicator": "3",
        "date": "0528",
        "financialNetworkCode": "MCC",
        "financialNetworkDate": "2026-05-28",
        "posData": "1000004002300",
        "posEntryMode": "910",
        "processingCode": "003000",
        "responseCode": "00",
        "stan": "175967",
        "time": "084300",
        "transactionIdentifier": "064300"
    },
    "gatewayEntryPoint": "WEB_SERVICES_API",
    "merchant": "CYG_S2I_MER2",
    "order": {
        "amount": 150.00,
        "certainty": "ESTIMATED",
        "chargeback": {
            "amount": 0,
            "currency": "AUD"
        },
        "creationTime": "2026-05-28T08:43:00.367Z",
        "currency": "AUD",
        "fuelDispenseType": "AUTOMATIC_FUEL_DISPENSING",
        "id": "AKS_94646608",
        "lastUpdatedTime": "2026-05-28T08:43:40.946Z",
        "merchantAmount": 150.00,
        "merchantCategoryCode": "5542",
        "merchantCurrency": "AUD",
        "status": "CANCELLED",
        "totalAuthorizedAmount": 0.00,
        "totalCapturedAmount": 0.00,
        "totalDisbursedAmount": 0.00,
        "totalRefundedAmount": 0.00
    },
    "posTerminal": {
        "address": {
            "city": "New York",
            "company": "City Parking Services",
            "country": "USA",
            "postcodeZip": "10017",
            "stateProvince": "NY",
            "street": "45 Park Ave"
        },
        "attended": "UNATTENDED",
        "cardPresenceCapability": "CARD_PRESENT",
        "cardholderActivated": "SELF_SERVICE_TERMINAL",
        "inputCapability": "CONTACTLESS_CHIP",
        "lane": "PUMP0101",
        "location": "MERCHANT_TERMINAL_ON_PREMISES",
        "panEntryMode": "CONTACTLESS",
        "pinEntryCapability": "UNKNOWN"
    },
    "response": {
        "acquirerCode": "00",
        "acquirerMessage": "Approved",
        "gatewayCode": "APPROVED"
    },
    "result": "SUCCESS",
    "sourceOfFunds": {
        "provided": {
            "card": {
                "brand": "MASTERCARD",
                "expiry": {
                    "month": "12",
                    "year": "39"
                },
                "fundingMethod": "DEBIT",
                "issuerCountryCode": "LBR",
                "number": "512345xxxxxx2346",
                "scheme": "MASTERCARD",
                "storedOnFile": "NOT_STORED"
            }
        },
        "type": "CARD"
    },
    "timeOfLastUpdate": "2026-05-28T08:43:40.946Z",
    "timeOfRecord": "2026-05-28T08:43:40.698Z",
    "transaction": {
        "acquirer": {
            "batch": 20260529,
            "date": "0529",
            "id": "CYG_TESTACQ_S2I",
            "merchantId": "9808",
            "transactionId": "064300"
        },
        "amount": 150.00,
        "currency": "AUD",
        "id": "AKS_510419609",
        "receipt": "614808166678",
        "source": "CARD_PRESENT",
        "stan": "167678",
        "targetTransactionId": "AKS_66771554",
        "terminal": "0002",
        "type": "VOID_AUTHORIZATION"
    },
    "version": "100"
}
```