With the Auth API 3.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.
Open the Recipes below to see webhook examples that you can use for testing.
{
"auth_type": "Auth",
"merchant": {
"merchant_id": "KKKKKKKKKKKKK",
"acquirer_id": "444444",
"terminal_network": null,
"merchant_description": "DD *DOORDASH ST.LOUISF +16506819470 CAUS",
"merchant_country": "840",
"terminal_id": "SP01 ",
"merchant_state": "CA",
"merchant_postal_code": "94107"
},
"risk_code": "None",
"ecommerce": {
"raw_eci": "05",
"merchant_asserts_data_protection": true,
"is_ecommerce": true,
"merchant_asserts_authenticated": true,
"merchant_asserts_authentication_attempted": true,
"merchant_authentication_assertions_validated": null
},
"pin_entry_capability": "Incapable",
"advanced_auth_api_fields": null,
"service_processing_type": " ",
"timestamp": "20250702:171855MST",
"response_code_objects": {},
"mcc": 5812,
"avs_data": {
"zip": "33333",
"address": ""
},
"original_id": 0,
"international": false,
"id": "doll6wLwnzi5wv1Q2zTolS",
"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": 8888888888,
"account": {
"track_expiration_date": null,
"xid": 44444444,
"merchant_supplied_expiration_date": "2701",
"account_status": "N",
"expiration_date": "2701",
"prn": "999143651831",
"card_status": "N",
"pan": "55555",
"cad": 9999999
},
"transaction": {
"cardholder_present": "N",
"recurring": "N"
},
"network": "Visa",
"amounts": {
"cashback_amount": "0.0",
"local_currency_amount": "34.27",
"upcharge_amount": "0.0",
"billing_currency_amount": "34.27",
"trans_amount": "34.27",
"available_funds": "559.49",
"billing_currency": "840",
"currency": "840",
"amt_til_limit": "2429.26",
"local_currency": "840",
"exchange_rate": "61000000",
"fee_amount": "0.00"
},
"entry_type": "Card Not Present",
"response_code": "00",
"emv": {
"is_emv": false
},
"transaction_type": "Auth",
"risk_score": "21",
"version": "3.0",
"partial_supported": false,
"subnetwork": "Visa",
"mti": "0100",
"bai": " "
}
{
"auth_type": "Auth",
"merchant": {
"merchant_id": "11111111111",
"acquirer_id": "6666666",
"terminal_network": null,
"merchant_description": "APPLE COM ONE APPLE PARK WAY CUPERTINO CAUS",
"merchant_country": "840",
"terminal_id": "004",
"merchant_state": "CA",
"merchant_postal_code": "95014"
},
"risk_code": "LR",
"ecommerce": {
"is_ecommerce": false
},
"pin_entry_capability": "Incapable",
"advanced_auth_api_fields": null,
"service_processing_type": null,
"timestamp": "20250702:171855MST",
"response_code_objects": {
"51": [
"Non-sufficient funds and not a force post"
]
},
"mcc": 4899,
"original_id": 0,
"international": false,
"id": "GqPsLYQWQqqm9t1evQqc_y",
"eligible_for_balance_return": false,
"validation_results": {
"arqc": "N",
"cvv3": "N",
"pin": "N",
"avs_result": "B",
"aav": "N",
"cvv1": "N",
"offline_pin": "N",
"cvv2": "N"
},
"auth_id": 33333333,
"account": {
"track_expiration_date": null,
"xid": 55555555,
"merchant_supplied_expiration_date": null,
"account_status": "N",
"expiration_date": "2905",
"prn": "999119065779",
"card_status": "N",
"pan": "6903",
"cad": 44444444
},
"transaction": {
"cardholder_present": "N",
"recurring": "Y"
},
"network": "Star",
"amounts": {
"cashback_amount": "0.0",
"local_currency_amount": "2.99",
"upcharge_amount": "0.0",
"trans_amount": "2.99",
"available_funds": "0.00",
"currency": "840",
"amt_til_limit": "9498.93",
"local_currency": "840",
"fee_amount": "0.00"
},
"entry_type": "Card Not Present",
"response_code": "51",
"emv": {
"is_emv": false
},
"transaction_type": "Auth",
"risk_score": "106",
"version": "3.0",
"partial_supported": false,
"subnetwork": "Star",
"mti": "0200",
"bai": ""
}