Auth API Webhook 2.0

This is the one and only endpoint and operation that clients need to implement for the Auth API 2.0 webhook. There is only one operation, POST. Galileo will send information about the authorization request in the body of the HTTP request, in JSON. The client''s 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 value to be used for the transaction, unless the client overrides it. The client uses the response_code field in the HTTP response body to override the authorization response code, if desired.

See the Authorization Controller API guide for more information.

Response Schema


response_codestring

Authorization response code, which specifies whether a transaction is approved or denied. See the Authorization Response Codes enumeration for possible values. Example: "05"

avs_responsestring

Use this field to override avs_result, if you believe avs_result is wrong. Possible values:

  • Y — Address and ZIP/postal code with 5 characters verified
  • X — Address and ZIP/postal code with 9 characters verified
  • A — Address only verified
  • Z — ZIP/postal code with 5 characters verified only
  • W — ZIP/postal code with 9 characters verified only
  • N — None
  • M — Gift card
  • S — Unsupported
  • U — No data (Mastercard only))
  • R — Retry (Mastercard only)

override_limitboolean

Use this field to override authorization limits, if permitted. If this field is true then any limits that would be reached are overridden. Example: true

partial_amountfloat

If response_code indicates a partial approval (10 or 87), this is the partial amount to approve. Example: 5.00

transfer_prnstring

If you want to perform a transfer to cover a lack of funds, this is the PRN of the account to supply the funds. Example: "155200002717"

transfer_amountfloat

The amount to transfer from the transfer_prn to the cardholder account. Example: 20.00

source_transfer_typestring

The transaction type for the adjustment on the source account in transfer_prn. Use the value that Galileo supplied. Case sensitive. Default: pc. Example: "lm"

dest_transfer_typestring

The transaction type for the adjustment to the cardholder account. Use the value that Galileo supplied. Case sensitive. Default: PC Example: "LM"

available_balancefloat

If the request includes a balance inquiry, this is the available balance to report to the cardholder. If this field is not present, Galileo passes the balance it has on record. The balance should always be in the cardholder's currency. (The card networks will perform currency conversion as needed.) Example: 250.00

{
    "account": {
        "account_status": "N",
        "cad": 71563,
        "card_status": "N",
        "expiration_date": "2301",
        "merchant_supplied_expiration_date": null,
        "pan": "5198",
        "prn": "495101003222",
        "track_expiration_date": null,
        "xid": 71687
    },
    "amounts": {
        "available_funds": "4400.64",
        "cashback_amount": "0.0",
        "currency": "840",
        "exchange_rate": "61000000",
        "fee_amount": "0.00",
        "local_currency": "840",
        "local_currency_amount": "25.12",
        "trans_amount": "25.12"
    },
    "auth_id": 6631254,
    "auth_type": "Advice",
    "bai": null,
    "ecommerce": {
        "is_ecommerce": false
    },
    "eligible_for_balance_return": false,
    "emv": {
        "is_emv": false
    },
    "entry_type": "Magnetic Stripe",
    "id": "3bzANGgrTfCoj9LbGz3RkR",
    "international": false,
    "mcc": 5542,
    "merchant": {
        "acquirer_id": "006440",
        "merchant_country": "840",
        "merchant_description": "EXXON PRATTVILLE COOSA PRATTVILLE    AL ",
        "merchant_id": "125807000000000",
        "merchant_postal_code": "36067",
        "merchant_state": "NV",
        "terminal_id": "00010102",
        "terminal_network": "None"
    },
    "mti": "0120",
    "network": "Mastercard",
    "original_id": 6620572,
    "partial_supported": false,
    "pin_entry_capability": "Capable",
    "response_code": "00",
    "response_code_list": [],
    "risk_score": "None",
    "subnetwork": "Mastercard Banknet",
    "timestamp": "20201210:084305MST",
    "transaction": {
        "cardholder_present": "Y",
        "recurring": "N"
    },
    "transaction_type": "Auth",
    "validation_results": {
        "aav": "N",
        "arqc": "N",
        "avs_result": "B",
        "cvv1": "N",
        "cvv2": "N",
        "cvv3": "N",
        "offline_pin": "N",
        "pin": "N"
    },
    "version": "2.0"
}
{
    "account": {
        "account_status": "N",
        "cad": 41111,
        "card_status": "N",
        "expiration_date": "2401",
        "merchant_supplied_expiration_date": "2401",
        "pan": "0777",
        "prn": "494101401122",
        "track_expiration_date": null,
        "xid": 41310
    },
    "amounts": {
        "available_funds": "7.97",
        "cashback_amount": "0.0",
        "currency": "840",
        "exchange_rate": "61000000",
        "fee_amount": "0.00",
        "local_currency": "840",
        "local_currency_amount": "15.93",
        "trans_amount": "15.93"
    },
    "auth_id": 6620500,
    "auth_type": "Auth",
    "bai": null,
    "ecommerce": {
        "is_ecommerce": false
    },
    "eligible_for_balance_return": false,
    "emv": {
        "is_emv": false
    },
    "entry_type": "Card Not Present",
    "id": "Kz5rWJZFTB__i10ejOk7Fh",
    "international": false,
    "mcc": 5734,
    "merchant": {
        "acquirer_id": "010100",
        "merchant_country": "840",
        "merchant_description": "ADOBE ACROPRO SUBS     4085366000    CA ",
        "merchant_id": "000372808060886",
        "merchant_postal_code": "951100000",
        "merchant_state": "NV",
        "terminal_id": "01296759",
        "terminal_network": "None"
    },
    "mti": "0100",
    "network": "Mastercard",
    "original_id": 0,
    "partial_supported": false,
    "pin_entry_capability": "Other",
    "response_code": "51",
    "response_code_list": ["51"],
    "risk_score": "123",
    "subnetwork": "Mastercard Banknet",
    "timestamp": "20201210:084232MST",
    "transaction": {
        "cardholder_present": "N",
        "recurring": "N"
    },
    "transaction_type": "Auth",
    "validation_results": {
        "aav": "N",
        "arqc": "N",
        "avs_result": "B",
        "cvv1": "N",
        "cvv2": "N",
        "cvv3": "N",
        "offline_pin": "N",
        "pin": "N"
    },
    "version": "2.0"
}
Language
Authentication
Bearer
JWT