Checkout / Subscription Webhooks

1
// Sent when credit card payment is complete; Funds have been taken from payer and are in your merchant settlement wallet
2
{
3
  "eventType": "Settled",
4
  "category": "Purchase",
5
  "created": "2025-04-28T20:11:07.608Z",
6
  "data": {
7
    "id": "78f9be3f-691f-4f8c-82f7-c70221b006e7",
8
    "signature": "3zP3VcWM6rKF1izpnWn5rJ7XJucoEicwncQ9hvGR7Q7FuGvDPenfBrfLUVc4fjbYghnzauTDfY4c8Jc2Nb5y1AWm",
9
    "webhookInfo": {
10
      "example": "{\"purchaseId\":\"123abc\"}"
11
    },
12
    "subtotal": {
13
      "cents": 500,
14
      "currency": "USD"
15
    },
16
    "fees": {
17
      "cents": 46,
18
      "currency": "USD"
19
    },
20
    "gasFees": {
21
      "cents": 0,
22
      "currency": "USD"
23
    },
24
    "chargebackProtectionFees": {
25
      "cents": 0,
26
      "currency": "USD"
27
    },
28
    "total": {
29
      "cents": 546,
30
      "currency": "USD"
31
    },
32
    "merchantId": "testtest",
33
    "customerId": "customer1",
34
    "rawCustomerId": "customer1",
35
    "cardToken": "tok_abc123",
36
    "last4": "1111",
37
    "bin": "411111"
38
  }
39
}

1
// Sent when a customers card has been authorized for the payment but payment has not been captured
2
{
3
  "eventType": "Card Payment Authorized",
4
  "category": "Purchase",
5
  "created": "2025-04-28T20:11:04.046Z",
6
  "data": {
7
    "webhookInfo": {
8
      "example": "{\"purchaseId\":\"123abc\"}"
9
    },
10
    "subtotal": {
11
      "currency": "USD",
12
      "cents": 500
13
    },
14
    "fees": {
15
      "cents": 46,
16
      "currency": "USD"
17
    },
18
    "gasFees": {
19
      "cents": 0,
20
      "currency": "USD"
21
    },
22
    "chargebackProtectionFees": {
23
      "cents": 0,
24
      "currency": "USD"
25
    },
26
    "total": {
27
      "cents": 546,
28
      "currency": "USD"
29
    },
30
    "merchantId": "testtest",
31
    "id": "78f9be3f-691f-4f8c-82f7-c70221b006e7",
32
    "customerId": "customer1",
33
    "rawCustomerId": "customer1",
34
    "cardToken": "tok_abc123",
35
    "last4": "1111",
36
    "bin": "411111"
37
  }
38
}

1
// Sent when a customers card has failed authorized for the payment. This typically comes from the issuing bank.
2
{
3
  "eventType": "Card Payment Declined",
4
  "category": "Purchase",
5
  "created": "2025-04-28T20:21:50.163Z",
6
  "data": {
7
    "webhookInfo": {
8
      "example": "{\"purchaseId\":\"123abc\"}"
9
    },
10
    "subtotal": {
11
      "currency": "USD",
12
      "cents": 500
13
    },
14
    "fees": {
15
      "cents": 46,
16
      "currency": "USD"
17
    },
18
    "gasFees": {
19
      "cents": 0,
20
      "currency": "USD"
21
    },
22
    "chargebackProtectionFees": {
23
      "cents": 0,
24
      "currency": "USD"
25
    },
26
    "total": {
27
      "cents": 546,
28
      "currency": "USD"
29
    },
30
    "merchantId": "testtest",
31
    "id": "bce7ca59-4bcc-43c3-95f1-51f2858b0bd2",
32
    "declineCode": "59",
33
    "declineDescription": "The transaction is suspected of fraud.",
34
    "customerId": "customer1",
35
    "rawCustomerId": "customer1",
36
    "cardToken": "tok_abc123",
37
    "last4": "1111",
38
    "bin": "411111"
39
  }
40
}

