Introduction

This page offers practical illustrations of real transaction data, showcasing how it aligns with corresponding data objects in real-world transaction scenarios. These illustrations are intended to help you understand the key data elements for your application and how they will be delivered to you. To ensure privacy, certain details have been altered for individuals and merchants.

For a comprehensive understanding, we suggest exploring Transaction Messages, Transactions, and Enrichments prior to engaging with this content.

Examples

Restaurant

Authorization Request

An Authorization Request is a check with the card issuer to see whether the transaction can go ahead.

{
  "id": "b64deaa6-5974-4e8a-afe9-83caa393fef5",
  "acceptor": {
    "id": "KWGBYTEI4FL0QQQ",
    "acquirerId": "018505",
    "city": "Jersey City",
    "country": "USA",
    "mcc": "5812",
    "name": "ASTRADA DINER",
    "state": "NJ"
  },
  "approvalCode": "940594",
  "cardId": "3c4b862f-607f-4873-be08-e5336d2c2745",
  "cardholderBillingAmount": 98.30,
  "cardholderBillingCurrency": "USD",
  "createdDateTime": "2023-11-08T18:12:41.251Z",
  "dateTime": "2023-11-08T18:12:35",
  "messageType": "AUTH_REQU",
  "network": "MASTERCARD",
  "programId": "15e09ab7-3559-4b84-88a8-e2e1f4ceb1f5",
  "result": "APPROVED",
  "amount": 98.30,
  "currency": "USD",
  "transactionReference": "TYSO88_2023-11-08",
  "transactionType": "DEBIT_01",
  "transmissionDateTime": null
}

Financial Advice

A financial advice triggers the movement of funds after a non-financial authorization.

{
    "id": "b64deaa6-5974-4e8a-afe9-83caa393fef5",
    "acceptor": {
      "id": "KWGBYTEI4FL0QQQ",
      "acquirerId": "018505",
      "city": "Jersey City",
      "country": "USA",
      "mcc": "5812",
      "name": "ASTRADA DINER",
      "state": "NJ"
    },
    "approvalCode": null,
    "cardId": "3c4b862f-607f-4873-be08-e5336d2c2745",
    "cardholderBillingAmount": 98.30,
    "cardholderBillingCurrency": "USD",
    "createdDateTime": "2023-11-10T10:12:41.251Z",
    "dateTime": "2023-11-10T10:12:00",
    "messageType": "FINL_ADVC",
    "network": "MASTERCARD",
    "programId": "15e09ab7-3559-4b84-88a8-e2e1f4ceb1f5",
    "result": "APPROVED",
    "amount": 98.30,
    "currency": "USD",
    "transactionReference": "TYSO88_2023-11-08",
    "transactionType": "DEBIT_01",
    "transmissionDateTime": "2023-11-10T10:12:35.000Z"
  }

Hotel

Authorization Request

An Authorization Request is a check with the card issuer to see whether the transaction can go ahead.

{
    "id": "b64deaa6-5974-4e8a-afe9-83caa393fef5",
    "acceptor": {
      "id": "KWGBYTEI4FL0QQQ",
      "acquirerId": "018505",
      "city": "Yorkshire Dales",
      "country": "GBR",
      "mcc": "7011",
      "name": "ASTRADA HOTEL",
      "state": null
    },
    "approvalCode": "YHQBTB",
    "cardId": "3c4b862f-607f-4873-be08-e5336d2c2745",
    "cardholderBillingAmount": 1385.78,
    "cardholderBillingCurrency": "USD",
    "createdDateTime": "2023-11-08T18:12:41.251Z",
    "dateTime": "2023-11-08T18:12:35",
    "messageType": "AUTH_REQU",
    "network": "MASTERCARD",
    "programId": "15e09ab7-3559-4b84-88a8-e2e1f4ceb1f5",
    "result": "APPROVED",
    "amount": 1095.13,
    "currency": "GBP",
    "transactionReference": "XZSO87_2023-11-08",
    "transactionType": null,
    "transmissionDateTime": "2023-11-08T18:12:35.000Z"
  }

Financial Advice

A financial advice triggers the movement of funds after a non-financial authorization.

{
      "id": "b64deaa6-5974-4e8a-afe9-83caa393fef5",
      "acceptor": {
        "id": "KWGBYTEI4FL0QQQ",
        "acquirerId": "018505",
        "city": null,
        "country": "GBR",
        "mcc": "7011",
        "name": "ASTRADA HOTEL",
        "state": null
      },
      "approvalCode": "YHQBTB",
      "cardId": "3c4b862f-607f-4873-be08-e5336d2c2745",
      "cardholderBillingAmount": 1385.78,
      "cardholderBillingCurrency": "USD",
      "createdDateTime": "2023-11-10T10:12:41.251Z",
      "dateTime": "2023-11-10T10:12:00",
      "messageType": "FINL_ADVC",
      "network": "MASTERCARD",
      "programId": "15e09ab7-3559-4b84-88a8-e2e1f4ceb1f5",
      "result": "APPROVED",
      "amount": 1095.13,
      "currency": "GBP",
      "transactionReference": "XZSO87_2023-11-08",
      "transactionType": "DEBIT_01",
      "transmissionDateTime": "2023-11-10T10:12:35.000Z"
    }

