You can control all the endpoints for the Webhook notifications directly in our HUB


The list of the events that can be sent to separate endpoints*:

  • Updated Card Order - the status of a card order has been updated

    {
      "pay_form": {
        "token": "5849cf0468afc0ac4be4963c619b776eee75271d56e3c6621ab21",
        "design_name": "promo_christmas"
      },
      "transaction": {
        "amount": 2575,
        "created_at": "2019-10-29 10:01:20",
        "currency": "USD",
        "descriptor": "DESCRIPTOR",
        "id": "019df544f616335014f36d45644ecaa05db80df08ca94",
        "operation": "refund",
        "status": "success",
        "updated_at": "2019-10-29 10:01:20"
      },
      "transactions": {
        "019df544f616335014f36d45644ecaa05db80defcec25": {
          "amount": 2575,
          "card": {
            "bin": "471688",
            "brand": "VISA",
            "card_exp_month": "08",
            "card_exp_year": 2022,
            "card_holder": "diana goodman",
            "card_type": "DEBIT",
            "country": "TUR",
            "number": "471688XXXXXX3303"
          },
           "card_token": {
              "token": "3a5e10e65c9b6567c6a23738017ef5aefef0c42905c0cb3def5723ba8fe47a819"
            },
          "created_at": "2019-10-29 10:01:19",
          "currency": "USD",
          "descriptor": "FAKE_PSP",
          "id": "019df544f616335014f36d45644ecaa05db80defcec25",
          "operation": "pay",
          "status": "success",
          "updated_at": "2019-10-29 10:01:20"
        },
        "019df544f616335014f36d45644ecaa05db80df08ca94": {
          "amount": 2575,
          "created_at": "2019-10-29 10:01:20",
          "currency": "USD",
          "descriptor": "FAKE_PSP",
          "id": "019df544f616335014f36d45644ecaa05db80df08ca94",
          "operation": "refund",
          "status": "success",
          "updated_at": "2019-10-29 10:01:20"
        },
         "billing_details": {
                "address": "11437 Woodmeadow Pkwy",
                "zip": "85001",
                "country": "USA",
                "city": "New Delhi",
                "state": "TX"
          },
      },
      "order": {
        "amount": 2575,
        "currency": "USD",
        "descriptor": "FAKE_PSP",
        "fraudulent": true,
        "marketing_amount": 2575,
        "marketing_currency": "USD",
        "order_id": "1572343279551",
        "order_description": "Acquiring user account from previously saved card",
        "traffic_source": "experiment_id=10", 
        "processing_amount": 2575,
        "processing_currency": "USD",
        "refunded_amount": 2575,
        "status": "refunded"
      },
    "chargebacks":{
          "494531":{
             "id":494531,
             "dispute_date":"2021-07-13",
             "settlement_date":"2021-07-13",
             "amount":1200,
             "status":"accepted",
             "reason_code":"4853",
             "currency":"USD",
             "type":"1st_chb",
             "chargeback_flow":{
                "759854":{
                   "id":759854,
                   "amount":1200,
                   "currency":"USD",
                   "type":"1st_chb",
                   "status":"accepted",
                   "date":"2021-07-13",
                   "updated_date":"2021-07-13",
                   "deadline_date":"2021-07-23",
                   "arn_code":"21edw"
                   }
             }
         }
    },
      "verify_url": "https://acs.solidgate.com/api/v1/verify-3ds/554293692/96454d39ed80f256e9f77bb36271b2aff0c2af3ec769911dfd",
      "payment_adviser": {
        "advise": "recurring"
      }
    }


  • Received Card Dispute - a new Dispute for the card order has been received

    {
      "chargeback": {
        "id": "141368",
        "dispute_date": "2019-06-14",
        "settlement_date": "2019-06-14",
        "amount": 100,
        "currency": "USD",
        "reason_code": "16",
        "status": "in_progress",
        "reason_group": "Consumer Disputes",
        "reason_description": "Credit Purchase Amount- Damaged Goods",
        "type": "1st_chb"
      },
      "chargeback_flow": [
        {
          "id": "269323",
          "amount": 100,
          "dispute_amount": 100,
          "currency": "USD",
          "type": "1st_chb",
          "status": "in_progress",
          "date": "2019-06-14",
          "updated_date": "2019-06-14",
          "deadline_date": "2019-06-24",
          "arn_code": null
        }
      ],
      "order": {
        "order_id": "1560508789823",
        "amount": 100,
        "currency": "USD",
        "status": "approved"
      }
    }
  • Received Card Fraud Alert - a TC40/SAFE alert has been received

    {
      "order_id": "1584714374170",
      "fraud_amount": 100,
      "fraud_currency": "USD",
      "fraud_amount_usd": 100,
      "fraud_report_date": "2020-03-20 14:26:15",
      "card_scheme": "VISA",
      "fraud_type": "6",
      "reason_code_description": "Fraudulent Use of Account Number"
    }

  • Received Card Prevention Alert - an Issuer Network Alert has been received

    {
      "alert": {
        "id": 35,
        "provider_name": "ethoca",
        "provider_id": 33012,
        "alert_date": "2017-11-25 11:01:03",
        "amount": 200,
        "currency": "EUR"
      },
      "order": {
        "id": "1559728296457",
        "amount": 3,
        "currency": "USD",
        "status": "refunded",
        "created_at": "2019-06-05 09:51:38"
      }
    }

  • Updated Subscription** - a subscription or a related order status has been updated

    {
      "subscription": {
        "id": "9e252e9f-c5a3-4dca-93df-4c9fcf54267e",
        "status": "cancelled",
        "started_at": "2020-12-08 12:37:24",
        "expired_at": "2020-12-08 12:38:24",
        "cancelled_at": "2020-12-08 12:42:36",
        "trial": false,
        "cancel_code": "8.09",
        "cancel_message": "Cancellation after redemption period",
        "payment_type": "card"
      },
      "product": {
        "name": "autotest_CARD",
        "amount": 100,
        "currency": "USD",
        "trial": true,
        "payment_action": "auth_void",
        "trial_period": 1,
        "product_id": "ce43b415-5522-4373-b026-a365462f9790"
      },
      "customer": {
        "customer_account_id": "1607431041409",
        "customer_email": "[email protected]"
      },
      "invoices": {
        "9531a7ea-030e-48ae-8c79-f74e488790c6": {
          "id": "9531a7ea-030e-48ae-8c79-f74e488790c6",
          "amount": 76,
          "status": "fail",
          "created_at": "2020-12-08 12:38:51",
          "updated_at": "2020-12-08 12:42:36",
          "orders": {
            "22e45e37-d10d-4283-a47d-7bcba16e8b04": {
              "id": "22e45e37-d10d-4283-a47d-7bcba16e8b04",
              "status": "declined",
              "amount": 76,
              "created_at": "2020-12-08 12:40:36",
              "processed_at": "2020-12-08 12:42:36",
              "failed_reason": "3.02",
              "operation": "recurring",
              "retry_attempt": 2
            },
            "c179ed85-bc2b-4325-84bb-12d8eaf15203": {
              "id": "c179ed85-bc2b-4325-84bb-12d8eaf15203",
              "status": "declined",
              "amount": 90,
              "created_at": "2020-12-08 12:38:52",
              "processed_at": "2020-12-08 12:40:35",
              "failed_reason": "3.02",
              "operation": "recurring",
              "retry_attempt": 1
            },
            "38995ba1-1cd2-4dd1-8bde-8d4ac4da519f": {
              "id": "38995ba1-1cd2-4dd1-8bde-8d4ac4da519f",
              "status": "declined",
              "amount": 100,
              "created_at": "2020-12-08 12:38:51",
              "processed_at": "2020-12-08 12:38:52",
              "failed_reason": "3.02",
              "operation": "recurring"
            }
          }
        }
      },
      "callback_type": "cancel"
    }

  • Updated Alternative Order - the status of an alternative order has been updated

    {
        "order": {
            "amount": 999,
            "currency": "USD",
            "order_id": "851f4ae6-xxxx-1111-xxxx-22937f338870",
            "status": "approved",
            "method": "paypal-vault",
            "token": "2fc4f73f28d7f6ecfxxxxxxxxxxfcd2d36a4f3bfb7611111111112a0de3bb1ffd729cf1031xxxxxxxxxxd09abeb81fbde208",
            "customer_email": "[email protected]",
            "ip_address": "8.8.8.8",
            "order_description": "Order description",
            "created_at": "2019-01-01 10:44:50",
            "updated_at": "2019-01-01 10:44:52",
            "subscription_id": "65bf09e9-xxxx-1111-xxxx-4b525241de48"
        },
        "pay_form": {
            "token": "451642d0ecxxxxxc850031111122caxxxxx04fa2",
            "script_url": "https://localhost/widget/451642d1111111111500367aacxxxxxxxxxx4fa2"
        },
        "transactions": [
            {
                "id": "9051ae83-xxxx-1111-xxxx-6e1014f2814f",
                "status": "success",
                "method": "paypal-vault",
                "amount": 999,
                "currency": "USD",
                "type": "recurring",
                "created_at": "2019-01-01 10:44:50",
                "payer_details": {
                    "payer_email": "[email protected]",
                    "invoice_id": "123456789"
                }
            }
        ]
    }
  • Received Alternative Dispute - a new Dispute for the alternative order has been received



* Please, note that only static URL can be used as an endpoint

** The notification with the details on the last Invoice is being sent



To set everything up, just click on this link, select a channel and follow the instructions below:


  • Click Add new in the webhooks section
  • Paste/type in the endpoint
  • Check the notification type(s)
  • Click Create




Also, please, feel free to contact us if any additional info is needed!