BitGPT 402pay Documentation

{
  "webhook_id": "<string>",
  "url": "<string>",
  "event": "invoice.updated",
  "resource_id": "<string>",
  "payload": {
    "id": "<string>",
    "organization_id": "<string>",
    "price": "<string>",
    "created_at": "<string>",
    "updated_at": "<string>",
    "customer_email": "jsmith@example.com",
    "substatus": "OVERPAID",
    "price_usd": "<string>",
    "metadata": {},
    "redirect_url": "<string>",
    "items": [
      {
        "id": "<string>",
        "organization_id": "<string>",
        "invoice_id": "<string>",
        "product_id": "<string>",
        "billing_schema_id": "<string>",
        "payment_intent_id": "<string>",
        "quantity": 123,
        "exclude_reason": "<string>",
        "created_at": "<string>",
        "updated_at": "<string>",
        "billing_schema": {
          "id": "<string>",
          "version_group_id": "<string>",
          "is_active": 123,
          "name": "<string>",
          "description": "<string>",
          "organization_id": "<string>",
          "product_id": "<string>",
          "base_price": "<string>",
          "interval_count": 123,
          "created_at": "<string>",
          "updated_at": "<string>",
          "configurations": [
            {
              "id": "<string>",
              "version_group_id": "<string>",
              "is_active": 123,
              "schema_id": "<string>",
              "starts_at": "<string>",
              "ends_at": "<string>",
              "price_per_unit": "<string>",
              "metric_id": "<string>",
              "created_at": "<string>",
              "updated_at": "<string>"
            }
          ]
        }
      }
    ],
    "calculations": [
      {
        "id": "<string>",
        "organization_id": "<string>",
        "invoice_id": "<string>",
        "invoice_item_id": "<string>",
        "title": "<string>",
        "idx": 123,
        "initial_price": "<string>",
        "price_delta": "<string>",
        "price": "<string>",
        "details": {},
        "created_at": "<string>",
        "updated_at": "<string>"
      }
    ],
    "calculation_summary": {
      "invoice_id": "<string>",
      "currency_original": "GBP",
      "total_price": "<string>",
      "total_price_usd": "<string>",
      "total_price_original": "<string>",
      "cache": {
        "used": true,
        "expires_at": 123,
        "expires_in": 123
      },
      "total_price_converted": "<string>"
    },
    "organization": {
      "name": "<string>",
      "image_url": "<string>",
      "stripe_config": {
        "stripe_user_id": "<string>"
      }
    },
    "payments": [
      {
        "id": "<string>",
        "idempotency_key": "<string>",
        "organization_id": "<string>",
        "provider_id": "<string>",
        "invoice_id": "<string>",
        "currency": "<string>",
        "price": "<string>",
        "status": "<string>",
        "created_at": "<string>",
        "updated_at": "<string>",
        "happened_at": "<string>"
      }
    ]
  },
  "timestamp": "<string>"
}

WEBHOOK

invoice.updated