Lodging Enrichment

The below object is an example of how the lodging enrichment data for a hotel may look, however please note that data enrichment is in active development and as such, changes might occur before the final version is confirmed.

{
  "id": "d3221e18-dcab-4da9-90e4-762bdffd0cf6",
  "property": {
    "Name": "ASTRADA HOTEL",
    "Country": "GBR"
  },
  "checkInDate": "2023-10-06",
  "checkOutDate": "2023-08-08",
  "totalAmount": {
    "amount": 1095.13,
    "currency": "GBP"
  },
  "totalTax": {
    "amount": 95.28,
    "currency": "GBP"
  },
  "charges": [
    {
      "chargeType": "Room",
      "lodgingNights": 4,
      "perUnitAmount": {
        "amount": 689,
        "currency": "GBP"
      },
      "perUnitTax": {
        "amount": 23.82,
        "currency": "GBP"
      }
    },
    {
      "chargeType": "Other",
      "units": 1,
      "perUnitAmount": {
        "amount": 30,
        "currency": "GBP"
      },
      "perUnitTax": {
        "amount": 3,
        "currency": "GBP"
      }
    }
  ]
}

Gas

Authorization Request

An Authorization Request is a check with the card issuer to see whether the transaction can go ahead.

{
    "id": "b64deaa6-5974-4e8a-afe9-83caa393fef5",
    "acceptor": {
      "id": "KWGBYTEI4FL0QQQ",
      "acquirerId": "018505",
      "city": "Hamilton",
      "country": "USA",
      "mcc": "5542",
      "name": "ASTRADA GAS STATION",
      "state": null
    },
    "approvalCode": "007024",
    "cardId": "3c4b862f-607f-4873-be08-e5336d2c2745",
    "cardholderBillingAmount": 100.00,
    "cardholderBillingCurrency": "USD",
    "createdDateTime": "2023-11-08T18:12:41.251Z",
    "dateTime": "2023-11-08T18:12:35",
    "messageType": "AUTH_REQU",
    "network": "MASTERCARD",
    "programId": "15e09ab7-3559-4b84-88a8-e2e1f4ceb1f5",
    "result": "APPROVED",
    "amount": 100.00,
    "currency": "USD",
    "transactionReference": "QIO6YB_2023-11-08", 
    "transactionType": null,
    "transmissionDateTime": "2023-11-08T18:12:35.000Z"
  }

Authorization Advice

The authorization advice updates the authorized amount before the funds are cleared.

If the authorization amount is positive, it replaces the previously authorized balance. If the amount is negative, this means that the original authorization request is being reversed or voided. This happens when a merchant cancels a purchase before the funds are cleared.

{
    "id": "b64deaa6-5974-4e8a-afe9-83caa393fef5",
    "acceptor": {
      "id": "KWGBYTEI4FL0QQQ",
      "acquirerId": "018505",
      "city": "Hamilton",
      "country": "USA",
      "mcc": "5542",
      "name": "ASTRADA GAS STATION",
      "state": null
    },
    "approvalCode": "007024",
    "cardId": "3c4b862f-607f-4873-be08-e5336d2c2745",
    "cardholderBillingAmount": 89.90,
    "cardholderBillingCurrency": "USD",
    "createdDateTime": "2023-11-08T18:12:41.251Z",
    "dateTime": "2023-11-08T18:12:35",
    "messageType": "AUTH_ADVC",
    "network": "MASTERCARD",
    "programId": "15e09ab7-3559-4b84-88a8-e2e1f4ceb1f5",
    "result": "APPROVED",
    "amount": 89.90,
    "currency": "USD",
    "transactionReference": "QIO6YB_2023-11-08",
    "transactionType": null,
    "transmissionDateTime": "2023-11-08T18:12:35.000Z"
  }

Financial Advice

A financial advice triggers the movement of funds after a non-financial authorization.

{
      "id": "b64deaa6-5974-4e8a-afe9-83caa393fef5",
      "acceptor": {
        "id": "KWGBYTEI4FL0QQQ",
        "acquirerId": "018505",
        "city": "Hamilton",
        "country": "USA",
        "mcc": "5542",
        "name": "ASTRADA GAS STATION",
        "state": null
      },
      "approvalCode": "007024",
      "cardId": "3c4b862f-607f-4873-be08-e5336d2c2745",
      "cardholderBillingAmount": 89.90,
      "cardholderBillingCurrency": "USD",
      "createdDateTime": "2023-11-10T10:12:41.251Z",
      "dateTime": "2023-11-10T10:12:00",
      "messageType": "FINL_ADVC",
      "network": "MASTERCARD",
      "programId": "15e09ab7-3559-4b84-88a8-e2e1f4ceb1f5",
      "result": "APPROVED",
      "amount": 89.90,
      "currency": "USD",
      "transactionReference": "QIO6YB_2023-11-08",
      "transactionType": "DEBIT_01",
      "transmissionDateTime": null
    }

