Auth API Webhook 3.0

This is the one and only endpoint and operation that clients need to implement for the Auth API 3.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.

Open the Recipes below to see webhook examples that you can use for testing.

Recipes
Auth API v3: AVS check with in-app purchase
Open Recipe
Auth API v3: Approved transaction
Open Recipe
Auth API v3: Failed PIN at ATM
Open Recipe
Auth API v3: Merchant credit
Open Recipe
Auth API v3: Partial approval
Open Recipe
Auth API v3: Failed PIN count exceeded
Open Recipe
Auth API v3: Lost card
Open Recipe
Auth API v3: Bad CVV2 with insufficient funds
Open Recipe
Auth API v3: Card frozen and load not permitted
Open Recipe
Auth API v3: Velocity limit exceeded at ATM
Open Recipe
Auth API v3: Expiry date mismatch
Open Recipe
Auth API v3: Mobile wallet provisioning request, red path
Open Recipe
Auth API v3: Successful card load
Open Recipe
Auth API v3: Denied international incremental authorization
Open Recipe
Auth API v3: Fraud rules engine denies auth
Open Recipe
Auth API v3: Denied cash advance
Open Recipe
Auth API v3: Visa merchant credit over Mastercard rails
Open Recipe
Auth API v3: Mobile wallet provisioning request, green path
Open Recipe
Auth API v3: Completion (advice) at gas pump
Open Recipe
Auth API v3: 3-D Secure transaction
Open Recipe
Auth API v3: Reversal
Open Recipe
Auth API v3: Balance inquiry
Open Recipe
Auth API v3: Merchant mobile wallet check
Open Recipe

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_objects": {},
    "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": "3.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_objects": {
        "51": [
            "Non-sufficient funds and not a force post"
        ]
    },
    "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": "3.0"
}
Language
Authentication
Bearer
JWT