Auth API Webhook 2.0

With the Auth API 2.0 webhook, you can participate in authorization decisions. For this webhook there is only one verb: POST. Galileo sends information about the authorization request in the body of the HTTP request, in JSON. Your decision should be in the body of the HTTP response.

In the authorization information that Galileo sends, the response_code is the current response code to be returned to the merchant, unless you override it. Use the response_code field in the HTTP response body to override the authorization response code, as desired.

See the Authorization Controller API guide for more information.

📘

About the field properties

Galileo initializes the webhook payload by setting all fields to null. As values come in with the ISO 8583 authorization request, Galileo populates the respective payload fields with the data the network sends, which can include empty strings (" "). This documentation shows the field properties (data type, nullability, required) that are most likely. However, variations by network and transaction type mean that a few of the values passed in the webhook payload can vary from what is shown here.

{
  "auth_type": "Auth",
  "merchant": {
    "merchant_id": "111111111111",
    "acquirer_id": "33333",
    "terminal_network": null,
    "merchant_description": "APPLE.COM/BILL         866-712-7753  CA ",
    "merchant_country": "840",
    "terminal_id": "222222",
    "merchant_state": "CA",
    "merchant_postal_code": "95014"
  },
  "risk_code": "39",
  "ecommerce": {
    "raw_eci": "210",
    "merchant_asserts_data_protection": true,
    "is_ecommerce": true,
    "merchant_asserts_authenticated": false,
    "merchant_asserts_authentication_attempted": false,
    "merchant_authentication_assertions_validated": null
  },
  "pin_entry_capability": "Other",
  "advanced_auth_api_fields": null,
  "service_processing_type": null,
  "timestamp": "20250702:172327MST",
  "mcc": 5818,
  "avs_data": {
    "zip": "999999999",
    "address": "*****"
  },
  "original_id": 0,
  "international": false,
  "id": "obiFh9L8ioy4_rZB_AQ12A",
  "eligible_for_balance_return": false,
  "validation_results": {
    "arqc": "N",
    "cvv3": "N",
    "pin": "N",
    "avs_result": "Y",
    "aav": "N",
    "cvv1": "N",
    "offline_pin": "N",
    "cvv2": "N"
  },
  "auth_id": 5555555,
  "account": {
    "track_expiration_date": null,
    "xid": 4444444,
    "merchant_supplied_expiration_date": "2712",
    "account_status": "N",
    "expiration_date": "2712",
    "prn": "999101661602",
    "card_status": "N",
    "pan": "3293",
    "cad": 55555
  },
  "transaction": {
    "transaction_initiator_code": "M101",
    "cardholder_present": "N",
    "recurring": "Y"
  },
  "network": "Mastercard",
  "amounts": {
    "cashback_amount": "0.0",
    "local_currency_amount": "1.99",
    "upcharge_amount": "0.0",
    "billing_currency_amount": "1.99",
    "trans_amount": "1.99",
    "available_funds": "3.75",
    "billing_currency": "840",
    "currency": "840",
    "amt_til_limit": "2500",
    "local_currency": "840",
    "exchange_rate": "61000000",
    "fee_amount": "0.00"
  },
  "entry_type": "Card On File",
  "response_code": "00",
  "response_code_list": [],
  "emv": {
    "is_emv": false
  },
  "transaction_type": "Auth",
  "risk_score": "1",
  "version": "2.0",
  "partial_supported": false,
  "subnetwork": "Mastercard Banknet",
  "mti": "0100",
  "bai": null
}

{
  "auth_type": "Auth",
  "merchant": {
    "merchant_id": "MMMMMMMMM",
    "acquirer_id": "777777",
    "terminal_network": null,
    "merchant_description": "LYFT   *XD RENTAL FEE  SAN FRANCISCO CA ",
    "merchant_country": "840",
    "terminal_id": "ZZZZZZ",
    "merchant_state": "CA",
    "merchant_postal_code": "94104"
  },
  "risk_code": "43",
  "ecommerce": {
    "raw_eci": "210",
    "merchant_asserts_data_protection": true,
    "is_ecommerce": true,
    "merchant_asserts_authenticated": false,
    "merchant_asserts_authentication_attempted": false,
    "merchant_authentication_assertions_validated": null
  },
  "pin_entry_capability": "Other",
  "advanced_auth_api_fields": {
    "7": "0703002327",
    "12": "172327",
    "13": "0702",
    "48": {
      "subfield 75": "01036510202430303651040243050200",
      "subfield 33": "",
      "subfield 71": "18C ",
      "subfield 61": "00001",
      "subfield 95": ""
    },
    "22": {
      "subfield 2": "0"
    },
    "61": {
      "subfield 8": "0",
      "subfield 1": "1",
      "subfield 3": "2",
      "subfield 4": "5",
      "subfield 5": "1",
      "subfield 6": "1",
      "subfield 7": "0",
      "subfield 12": "00",
      "subfield 10": "6"
    },
    "63": {
      "subfield 2": "MAOMKH"
    "
    }
  },
  "service_processing_type": null,
  "timestamp": "20250702:172327MST",
  "mcc": 4121,
  "avs_data": {
    "zip": "22222",
    "address": "*****"
  },
  "original_id": 0,
  "international": false,
  "id": "vDD2EvC0RUSwe_VRyzQbD0",
  "eligible_for_balance_return": false,
  "validation_results": {
    "arqc": "N",
    "cvv3": "N",
    "pin": "N",
    "avs_result": "Z",
    "aav": "N",
    "cvv1": "N",
    "offline_pin": "N",
    "cvv2": "N"
  },
  "auth_id": 22222222,
  "account": {
    "track_expiration_date": null,
    "xid": 4444444,
    "merchant_supplied_expiration_date": "3006",
    "account_status": "N",
    "expiration_date": "3006",
    "prn": "999166760171",
    "card_status": "N",
    "pan": "0854",
    "cad": 7777777
  },
  "transaction": {
    "transaction_initiator_code": "C101",
    "cardholder_present": "N",
    "recurring": "N"
  },
  "network": "Mastercard",
  "amounts": {
    "cashback_amount": "0.0",
    "local_currency_amount": "44.60",
    "upcharge_amount": "0.0",
    "billing_currency_amount": "44.60",
    "trans_amount": "44.60",
    "available_funds": "-52133.25",
    "billing_currency": "840",
    "currency": "840",
    "amt_til_limit": "14934.07",
    "local_currency": "840",
    "exchange_rate": "61000000",
    "fee_amount": "0.00"
  },
  "entry_type": "Card On File",
  "response_code": "51",
  "response_code_list": [
    "51"
  ],
  "emv": {
    "is_emv": false
  },
  "transaction_type": "Auth",
  "risk_score": "651",
  "version": "2.0",
  "partial_supported": false,
  "subnetwork": "Mastercard Banknet",
  "mti": "0100",
  "bai": null
}
Language
Credentials
Bearer
JWT

© Galileo Financial Technologies, LLC 2025    Privacy Disclosure

All documentation, including but not limited to text, graphics, images, and any other content, are the exclusive property of Galileo Financial Technologies, LLC and are protected by copyright laws. These materials may not be reproduced, distributed, transmitted, displayed, or otherwise used without the prior written permission of Galileo Financial Technologies, LLC. Any unauthorized use or reproduction of these materials are expressly prohibited.