Ride share

Authorization Request

An Authorization Request is a check with the card issuer to see whether the transaction can go ahead.

{
    "id": "b64deaa6-5974-4e8a-afe9-83caa393fef5",
    "acceptor": {
      "id": "KWGBYTEI4FL0QQQ",
      "acquirerId": "018505",
      "city": "San Francisco",
      "country": "USA",
      "mcc": null,
      "name": "RIDE SHARE * PENDING",
      "state": "CA"
    },
    "approvalCode": "YHQBTB",
    "cardId": "3c4b862f-607f-4873-be08-e5336d2c2745",
    "cardholderBillingAmount": 15.20,
    "cardholderBillingCurrency": "USD",
    "createdDateTime": "2023-11-08T18:12:41.251Z",
    "dateTime": "2023-11-08T18:12:35",
    "messageType": "AUTH_REQU",
    "network": "MASTERCARD",
    "programId": "15e09ab7-3559-4b84-88a8-e2e1f4ceb1f5",
    "result": "APPROVED",
    "amount": 15.20,
    "currency": "USD",
    "transactionReference": "LC8IBS_2023-11-08", 
    "transactionType": "DEBIT_01",
    "transmissionDateTime": "2023-11-08T18:12:35.000Z"
  }

Financial Advice

A financial advice triggers the movement of funds after a non-financial authorization.

 {
      "id": "b64deaa6-5974-4e8a-afe9-83caa393fef5",
      "acceptor": {
        "id": "KWGBYTEI4FL0QQQ",
        "acquirerId": "018505",
        "city": "San Francisco",
        "country": "USA",
        "mcc": "4121",
        "name": "RIDE SHARE * PENDING",
        "state": "CA"
      },
      "approvalCode": "YHQBTB",
      "cardId": "3c4b862f-607f-4873-be08-e5336d2c2745",
      "cardholderBillingAmount": 15.20,
      "cardholderBillingCurrency": "USD",
      "createdDateTime": "2023-11-10T10:12:41.251Z",
      "dateTime": "2023-11-10T10:12:00",
      "messageType": "FINL_ADVC",
      "network": "MASTERCARD",
      "programId": "15e09ab7-3559-4b84-88a8-e2e1f4ceb1f5",
      "result": "APPROVED",
      "amount": 15.20,
      "currency": "USD",
      "transactionReference": "LC8IBS_2023-11-08",
      "transactionType": null,
      "transmissionDateTime": null
    }

Airline

Authorization Request

An Authorization Request is a check with the card issuer to see whether the transaction can go ahead.

{
    "id": "b64deaa6-5974-4e8a-afe9-83caa393fef5",
    "acceptor": {
      "id": "KWGBYTEI4FL0QQQ",
      "acquirerId": "018505",
      "city": "FOREST HILLS",
      "country": "USA",
      "mcc": "3174",
      "name": "ASTRADA AIRLINE",
      "state": "NY"
    },
    "approvalCode": "04651Z",
    "cardId": "3c4b862f-607f-4873-be08-e5336d2c2745",
    "cardholderBillingAmount": 160.00,
    "cardholderBillingCurrency": "USD",
    "createdDateTime": "2023-11-08T18:12:41.251Z",
    "dateTime": "2023-11-08T18:12:35",
    "messageType": "AUTH_REQU",
    "network": "MASTERCARD",
    "programId": "15e09ab7-3559-4b84-88a8-e2e1f4ceb1f5",
    "result": "APPROVED",
    "amount": 160.00,
    "currency": "USD",
    "transactionReference": "FHO06Y_2023-11-08", 
    "transactionType": "DEBIT_01",
    "transmissionDateTime": "2023-11-08T18:12:35.000Z"
  }

Financial Advice

A financial advice triggers the movement of funds after a non-financial authorization.

{
      "id": "b64deaa6-5974-4e8a-afe9-83caa393fef5",
      "acceptor": {
        "id": "KWGBYTEI4FL0QQQ",
        "acquirerId": "018505",
        "city": null,
        "country": "USA",
        "mcc": "3174",
        "name": "ASTRADA AIRLINE",
        "state": "NY"
      },
      "approvalCode": "04651Z",
      "cardId": "3c4b862f-607f-4873-be08-e5336d2c2745",
      "cardholderBillingAmount": 160.00,
      "cardholderBillingCurrency": "USD",
      "createdDateTime": "2023-11-10T10:12:41.251Z",
      "dateTime": "2023-11-10T10:12:00",
      "messageType": "FINL_ADVC",
      "network": "MASTERCARD",
      "programId": "15e09ab7-3559-4b84-88a8-e2e1f4ceb1f5",
      "result": "APPROVED",
      "amount": 160.00,
      "currency": "USD",
      "transactionReference": "FHO06Y_2023-11-08",
      "transactionType": "DEBIT_01",
      "transmissionDateTime": "2023-11-10T10:12:35.000Z"
    }