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
}