{
  "webhook_id": "<string>",
  "url": "<string>",
  "event": "invoice.updated",
  "resource_id": "<string>",
  "payload": {
    "id": "<string>",
    "organization_id": "<string>",
    "price": "<string>",
    "created_at": "<string>",
    "updated_at": "<string>",
    "customer_email": "jsmith@example.com",
    "substatus": "OVERPAID",
    "price_usd": "<string>",
    "metadata": {},
    "redirect_url": "<string>",
    "items": [
      {
        "id": "<string>",
        "organization_id": "<string>",
        "invoice_id": "<string>",
        "product_id": "<string>",
        "billing_schema_id": "<string>",
        "payment_intent_id": "<string>",
        "quantity": 123,
        "exclude_reason": "<string>",
        "created_at": "<string>",
        "updated_at": "<string>",
        "billing_schema": {
          "id": "<string>",
          "version_group_id": "<string>",
          "is_active": 123,
          "name": "<string>",
          "description": "<string>",
          "organization_id": "<string>",
          "product_id": "<string>",
          "base_price": "<string>",
          "interval_count": 123,
          "created_at": "<string>",
          "updated_at": "<string>",
          "configurations": [
            {
              "id": "<string>",
              "version_group_id": "<string>",
              "is_active": 123,
              "schema_id": "<string>",
              "starts_at": "<string>",
              "ends_at": "<string>",
              "price_per_unit": "<string>",
              "metric_id": "<string>",
              "created_at": "<string>",
              "updated_at": "<string>"
            }
          ]
        }
      }
    ],
    "calculations": [
      {
        "id": "<string>",
        "organization_id": "<string>",
        "invoice_id": "<string>",
        "invoice_item_id": "<string>",
        "title": "<string>",
        "idx": 123,
        "initial_price": "<string>",
        "price_delta": "<string>",
        "price": "<string>",
        "details": {},
        "created_at": "<string>",
        "updated_at": "<string>"
      }
    ],
    "calculation_summary": {
      "invoice_id": "<string>",
      "currency_original": "GBP",
      "total_price": "<string>",
      "total_price_usd": "<string>",
      "total_price_original": "<string>",
      "cache": {
        "used": true,
        "expires_at": 123,
        "expires_in": 123
      },
      "total_price_converted": "<string>"
    },
    "organization": {
      "name": "<string>",
      "image_url": "<string>",
      "stripe_config": {
        "stripe_user_id": "<string>"
      }
    },
    "payments": [
      {
        "id": "<string>",
        "idempotency_key": "<string>",
        "organization_id": "<string>",
        "provider_id": "<string>",
        "invoice_id": "<string>",
        "currency": "<string>",
        "price": "<string>",
        "status": "<string>",
        "created_at": "<string>",
        "updated_at": "<string>",
        "happened_at": "<string>"
      }
    ]
  },
  "timestamp": "<string>"
}

Headers

X-Webhook-Signature

string

required

Signature of the webhook event payload, used for verification.

X-Webhook-Timestamp

string

required

Timestamp of the webhook event, used to prevent replay attacks.

Example:

"2025-08-20 20:56:36.456"

X-Webhook-Event

string

required

The type of event being sent.

Example:

"payment.created"

Body

application/json

webhook_id

string

required

Unique identifier for the webhook

Example:

"webhook_0197be04-14b7-716e-9cba-f3582532f7dc"

url

string<uri>

required

URL where webhook events will be sent

Example:

"https://webhook-handler.com/webhooks"

event

enum<string>

required

Type of webhook event that occurred

Available options:

invoice.updated

Example:

"invoice.updated"

resource_id

string

required

Updated Invoice identifier

Example:

"invoice_019851f5-39f7-714a-8f2c-3c3eede808b4"

payload

object

required

Details of the Invoice that was updated

Show child attributes

Examples:

{
  "id": "invoice_019851f5-39f7-714a-8f2c-3c3eede808b4",
  "organization_id": "org_0196b0e9-11d8-7f26-b1d2-bd47054e4827",
  "status": "PENDING",
  "substatus": null,
  "currency": "EUR",
  "price": "56.550000000000000000000000000000",
  "price_usd": "66.750000000000000000000000000000",
  "created_at": "2025-07-28 18:54:42",
  "updated_at": "2025-07-28 18:55:34",
  "redirect_url": null,
  "customer_email": "test@test.tt",
  "metadata": {
    "one": "1",
    "two": "2",
    "three": "3",
    "four": "4"
  },
  "items": [
    {
      "id": "invoice_item_019851f5-39f8-753b-9cf5-985300807b51",
      "organization_id": "org_0196b0e9-11d8-7f26-b1d2-bd47054e4827",
      "invoice_id": "invoice_019851f5-39f7-714a-8f2c-3c3eede808b4",
      "type": "PRODUCT",
      "currency": "GBP",
      "product_id": "product_01982266-ee05-7249-a0bf-787b4b6e0946",
      "billing_schema_id": "schema_01982266-ee06-70fe-9cac-bc4b6d964815",
      "payment_intent_id": null,
      "quantity": 4,
      "status": "INCLUDED",
      "exclude_reason": null,
      "created_at": "2025-07-28 18:54:42",
      "updated_at": null,
      "product": {
        "id": "product_01982266-ee05-7249-a0bf-787b4b6e0946",
        "version_group_id": "product_01981e60-62f5-7f75-8576-aa262be8ea54",
        "is_active": 1,
        "name": "Product #1",
        "organization_id": "org_0196b0e9-11d8-7f26-b1d2-bd47054e4827",
        "description": "111",
        "image_id": null,
        "created_at": "2025-07-19 13:17:07",
        "updated_at": null,
        "image": null
      },
      "billing_schema": {
        "id": "schema_01982266-ee06-70fe-9cac-bc4b6d964815",
        "is_active": 1,
        "version_group_id": "schema_01982266-ee06-70fe-9cac-bc4b6d964815",
        "name": "Basic Product",
        "description": "Billing Schema #1",
        "organization_id": "org_0196b0e9-11d8-7f26-b1d2-bd47054e4827",
        "product_id": "product_01982266-ee05-7249-a0bf-787b4b6e0946",
        "type": "ONE_TIME",
        "currency": "GBP",
        "base_price": "10.000000000000000000000000000000",
        "interval_type": null,
        "interval_count": null,
        "payment_type": null,
        "renew_type": null,
        "billing_type": null,
        "created_at": "2025-07-19 13:17:07",
        "updated_at": null
      }
    },
    {
      "id": "invoice_item_019851f5-39f9-7eeb-aa8c-2ddfca8c65a3",
      "organization_id": "org_0196b0e9-11d8-7f26-b1d2-bd47054e4827",
      "invoice_id": "invoice_019851f5-39f7-714a-8f2c-3c3eede808b4",
      "type": "PRODUCT",
      "currency": "EUR",
      "product_id": "product_0198222f-fe06-743f-8651-42128a1e218a",
      "billing_schema_id": "schema_0198222f-fe07-76a8-87d0-880d5289f759",
      "payment_intent_id": null,
      "quantity": 1,
      "status": "INCLUDED",
      "exclude_reason": null,
      "created_at": "2025-07-28 18:54:42",
      "updated_at": null,
      "product": {
        "id": "product_0198222f-fe06-743f-8651-42128a1e218a",
        "version_group_id": "product_0198222f-fe06-743f-8651-42128a1e218a",
        "is_active": 1,
        "name": "Product #2",
        "organization_id": "org_0196b0e9-11d8-7f26-b1d2-bd47054e4827",
        "description": "ONE_TIME PRODUCT",
        "image_id": null,
        "created_at": "2025-07-19 12:17:07",
        "updated_at": null,
        "image": null
      },
      "billing_schema": {
        "id": "schema_0198222f-fe07-76a8-87d0-880d5289f759",
        "is_active": 1,
        "version_group_id": "schema_0198222f-fe07-76a8-87d0-880d5289f759",
        "name": "Product #2",
        "description": "Billing Schema #1",
        "organization_id": "org_0196b0e9-11d8-7f26-b1d2-bd47054e4827",
        "product_id": "product_0198222f-fe06-743f-8651-42128a1e218a",
        "type": "ONE_TIME",
        "currency": "EUR",
        "base_price": "10.000000000000000000000000000000",
        "interval_type": null,
        "interval_count": null,
        "payment_type": null,
        "renew_type": null,
        "billing_type": null,
        "created_at": "2025-07-19 12:17:07",
        "updated_at": null
      }
    }
  ],
  "calculations": [
    {
      "id": "invoice_calc_019851f6-03c9-7768-9a6f-3e7a86b7eeed",
      "organization_id": "org_0196b0e9-11d8-7f26-b1d2-bd47054e4827",
      "invoice_id": "invoice_019851f5-39f7-714a-8f2c-3c3eede808b4",
      "invoice_item_id": "invoice_item_019851f5-39f8-753b-9cf5-985300807b51",
      "title": "Product #1",
      "calculation_type": "PRODUCT",
      "idx": 0,
      "currency": "GBP",
      "initial_price": "40.000000000000000000000000000000",
      "price_delta": "0.000000000000000000000000000000",
      "price": "40.000000000000000000000000000000",
      "details": {
        "price": "10.000000000000000000000000000000",
        "currency": "GBP",
        "quantity": 4,
        "product_id": "product_01982266-ee05-7249-a0bf-787b4b6e0946"
      },
      "created_at": "2025-07-28 18:55:34",
      "updated_at": null
    },
    {
      "id": "invoice_calc_019851f6-03cc-7fe9-8c19-a4cb550bb75c",
      "organization_id": "org_0196b0e9-11d8-7f26-b1d2-bd47054e4827",
      "invoice_id": "invoice_019851f5-39f7-714a-8f2c-3c3eede808b4",
      "invoice_item_id": "invoice_item_019851f5-39f8-753b-9cf5-985300807b51",
      "title": "Currency change GBP => EUR",
      "calculation_type": "CURRENCY_CHANGE",
      "idx": 1,
      "currency": "EUR",
      "initial_price": "40.000000000000000000000000000000",
      "price_delta": "0.000000000000000000000000000000",
      "price": "46.557223908892338549036308436250",
      "details": {
        "to": "EUR",
        "from": "GBP",
        "to_rate_usd": "0.847260000000000000",
        "from_rate_usd": "0.727930000000000000"
      },
      "created_at": "2025-07-28 18:55:34",
      "updated_at": null
    },
    {
      "id": "invoice_calc_019851f6-03ce-7afb-a2e6-897bb4a22728",
      "organization_id": "org_0196b0e9-11d8-7f26-b1d2-bd47054e4827",
      "invoice_id": "invoice_019851f5-39f7-714a-8f2c-3c3eede808b4",
      "invoice_item_id": "invoice_item_019851f5-39f9-7eeb-aa8c-2ddfca8c65a3",
      "title": "Product #2",
      "calculation_type": "PRODUCT",
      "idx": 0,
      "currency": "EUR",
      "initial_price": "10.000000000000000000000000000000",
      "price_delta": "0.000000000000000000000000000000",
      "price": "10.000000000000000000000000000000",
      "details": {
        "price": "10.000000000000000000000000000000",
        "currency": "EUR",
        "quantity": 1,
        "product_id": "product_0198222f-fe06-743f-8651-42128a1e218a"
      },
      "created_at": "2025-07-28 18:55:34",
      "updated_at": null
    },
    {
      "id": "invoice_calc_019851f6-03d0-755e-ac57-96ca8b9dd424",
      "organization_id": "org_0196b0e9-11d8-7f26-b1d2-bd47054e4827",
      "invoice_id": "invoice_019851f5-39f7-714a-8f2c-3c3eede808b4",
      "invoice_item_id": null,
      "title": "Total",
      "calculation_type": "TOTAL",
      "idx": 0,
      "currency": "EUR",
      "initial_price": "56.557223908892338549036308436250",
      "price_delta": "0.000000000000000000000000000000",
      "price": "56.557223908892338549036308436250",
      "details": [],
      "created_at": "2025-07-28 18:55:34",
      "updated_at": null
    },
    {
      "id": "invoice_calc_019851f6-03d2-7cd5-872e-d0fdc5f19f97",
      "organization_id": "org_0196b0e9-11d8-7f26-b1d2-bd47054e4827",
      "invoice_id": "invoice_019851f5-39f7-714a-8f2c-3c3eede808b4",
      "invoice_item_id": null,
      "title": "Total, USD",
      "calculation_type": "TOTAL_USD",
      "idx": 0,
      "currency": "USD",
      "initial_price": "66.753091033321930161976616901836",
      "price_delta": "0.000000000000000000000000000000",
      "price": "66.753091033321930161976616901836",
      "details": [],
      "created_at": "2025-07-28 18:55:34",
      "updated_at": null
    }
  ],
  "organization": {
    "name": "4",
    "image_url": "https://assets.bitgpt.xyz/uploads/2025/03/26/156091ee0884f36de9836d.jpeg"
  },
  "payments": [
    {
      "id": "payment_01979449-dc2f-71e4-b565-42d78c0d83aa",
      "idempotency_key": "1b70f35483e563e009967abe74308e6977f9b36f1bfc05168fa22104b64293d6-invoice_01979284-7610-79f8-86c4-978168730054",
      "organization_id": "org_f44b7809595e5ebe3bb4d6",
      "provider_id": "prov_bitcoin_bitcoin",
      "invoice_id": "invoice_019851f5-39f7-714a-8f2c-3c3eede808b4",
      "currency": "BITCOIN",
      "price": "0.000126300000000000000000000000",
      "status": "COMPLETED",
      "created_at": "2025-06-21 22:59:17",
      "updated_at": "2025-08-20 23:57:58",
      "happened_at": "2025-06-21 22:59:17"
    }
  ]
}