1
// Sent when a payment has been rejected by payment and is awaiting for merchant to review. This is only valid for merchants who have pending review feature enabled.
2
{
3
  "eventType": "Payment Pending Review",
4
  "category": "Purchase",
5
  "created": "2025-04-11T22:40:26.465Z",
6
  "data": {
7
    "webhookInfo": {
8
      "example": "{\"platformId\":\"1234\"}"
9
    },
10
    "subtotal": {
11
      "currency": "USD",
12
      "cents": 1000
13
    },
14
    "fees": {
15
      "cents": 61,
16
      "currency": "USD"
17
    },
18
    "gasFees": {
19
      "cents": 0,
20
      "currency": "USD"
21
    },
22
    "chargebackProtectionFees": {
23
      "cents": 0,
24
      "currency": "USD"
25
    },
26
    "total": {
27
      "cents": 1061,
28
      "currency": "USD"
29
    },
30
    "merchantId": "testtest",
31
    "id": "386b9884-8d32-471f-b059-126cb5cd5abf",
32
    "customerId": "payer123",
33
    "cardToken": "tok_abc123",
34
    "last4": "4242",
35
    "bin": "424242"
36
  }
37
}

1
// Sent when merchants received usdc directly from payers paying with usdc on solana OR when merchant receives USDC payment from a credit redemption
2
{
3
  "eventType": "USDC Payment Received",
4
  "category": "Purchase",
5
  "created": "2025-04-11T22:49:32.855Z",
6
  "data": {
7
    "webhookInfo": {
8
      "item": "sword",
9
      "email": "",
10
      "subtotal": {
11
        "cents": 200,
12
        "currency": "USD"
13
      },
14
      "fees": {
15
        "cents": 0,
16
        "currency": "USD"
17
      },
18
      "gasFees": {
19
        "cents": 0,
20
        "currency": "USD"
21
      },
22
      "chargebackProtectionFees": {
23
        "cents": 0,
24
        "currency": "USD"
25
      },
26
      "total": {
27
        "cents": 200,
28
        "currency": "USD"
29
      },
30
      "merchantId": "testtest",
31
      "id": "2VqpY3bac7Gbur27bYwZz8ATgpUg4K1nPHLHHnsvbmZjSFB5jxuaoaXxHEgmGcerZJpwo7hLFswWqYEAn259uLea",
32
      "customerId": "8zdj6f58ZfNDxDy6bArCDjVhWJ7Mwtigqh2M7VZYv9Qm"
33
    }
34
  }
35
}

{
    "eventType": "Refund",
    "category": "Purchase",
    "created": "2025-04-28T20:11:04.046Z",
    "data":
    {
        "totals":
        {
            "subtotal":
            {
                "currency": "USD",
                "cents": 500
            },
            "fees":
            {
                "cents": 46,
                "currency": "USD"
            },
            "gasFees":
            {
                "cents": 0,
                "currency": "USD"
            },
            "chargebackProtectionFees":
            {
                "cents": 0,
                "currency": "USD"
            },
            "total":
            {
                "cents": 546,
                "currency": "USD"
            }
        },
        "id": "78f9be3f-691f-4f8c-82f7-c70221b006e7",
        "paymentId": "0197a7e7-54e4-74c9-b708-1632923c1bf0",
        "wallet": "0197a7e8-b63f-7118-81ef-b5f091466ae6",
        "blockchain": "solana"
    }
}

1
{
2
  "eventType": "Card Payment Chargeback Opened",
3
  "category": "Purchase",
4
  "created": "2025-06-18T05:00:27.949Z",
5
  "data": {
6
    "id": "c10d7ac6-cca8-436b-b99f-2c7418f1cbe1",
7
    "webhookInfo": {
8
      "orderId": 123abc
9
    },
10
    "subtotal": {
11
      "cents": 2500,
12
      "currency": "USD"
13
    },
14
    "fees": {
15
      "cents": 169,
16
      "currency": "USD"
17
    },
18
    "gasFees": {
19
      "cents": 0,
20
      "currency": "USD"
21
    },
22
    "chargebackProtectionFees": {
23
      "cents": 68,
24
      "currency": "USD"
25
    },
26
    "total": {
27
      "cents": 2737,
28
      "currency": "USD"
29
    },
30
    "merchantId": "testtest",
31
    "chargebackId": "11111111111111111111111",
32
    "reasonCode": "4853",
33
    "reasonDescription": "Merchandise/Services Not as Described",
34
    "respondByDate": "2025-07-01T00:00:00.000Z",
35
    "customerId": "user123",
36
    "rawCustomerId": "user123"
37
  }
38
}

1
{
2
  "eventType": "Card Payment Chargeback Lost",
3
  "category": "Purchase",
4
  "created": "2025-05-16T11:00:04.990Z",
5
  "data": {
6
    "id": "c10d7ac6-cca8-436b-b99f-2c7418f1cbe1",
7
    "webhookInfo": {
8
      "orderId": 123abc,
9
    },
10
    "subtotal": {
11
      "cents": 3000,
12
      "currency": "USD"
13
    },
14
    "fees": {
15
      "cents": 195,
16
      "currency": "USD"
17
    },
18
    "gasFees": {
19
      "cents": 0,
20
      "currency": "USD"
21
    },
22
    "chargebackProtectionFees": {
23
      "cents": 74,
24
      "currency": "USD"
25
    },
26
    "total": {
27
      "cents": 3269,
28
      "currency": "USD"
29
    },
30
    "merchantId": "testtest",
31
    "chargebackId": "11111111111111111111111",
32
    "reasonCode": "4853",
33
    "reasonDescription": "(old) Cardholder Dispute Defective/Not as Described",
34
    "respondByDate": "2025-05-06T00:00:00.000Z"
35
  }
36
}

1
{
2
  "eventType": "Card Payment Chargeback Won",
3
  "category": "Purchase",
4
  "created": "2025-05-18T11:00:08.370Z",
5
  "data": {
6
    "id": "c10d7ac6-cca8-436b-b99f-2c7418f1cbe1",
7
    "webhookInfo": {
8
      "orderID": "123abc"
9
    },
10
    "subtotal": {
11
      "cents": 499,
12
      "currency": "USD"
13
    },
14
    "fees": {
15
      "cents": 0,
16
      "currency": "USD"
17
    },
18
    "gasFees": {
19
      "cents": 0,
20
      "currency": "USD"
21
    },
22
    "chargebackProtectionFees": {
23
      "cents": 0,
24
      "currency": "USD"
25
    },
26
    "total": {
27
      "cents": 499,
28
      "currency": "USD"
29
    },
30
    "merchantId": "testtest",
31
    "chargebackId": "11111111111111111111111",
32
    "reasonCode": "13.1",
33
    "reasonDescription": "VCR Merchandise/Services Not Received",
34
    "respondByDate": "2025-05-01T00:00:00.000Z"
35
  }
36
}

1
// Sent when ACH payment is complete; Funds have been taken from payer and are in your merchant settlement wallet
2
{
3
  "eventType": "Settled",
4
  "category": "Purchase",
5
  "created": "2025-04-17T14:16:09.112Z",
6
  "data": {
7
    "id": "gppstl08os-x211-sckkkweycuvpimd216ye7zxp",
8
    "signature": "4oUoUooodnytPPtazQghV8VH2BuvQUDWLEwrEHyzwJFomKHVNhYo0CQiB3rKLmHooooWdWrWDXuw0Uy0tReSwZXo",
9
    "webhookInfo": {
10
      "example": "{\"purchaseId\":\"123abc\"}"
11
    },
12
    "subtotal": {
13
      "cents": 100,
14
      "currency": "USD"
15
    },
16
    "fees": {
17
      "cents": 1,
18
      "currency": "USD"
19
    },
20
    "gasFees": {
21
      "cents": 0,
22
      "currency": "USD"
23
    },
24
    "chargebackProtectionFees": {
25
      "cents": 0,
26
      "currency": "USD"
27
    },
28
    "total": {
29
      "cents": 101,
30
      "currency": "USD"
31
    },
32
    "merchantId": "testtest",
33
    "customerId": "customer1",
34
    "rawCustomerId": "customer1"
35
  }
36
}