{
  "id": "invoice_0197d634-7d8e-7615-8007-e37b992cdb30",
  "organization_id": "org_0196b0e9-11d8-7f26-b1d2-bd47054e4827",
  "customer_email": "user@example.com",
  "status": "PENDING",
  "substatus": null,
  "currency": "EUR",
  "price": "504.818257074815000000000000000000",
  "price_usd": "550.123456789012345678901234567890",
  "metadata": { "value1": 1, "value2": "test" },
  "redirect_url": null,
  "created_at": "2025-07-04 18:10:53",
  "updated_at": "2025-07-04 18:10:53"
}

{
  "id": "invoice_0197d634-7d8e-7615-8007-e37b992cdb30",
  "organization_id": "org_0196b0e9-11d8-7f26-b1d2-bd47054e4827",
  "customer_email": "user@example.com",
  "status": "PENDING",
  "substatus": null,
  "currency": "EUR",
  "price": "504.818257074815000000000000000000",
  "price_usd": "550.123456789012345678901234567890",
  "metadata": null,
  "redirect_url": "",
  "created_at": "2025-07-04 18:10:53",
  "updated_at": "2025-07-04 18:10:53",
  "items": [
    {
      "id": "invoice_item_0197d634-7d91-712c-a766-510e8d889c69",
      "organization_id": "org_0196b0e9-11d8-7f26-b1d2-bd47054e4827",
      "invoice_id": "invoice_0197d634-7d8e-7615-8007-e37b992cdb30",
      "type": "PAYMENT_INTENT",
      "currency": "AUD",
      "product_id": null,
      "billing_schema_id": null,
      "payment_intent_id": "pi_0197d634-7d90-7124-acc6-fc69c1a3598b",
      "quantity": 1,
      "status": "INCLUDED",
      "exclude_reason": null,
      "created_at": "2025-07-04 18:10:53",
      "updated_at": null
    },
    {
      "id": "invoice_item_0197d634-7d93-7f7a-9131-5f18e7770773",
      "organization_id": "org_0196b0e9-11d8-7f26-b1d2-bd47054e4827",
      "invoice_id": "invoice_0197d634-7d8e-7615-8007-e37b992cdb30",
      "type": "PAYMENT_INTENT",
      "currency": "BITCOIN",
      "product_id": null,
      "billing_schema_id": null,
      "payment_intent_id": "pi_0197d634-7d92-7d0c-b2e8-9021ad9f599d",
      "quantity": 1,
      "status": "INCLUDED",
      "exclude_reason": null,
      "created_at": "2025-07-04 18:10:53",
      "updated_at": null
    },
    {
      "id": "invoice_item_0197d634-7d94-7bcf-a7ef-0979f02b1caf",
      "organization_id": "org_0196b0e9-11d8-7f26-b1d2-bd47054e4827",
      "invoice_id": "invoice_0197d634-7d8e-7615-8007-e37b992cdb30",
      "type": "PAYMENT_INTENT",
      "currency": "GBP",
      "product_id": null,
      "billing_schema_id": null,
      "payment_intent_id": "pi_0197d634-7d93-7433-b205-b7ec90311980",
      "quantity": 1,
      "status": "INCLUDED",
      "exclude_reason": null,
      "created_at": "2025-07-04 18:10:53",
      "updated_at": null
    },
    {
      "id": "invoice_item_0197d634-7d95-720e-8117-7854f2ea3414",
      "organization_id": "org_0196b0e9-11d8-7f26-b1d2-bd47054e4827",
      "invoice_id": "invoice_0197d634-7d8e-7615-8007-e37b992cdb30",
      "type": "PRODUCT",
      "currency": "GBP",
      "product_id": "product_0197a8d9-8426-7e71-9edf-26301686ed26",
      "billing_schema_id": "schema_0197a8d9-8427-7dc4-9b9f-4e29594b5d12",
      "payment_intent_id": null,
      "quantity": 2,
      "status": "INCLUDED",
      "exclude_reason": null,
      "created_at": "2025-07-04 18:10:53",
      "updated_at": null,
      "product": {
        "id": "product_0197a8d9-8426-7e71-9edf-26301686ed26",
        "version_group_id": "product_01971675-cbb6-7c81-8281-98c2c8607f09",
        "is_active": 1,
        "name": "444",
        "organization_id": "org_0196b0e9-11d8-7f26-b1d2-bd47054e4827",
        "description": "111",
        "image_id": "file_0196b6e6-54e3-796d-9c6a-2862a5fef597",
        "created_at": "2025-06-25 22:48:36",
        "updated_at": "2025-07-09 17:39:38",
        "image": {
          "id": "file_0196b6e6-54e3-796d-9c6a-2862a5fef597",
          "url": "https://assets.bitgpt.xyz//app/public/src/storage/uploads/image/2025/05/09/0196b6e6-54e3-7290-9d73-0074c623e368.jpg"
        }
      }
    }
  ],
  "calculations": [
    {
      "id": "invoice_calc_0197d634-7db1-7350-8e0d-4bafd500fecd",
      "organization_id": "org_0196b0e9-11d8-7f26-b1d2-bd47054e4827",
      "invoice_id": "invoice_0197d634-7d8e-7615-8007-e37b992cdb30",
      "invoice_item_id": "invoice_item_0197d634-7d91-712c-a766-510e8d889c69",
      "title": "Currency change AUD => EUR",
      "calculation_type": "CURRENCY_CHANGE",
      "idx": 1,
      "currency": "EUR",
      "initial_price": "501.000000000000000000000000000000",
      "price_delta": "0.000000000000000000000000000000",
      "price": "286.233549368620000000000000000000",
      "details": {
        "to": "EUR",
        "from": "AUD",
        "to_rate_usd": "0.879502000000000005",
        "from_rate_usd": "1.539409000000000027"
      },
      "created_at": "2025-07-04 18:10:53",
      "updated_at": null
    },
    {
      "id": "invoice_calc_0197d634-7db1-7923-9a3c-6d26d3c541b1",
      "organization_id": "org_0196b0e9-11d8-7f26-b1d2-bd47054e4827",
      "invoice_id": "invoice_0197d634-7d8e-7615-8007-e37b992cdb30",
      "invoice_item_id": "invoice_item_0197d634-7d91-712c-a766-510e8d889c69",
      "title": "Payment Intent: pi_0197d634-7d90-7124-acc6-fc69c1a3598b",
      "calculation_type": "PAYMENT_INTENT",
      "idx": 0,
      "currency": "AUD",
      "initial_price": "501.000000000000000000000000000000",
      "price_delta": "0.000000000000000000000000000000",
      "price": "501.000000000000000000000000000000",
      "details": {
        "price": null,
        "currency": "AUD",
        "quantity": 1,
        "payment_intent_id": "pi_0197d634-7d90-7124-acc6-fc69c1a3598b"
      },
      "created_at": "2025-07-04 18:10:53",
      "updated_at": null
    },
    {
      "id": "invoice_calc_0197d634-7db2-7ea3-be57-3a8da42b5736",
      "organization_id": "org_0196b0e9-11d8-7f26-b1d2-bd47054e4827",
      "invoice_id": "invoice_0197d634-7d8e-7615-8007-e37b992cdb30",
      "invoice_item_id": "invoice_item_0197d634-7d93-7f7a-9131-5f18e7770773",
      "title": "Payment Intent: pi_0197d634-7d92-7d0c-b2e8-9021ad9f599d",
      "calculation_type": "PAYMENT_INTENT",
      "idx": 0,
      "currency": "BITCOIN",
      "initial_price": "0.001000000000000000000000000000",
      "price_delta": "0.000000000000000000000000000000",
      "price": "0.001000000000000000000000000000",
      "details": {
        "price": null,
        "currency": "BITCOIN",
        "quantity": 1,
        "payment_intent_id": "pi_0197d634-7d92-7d0c-b2e8-9021ad9f599d"
      },
      "created_at": "2025-07-04 18:10:53",
      "updated_at": null
    },
    {
      "id": "invoice_calc_0197d634-7db3-713c-ab66-c765668c2866",
      "organization_id": "org_0196b0e9-11d8-7f26-b1d2-bd47054e4827",
      "invoice_id": "invoice_0197d634-7d8e-7615-8007-e37b992cdb30",
      "invoice_item_id": "invoice_item_0197d634-7d94-7bcf-a7ef-0979f02b1caf",
      "title": "Payment Intent: pi_0197d634-7d93-7433-b205-b7ec90311980",
      "calculation_type": "PAYMENT_INTENT",
      "idx": 0,
      "currency": "GBP",
      "initial_price": "10.000000000000000000000000000000",
      "price_delta": "0.000000000000000000000000000000",
      "price": "10.000000000000000000000000000000",
      "details": {
        "price": null,
        "currency": "GBP",
        "quantity": 1,
        "payment_intent_id": "pi_0197d634-7d93-7433-b205-b7ec90311980"
      },
      "created_at": "2025-07-04 18:10:53",
      "updated_at": null
    },
    {
      "id": "invoice_calc_0197d634-7db3-763f-bc53-0f85b942f469",
      "organization_id": "org_0196b0e9-11d8-7f26-b1d2-bd47054e4827",
      "invoice_id": "invoice_0197d634-7d8e-7615-8007-e37b992cdb30",
      "invoice_item_id": "invoice_item_0197d634-7d93-7f7a-9131-5f18e7770773",
      "title": "Currency change BITCOIN => EUR",
      "calculation_type": "CURRENCY_CHANGE",
      "idx": 1,
      "currency": "EUR",
      "initial_price": "0.001000000000000000000000000000",
      "price_delta": "0.000000000000000000000000000000",
      "price": "92.397019055174000000000000000000",
      "details": {
        "to": "EUR",
        "from": "BITCOIN",
        "to_rate_usd": "0.879502000000000005",
        "from_rate_usd": "0.000009518727000000"
      },
      "created_at": "2025-07-04 18:10:53",
      "updated_at": null
    },
    {
      "id": "invoice_calc_0197d634-7db4-7ad5-a3ca-5cc27915ade6",
      "organization_id": "org_0196b0e9-11d8-7f26-b1d2-bd47054e4827",
      "invoice_id": "invoice_0197d634-7d8e-7615-8007-e37b992cdb30",
      "invoice_item_id": "invoice_item_0197d634-7d94-7bcf-a7ef-0979f02b1caf",
      "title": "Currency change GBP => EUR",
      "calculation_type": "CURRENCY_CHANGE",
      "idx": 1,
      "currency": "EUR",
      "initial_price": "10.000000000000000000000000000000",
      "price_delta": "0.000000000000000000000000000000",
      "price": "11.904498929341000000000000000000",
      "details": {
        "to": "EUR",
        "from": "GBP",
        "to_rate_usd": "0.879502000000000005",
        "from_rate_usd": "0.738797999999999954"
      },
      "created_at": "2025-07-04 18:10:53",
      "updated_at": null
    },
    {
      "id": "invoice_calc_0197d634-7db5-7133-8a1a-6ce942788d57",
      "organization_id": "org_0196b0e9-11d8-7f26-b1d2-bd47054e4827",
      "invoice_id": "invoice_0197d634-7d8e-7615-8007-e37b992cdb30",
      "invoice_item_id": "invoice_item_0197d634-7d95-720e-8117-7854f2ea3414",
      "title": "Currency change GBP => EUR",
      "calculation_type": "CURRENCY_CHANGE",
      "idx": 1,
      "currency": "EUR",
      "initial_price": "48.000000000000000000000000000000",
      "price_delta": "0.000000000000000000000000000000",
      "price": "57.141594860840000000000000000000",
      "details": {
        "to": "EUR",
        "from": "GBP",
        "to_rate_usd": "0.879502000000000005",
        "from_rate_usd": "0.738797999999999954"
      },
      "created_at": "2025-07-04 18:10:53",
      "updated_at": null
    },
    {
      "id": "invoice_calc_0197d634-7db5-7ab5-9818-8fb301c02b71",
      "organization_id": "org_0196b0e9-11d8-7f26-b1d2-bd47054e4827",
      "invoice_id": "invoice_0197d634-7d8e-7615-8007-e37b992cdb30",
      "invoice_item_id": "invoice_item_0197d634-7d95-720e-8117-7854f2ea3414",
      "title": "444",
      "calculation_type": "PRODUCT",
      "idx": 0,
      "currency": "GBP",
      "initial_price": "48.000000000000000000000000000000",
      "price_delta": "0.000000000000000000000000000000",
      "price": "48.000000000000000000000000000000",
      "details": {
        "price": "24.000000000000000000000000000000",
        "currency": "GBP",
        "quantity": 2,
        "product_id": "product_0197a8d9-8426-7e71-9edf-26301686ed26"
      },
      "created_at": "2025-07-04 18:10:53",
      "updated_at": null
    },
    {
      "id": "invoice_calc_0197d634-7db6-753a-9bd9-00241f790bbb",
      "organization_id": "org_0196b0e9-11d8-7f26-b1d2-bd47054e4827",
      "invoice_id": "invoice_0197d634-7d8e-7615-8007-e37b992cdb30",
      "invoice_item_id": "invoice_item_0197d634-7d95-720e-8117-7854f2ea3414",
      "title": "444",
      "calculation_type": "PRODUCT",
      "idx": 0,
      "currency": "GBP",
      "initial_price": "48.000000000000000000000000000000",
      "price_delta": "0.000000000000000000000000000000",
      "price": "48.000000000000000000000000000000",
      "details": {
        "price": "24.000000000000000000000000000000",
        "currency": "GBP",
        "quantity": 2,
        "product_id": "product_0197a8d9-8426-7e71-9edf-26301686ed26"
      },
      "created_at": "2025-07-04 18:10:53",
      "updated_at": null
    },
    {
      "id": "invoice_calc_0197d634-7db7-7761-9a34-d56e71948e73",
      "organization_id": "org_0196b0e9-11d8-7f26-b1d2-bd47054e4827",
      "invoice_id": "invoice_0197d634-7d8e-7615-8007-e37b992cdb30",
      "invoice_item_id": "invoice_item_0197d634-7d95-720e-8117-7854f2ea3414",
      "title": "Currency change GBP => EUR",
      "calculation_type": "CURRENCY_CHANGE",
      "idx": 1,
      "currency": "EUR",
      "initial_price": "48.000000000000000000000000000000",
      "price_delta": "0.000000000000000000000000000000",
      "price": "57.141594860840000000000000000000",
      "details": {
        "to": "EUR",
        "from": "GBP",
        "to_rate_usd": "0.879502000000000005",
        "from_rate_usd": "0.738797999999999954"
      },
      "created_at": "2025-07-04 18:10:53",
      "updated_at": null
    },
    {
      "id": "invoice_calc_0197d634-7db8-75af-93bf-0af3202b8705",
      "organization_id": "org_0196b0e9-11d8-7f26-b1d2-bd47054e4827",
      "invoice_id": "invoice_0197d634-7d8e-7615-8007-e37b992cdb30",
      "invoice_item_id": null,
      "title": "Total",
      "calculation_type": "TOTAL",
      "idx": 0,
      "currency": "EUR",
      "initial_price": "504.818257074815000000000000000000",
      "price_delta": "0.000000000000000000000000000000",
      "price": "504.818257074815000000000000000000",
      "details": [],
      "created_at": "2025-07-04 18:10:53",
      "updated_at": null
    },
    {
      "id": "invoice_calc_0197d634-7db9-7d8b-b91d-732600f7217b",
      "organization_id": "org_0196b0e9-11d8-7f26-b1d2-bd47054e4827",
      "invoice_id": "invoice_0197d634-7d8e-7615-8007-e37b992cdb30",
      "invoice_item_id": null,
      "title": "Total, USD",
      "calculation_type": "TOTAL_USD",
      "idx": 0,
      "currency": "USD",
      "initial_price": "573.981931905572000000000000000000",
      "price_delta": "0.000000000000000000000000000000",
      "price": "573.981931905572000000000000000000",
      "details": [],
      "created_at": "2025-07-04 18:10:53",
      "updated_at": null
    },
    {
      "id": "invoice_calc_0197d634-7db9-7d8b-b91d-732600f7217b",
      "organization_id": "org_0196b0e9-11d8-7f26-b1d2-bd47054e4827",
      "invoice_id": "invoice_0197d634-7d8e-7615-8007-e37b992cdb30",
      "invoice_item_id": null,
      "title": "Total, GBP",
      "calculation_type": "TOTAL_ORIGINAL",
      "idx": 0,
      "currency": "GBP",
      "initial_price": "424.103470801800000000000000000000",
      "price_delta": "0.000000000000000000000000000000",
      "price": "424.103470801800000000000000000000",
      "details": [],
      "created_at": "2025-07-04 18:10:53",
      "updated_at": null
    }
  ],
  "calculation_summary": {
    "invoice_id": "invoice_0197d634-7d8e-7615-8007-e37b992cdb30",
    "currency": "EUR",
    "total_price": "504.818257074815000000000000000000",
    "total_price_usd": "573.981931905572000000000000000000",
    "cache": {
      "used": false,
      "expires_at": 1751912947,
      "expires_in": 0
    },
    "convert_currency": "GBP",
    "total_price_converted": "424.056703327972"
  },
  "organization": {
    "name": "Organization Name",
    "image_url": null,
    "stripe_config": { "stripe_user_id": "acct_2SD34569a7asSd0a" }
  }
}

timestamp

string

required

Timestamp when the event occurred

Example:

"2025-08-20 20:56:36.456"

⌘I

GET STARTED

WEBHOOKS

API REFERENCE

invoice.updated

Headers

Body