1
//Sent when customerfirst submits an ACH payment
2
{
3
  "eventType": "ACH Initiated",
4
  "category": "Purchase",
5
  "created": "2025-04-16T17:44:10.415Z",
6
  "data": {
7
    "id": "3dac0993-ecec-4843-8f07-a47c7f3389dc",
8
    "webhookInfo": {
9
      "item": "sword",
10
      "email": "tester@test.com"
11
    },
12
    "subtotal": {
13
      "cents": 300,
14
      "currency": "USD"
15
    },
16
    "fees": {
17
      "cents": 0,
18
      "currency": "USD"
19
    },
20
    "gasFees": {
21
      "cents": 0,
22
      "currency": "USD"
23
    },
24
    "chargebackProtectionFees": {
25
      "cents": 0,
26
      "currency": "USD"
27
    },
28
    "total": {
29
      "cents": 300,
30
      "currency": "USD"
31
    },
32
    "merchantId": "testtest",
33
    "customerId": "customer1"
34
  }
35
}

1
//Sent when ACH system has picked up the payment to begin processing
2
{
3
  "eventType": "ACH Batched",
4
  "category": "Purchase",
5
  "created": "2025-04-16T17:46:05.311Z",
6
  "data": {
7
    "id": "3dac0993-ecec-4843-8f07-a47c7f3389dc",
8
    "webhookInfo": {
9
      "item": "sword",
10
      "email": "tester@test.com"
11
    },
12
    "subtotal": {
13
      "cents": 300,
14
      "currency": "USD"
15
    },
16
    "fees": {
17
      "cents": 0,
18
      "currency": "USD"
19
    },
20
    "gasFees": {
21
      "cents": 0,
22
      "currency": "USD"
23
    },
24
    "chargebackProtectionFees": {
25
      "cents": 0,
26
      "currency": "USD"
27
    },
28
    "total": {
29
      "cents": 300,
30
      "currency": "USD"
31
    },
32
    "merchantId": "testtest",
33
    "customerId": "customer1"
34
  }
35
}

1
//Sent when funds are sent back to the bank acount
2
{
3
  "eventType": "ACH Returned",
4
  "category": "Purchase",
5
  "created": "2025-04-17T14:16:02.111Z",
6
  "data": {
7
    "id": "3dac0993-ecec-4843-8f07-a47c7f3389dc",
8
    "webhookInfo": {
9
      "item": "sword",
10
      "email": "tester@test.com"
11
    },
12
    "subtotal": {
13
      "cents": 300,
14
      "currency": "USD"
15
    },
16
    "fees": {
17
      "cents": 0,
18
      "currency": "USD"
19
    },
20
    "gasFees": {
21
      "cents": 0,
22
      "currency": "USD"
23
    },
24
    "chargebackProtectionFees": {
25
      "cents": 0,
26
      "currency": "USD"
27
    },
28
    "total": {
29
      "cents": 300,
30
      "currency": "USD"
31
    },
32
    "merchantId": "testtest",
33
    "customerId": "customer1"
34
  }
35
}

1
//Sent when the ACH payment was unsuccessfully processed
2
{
3
  "eventType": "ACH Failed",
4
  "category": "Purchase",
5
  "created": "2025-04-16T22:53:02.052Z",
6
  "data": {
7
    "id": "nhrpa02zhq-x301-xyyc53bxepm0rnp8rbbffykd",
8
    "webhookInfo": {
9
      "item": "sword",
10
      "email": "tester@test.com"
11
    },
12
    "subtotal": {
13
      "cents": 1000,
14
      "currency": "USD"
15
    },
16
    "fees": {
17
      "cents": 0,
18
      "currency": "USD"
19
    },
20
    "gasFees": {
21
      "cents": 0,
22
      "currency": "USD"
23
    },
24
    "chargebackProtectionFees": {
25
      "cents": 0,
26
      "currency": "USD"
27
    },
28
    "total": {
29
      "cents": 1000,
30
      "currency": "USD"
31
    },
32
    "merchantId": "testtest",
33
    "customerId": "customer1"
34
  }
35
}

1
// Sent when PIX payment is complete; Funds have been taken from payer and are in your merchant settlement wallet
2
{
3
  "eventType": "Settled",
4
  "category": "Purchase",
5
  "created": "2025-04-21T23:20:12.114Z",
6
  "data": {
7
    "id": "m22rp5miieczp7ap6p",
8
    "signature": "77f07ff4bc3db65517p2fp31",
9
    "webhookInfo": {
10
      "example": "{\"purchaseId\":\"123abc\"}"
11
    },
12
    "subtotal": {
13
      "cents": 1000,
14
      "currency": "USD"
15
    },
16
    "fees": {
17
      "cents": 117,
18
      "currency": "USD"
19
    },
20
    "gasFees": {
21
      "cents": 0,
22
      "currency": "USD"
23
    },
24
    "chargebackProtectionFees": {
25
      "cents": 0,
26
      "currency": "USD"
27
    },
28
    "total": {
29
      "cents": 1117,
30
      "currency": "USD"
31
    },
32
    "merchantId": "testtest",
33
    "customerId": "8zdj6f58ZfNDxDy6bArCDjVhWJ7Mwtigqh2M7VZYv9Qm"
34
  }
35
}

1
// Sent when the timeframe to send pix payment has ended and payer has not sent the funds
2
{
3
  "eventType": "PIX Expiration",
4
  "category": "Purchase",
5
  "created": "2025-04-21T22:20:00.154Z",
6
  "data": {
7
    "id": "f1626226-0de0-4242-8ab9-7d8d18d79787",
8
    "subtotal": {
9
      "cents": 200,
10
      "currency": "USD"
11
    },
12
    "fees": {
13
      "cents": 4,
14
      "currency": "USD"
15
    },
16
    "gasFees": {
17
      "cents": 0,
18
      "currency": "USD"
19
    },
20
    "chargebackProtectionFees": {
21
      "cents": 0,
22
      "currency": "USD"
23
    },
24
    "total": {
25
      "cents": 204,
26
      "currency": "USD"
27
    },
28
    "merchantId": "testtest",
29
    "customerId": "8zdj6f58ZfNDxDy6bArCDjVhWJ7Mwtigqh2M7VZYv9Qm"
30
  }
31
}

1
// Sent when the PIX payment was unsuccessful and funds were not sent
2
{
3
  "eventType": "PIX Failed",
4
  "category": "Purchase",
5
  "created": "2025-04-21T22:22:00.154Z",
6
  "data": {
7
    "id": "m34qr5dpopksr56nrz",
8
    "subtotal": {
9
      "cents": 200,
10
      "currency": "USD"
11
    },
12
    "fees": {
13
      "cents": 4,
14
      "currency": "USD"
15
    },
16
    "gasFees": {
17
      "cents": 0,
18
      "currency": "USD"
19
    },
20
    "chargebackProtectionFees": {
21
      "cents": 0,
22
      "currency": "USD"
23
    },
24
    "total": {
25
      "cents": 204,
26
      "currency": "USD"
27
    },
28
    "merchantId": "testtest",
29
    "customerId": "8zdj6f58ZfNDxDy6bArCDjVhWJ7Mwtigqh2M7VZYv9Qm"
30
  }
31
}

1
// Sent when payment for a subscription is complete; Funds have been taken from payer and are in your merchant settlement wallet
2
{
3
  "eventType": "Settled",
4
  "category": "Purchase",
5
  "created": "2025-04-28T20:28:10.894Z",
6
  "data": {
7
    "id": "db746ccf-6dce-4019-b34b-b35a957cb5aa",
8
    "signature": "5utLY7sWhJiXtRiw8jQ3thqyubcmsPh9rN9rWpsU4i3jw9mwwbkYchDpEEoZ3sTF8DosiwffQHbEXP5Zk5RE1fQo",
9
    "webhookInfo": {
10
      "item": "sword"
11
    },
12
    "subtotal": {
13
      "cents": 500,
14
      "currency": "USD"
15
    },
16
    "fees": {
17
      "cents": 46,
18
      "currency": "USD"
19
    },
20
    "gasFees": {
21
      "cents": 0,
22
      "currency": "USD"
23
    },
24
    "chargebackProtectionFees": {
25
      "cents": 0,
26
      "currency": "USD"
27
    },
28
    "total": {
29
      "cents": 546,
30
      "currency": "USD"
31
    },
32
    "subscription": {
33
      "_id": "680fe4d832ddccc1ee91885e",
34
      "customer": "66ce47a1e487adc8f4ab0d46",
35
      "merchant": "66311727a26b3cb28faaf97d",
36
      "plan": {
37
        "amount": {
38
          "cents": 500,
39
          "currency": "USD"
40
        },
41
        "_id": "67bf86d03716ba82ce5cd096",
42
        "merchant": "66311727a26b3cb28faaf97d",
43
        "name": "creator1234",
44
        "code": "music_access",
45
        "interval": "Monthly",
46
        "duration": 12,
47
        "description": "Monthly subscription for fans to gain access to listen to Creator 1234 songs",
48
        "active": true,
49
        "__v": 0
50
      },
51
      "cardProcessor": "mock",
52
      "reference": "f008bb21-f6a1-4947-b271-90e78638f379",
53
      "nextPaymentAt": "2025-05-28T20:28:08.164Z",
54
      "status": "Active",
55
      "webhookInfo": {
56
        "item": "sword"
57
      },
58
      "createdAt": "2025-04-28T20:28:08.169Z",
59
      "updatedAt": "2025-04-28T20:28:08.169Z",
60
      "__v": 0
61
    },
62
    "merchantId": "testtest",
63
    "customerId": "78C3dn4yUJST9pcX9GtA3yWBcKUCjDw1RWqw1MLpoUDh",
64
    "rawCustomerId": "78C3dn4yUJST9pcX9GtA3yWBcKUCjDw1RWqw1MLpoUDh"
65
  }
66
}

1
// Sent when a customers card gets re-charged for their monthly/yearly subscription plan and the card has been authorized for the payment but not yet captured
2
{
3
  "eventType": "Card Payment Authorized",
4
  "category": "Purchase",
5
  "created": "2025-04-28T20:31:19.543Z",
6
  "data": {
7
    "webhookInfo": {
8
      "item": "sword",
9
      "email": ""
10
    },
11
    "subtotal": {
12
      "cents": 500,
13
      "currency": "USD"
14
    },
15
    "fees": {
16
      "cents": 46,
17
      "currency": "USD"
18
    },
19
    "gasFees": {
20
      "cents": 0,
21
      "currency": "USD"
22
    },
23
    "chargebackProtectionFees": {
24
      "cents": 0,
25
      "currency": "USD"
26
    },
27
    "total": {
28
      "cents": 546,
29
      "currency": "USD"
30
    },
31
    "merchantId": "testtest",
32
    "id": "39ffc711-8023-46cf-b6ad-5dac81afec88",
33
    "subscription": {
34
      "_id": "67d07938a899c293e0ae2147",
35
      "customer": "67d07935a899c293e0ae2132",
36
      "merchant": "66311727a26b3cb28faaf97d",
37
      "plan": {
38
        "amount": {
39
          "cents": 500,
40
          "currency": "USD"
41
        },
42
        "_id": "67bf86d03716ba82ce5cd096",
43
        "merchant": "66311727a26b3cb28faaf97d",
44
        "name": "creator1234",
45
        "code": "music_access",
46
        "interval": "Monthly",
47
        "duration": 12,
48
        "description": "Monthly subscription for fans to gain access to listen to Creator 1234 songs",
49
        "active": true,
50
        "__v": 0
51
      },
52
      "cardProcessor": "mock",
53
      "reference": "148a2d77-c025-4c48-bccb-f8474ffcf903",
54
      "nextPaymentAt": "2025-05-11T17:56:08.261Z",
55
      "status": "Active",
56
      "webhookInfo": {
57
        "item": "sword",
58
        "email": ""
59
      },
60
      "createdAt": "2025-03-11T17:56:08.262Z",
61
      "updatedAt": "2025-04-11T20:30:00.146Z",
62
      "__v": 0
63
    },
64
    "customerId": "67Lj6ZcTRDtWT3Rx4KWAdLUrHKeLcycBzwvhzGowrHjx",
65
    "rawCustomerId": "67Lj6ZcTRDtWT3Rx4KWAdLUrHKeLcycBzwvhzGowrHjx"
66
  }
67
}

1
// Sent when a new customer pays for a subscription for the first time
2
{
3
  "eventType": "Subscription Created",
4
  "category": "Subscription",
5
  "created": "2025-04-28T20:28:08.289Z",
6
  "data": {
7
    "planCode": "music_access",
8
    "planName": "creator1234",
9
    "subscriptionId": "680fe4d832ddccc1ee91885e",
10
    "customerId": "78C3dn4yUJST9pcX9GtA3yWBcKUCjDw1RWqw1MLpoUDh",
11
    "amount": {
12
      "cents": 500,
13
      "currency": "USD"
14
    },
15
    "interval": "Monthly",
16
    "fundingMethod": "Card",
17
    "webhookInfo": {
18
      "item": "sword"
19
    }
20
  }
21
}

1
// Sent when a customer cancels their subscription plan
2
{
3
  "eventType": "Subscription Canceled",
4
  "category": "Subscription",
5
  "created": "2025-04-28T20:33:05.322Z",
6
  "data": {
7
    "planCode": "music_access",
8
    "planName": "creator1234",
9
    "subscriptionId": "67d07938a899c293e0ae2147",
10
    "customerId": "67Lj6ZcTRDtWT3Rx4KWAdLUrHKeLcycBzwvhzGowrHjx",
11
    "amount": {
12
      "cents": 500,
13
      "currency": "USD"
14
    },
15
    "interval": "Monthly",
16
    "fundingMethod": "Card",
17
    "webhookInfo": {
18
      "item": "sword",
19
      "email": ""
20
    },
21
    "reason": "Customer has canceled subscription"
22
  }
23
}

1
// Sent when SEPA or UK FP payment is complete; Funds have been taken from payer and are in your merchant settlement wallet
2
{
3
  "eventType": "Settled",
4
  "category": "Purchase",
5
  "created": "2025-05-22T00:00:00.000Z",
6
  "data": {
7
    "id": "8b6f0b0c-92d2-4224-b8ad-f2983dc64e94",
8
    "webhookInfo": {
9
      "item": "sword",
10
      "email": ""
11
    },
12
    "subtotal": {
13
      "cents": 100,
14
      "currency": "USD"
15
    },
16
    "fees": {
17
      "cents": 245,
18
      "currency": "USD"
19
    },
20
    "gasFees": {
21
      "cents": 0,
22
      "currency": "USD"
23
    },
24
    "chargebackProtectionFees": {
25
      "cents": 0,
26
      "currency": "USD"
27
    },
28
    "total": {
29
      "cents": 345,
30
      "currency": "USD"
31
    },
32
    "merchantId": "testtest",
33
    "customerId": "9rpv2W6qyShwcwTgZXpiFuC5kFGYpzhYugmpKK5Ls4Kt",
34
    "rawCustomerId": "9rpv2W6qyShwcwTgZXpiFuC5kFGYpzhYugmpKK5Ls4Kt"
35
  }
36
}

1
// Sent when the timeframe to send SEPA / UK FP payment has ended and payer has not sent the funds
2
{
3
  "eventType": "Payment Expiration",
4
  "category": "Purchase",
5
  "created": "2025-05-22T22:14:00.128Z",
6
  "data": {
7
    "id": "3423fa99-cca2-410c-b6b4-78546d57baf5",
8
    "webhookInfo": {
9
      "item": "sword",
10
      "email": ""
11
    },
12
    "subtotal": {
13
      "cents": 200,
14
      "currency": "USD"
15
    },
16
    "fees": {
17
      "cents": 226,
18
      "currency": "USD"
19
    },
20
    "gasFees": {
21
      "cents": 0,
22
      "currency": "USD"
23
    },
24
    "chargebackProtectionFees": {
25
      "cents": 0,
26
      "currency": "USD"
27
    },
28
    "total": {
29
      "cents": 426,
30
      "currency": "USD"
31
    },
32
    "merchantId": "testtest",
33
    "customerId": "9rpv2W6qyShwcwTgZXpiFuC5kFGYpzhYugmpKK5Ls4Kt",
34
    "rawCustomerId": "9rpv2W6qyShwcwTgZXpiFuC5kFGYpzhYugmpKK5Ls4Kt"
35
  }
36
}

1
// Sent when a customer sends more crypto than the required amount. The payment still settles successfully.
2
// Use the refundUrl to direct your customer to claim back the excess amount.
3
{
4
  "eventType": "Crypto Overpayment",
5
  "category": "Purchase",
6
  "created": "2025-03-15T14:23:01.000Z",
7
  "data": {
8
    "paymentId": "78f9be3f-691f-4f8c-82f7-c70221b006e7",
9
    "sessionId": "ses_abc123xyz",
10
    "refundUrl": "https://deposit.paywithglide.xyz/coinflow.cash.prod?mode=refund&glideSessionId=ses_abc123xyz&refundToken=tok_abc123",
11
    "expectedAmount": "10.00",
12
    "actualAmount": "12.50",
13
    "currencySymbol": "USDC",
14
    "actualAmountUSD": "12.50"
15
  }
16
}

1
// Sent when a customer sends less crypto than the required amount. The payment fails.
2
// Use the refundUrl to direct your customer to claim back what they sent.
3
{
4
  "eventType": "Crypto Underpayment",
5
  "category": "Purchase",
6
  "created": "2025-03-15T14:23:01.000Z",
7
  "data": {
8
    "paymentId": "bce7ca59-4bcc-43c3-95f1-51f2858b0bd2",
9
    "sessionId": "ses_def456uvw",
10
    "refundUrl": "https://deposit.paywithglide.xyz/coinflow.cash.prod?mode=refund&glideSessionId=ses_def456uvw&refundToken=tok_def456",
11
    "expectedAmount": "10.00",
12
    "actualAmount": "7.50",
13
    "currencySymbol": "USDC",
14
    "actualAmountUSD": "7.50"
15
  }
16
}

1
{
2
  eventType: string,
3
  category: string,
4
  created: string,
5
  data: {
6
    id: string,
7
    signature?: string,
8
    wallet?: string,
9
    webhookInfo?: { [key: string]: string } | null,
10
    subtotal: { cents: number, currency: string },
11
    fees: { cents: number, currency: string },
12
    gasFees: { cents: number, currency: string },
13
    chargebackProtectionFees: { cents: number, currency: string },
14
    total: { cents: number, currency: string },
15
    merchantId?: string,
16
    customerId?: string,
17
    rawCustomerId?: string,
18
    cardToken?: string,
19
    last4?: string,
20
    bin?: string
21
  }
22
}