invoice.paid

The invoice is paid. settlement tracks the release of the funds to the master wallet.

cTpeWay sends this event as an HTTP POST to every webhook endpoint subscribed to it. Verify the signature before you trust the body: see Webhooks.

Payload

Field	Type	Description
id	string	Unique event id, evt_…. Use it to deduplicate deliveries.
type	string	Always invoice.paid.
api_version	string	Always v1.
created	integer	Unix time in seconds.
livemode	boolean	false for events from the test environment.
data	object
data.object	object
data.object.id	string
data.object.number	integer
data.object.status	string	One of open, pending, underpaid, paid, expired, canceled, refunded.
data.object.outcome_flags	array of strings	Values: overpaid, late, underpaid_accepted, partially_refunded.
data.object.kind	string	One of fiat, crypto.
data.object.price optional	object
data.object.price.currency	string
data.object.price.amount	string	A decimal number written as a string, with up to 8 decimal places.
data.object.options	array of objects
data.object.options[].id	string
data.object.options[].network	string
data.object.options[].asset	string
data.object.options[].asset_id	string
data.object.options[].contract optional	string
data.object.options[].decimals	integer
data.object.options[].amount_due optional	string	Set once the option is selected (fiat invoices). A quoted amount is rounded up to display_decimals, so the amount shown to the payer is exactly the amount that pays the invoice. A whole number written as a string of digits.
data.object.options[].display_decimals optional	integer	Present with amount_due: the decimals it is stated with. amount_due is a whole number of 10^(decimals − display_decimals) base units; equal to decimals when the amount is exact to the base unit (crypto invoices).
data.object.options[].rate optional	string	Price of one unit of the asset in the invoice currency at lock time. A decimal number written as a string, with up to 8 decimal places.
data.object.options[].quote_expires_at optional	string (date-time)	Until when amount_due holds. Afterwards the payer takes a new quote; the invoice lives on.
data.object.options[].address optional	string
data.object.options[].token_account optional	string	Solana tokens: the address’s associated token account, where the token is held.
data.object.options[].selected_at optional	string (date-time)
data.object.options[].amount_paid	string	Sum of confirmed payments to this option. A whole number written as a string of digits.
data.object.options[].amount_detected	string	Sum of detected, unconfirmed payments to this option. A whole number written as a string of digits.
data.object.selected_option_id optional	string
data.object.paid_option_id optional	string
data.object.tolerance_bps	integer
data.object.order_id optional	string
data.object.customer_email optional	string	The customer the merchant named when creating the invoice.
data.object.description optional	string
data.object.metadata optional	map of string to string
data.object.expires_at	string (date-time)
data.object.pre_selection_expires_at	string (date-time)
data.object.created_at	string (date-time)
data.object.paid_at optional	string (date-time)
data.object.expired_at optional	string (date-time)
data.object.canceled_at optional	string (date-time)
data.object.refunded_at optional	string (date-time)	When the invoice became refunded.
data.object.payment optional	object
data.object.payment.id	string
data.object.payment.status	string	One of detected, confirmed, orphaned, dropped.
data.object.payment.invoice_id optional	string
data.object.payment.option_id optional	string
data.object.payment.deposit_address_id optional	string
data.object.payment.network	string
data.object.payment.asset	string
data.object.payment.asset_id	string
data.object.payment.contract optional	string
data.object.payment.decimals	integer
data.object.payment.address	string
data.object.payment.from_address optional	string
data.object.payment.tx_hash optional	string	The transaction that paid. Absent while the payment is known only from a balance change (detected_by: balance) and its transaction has not been identified; payment.transaction_attached announces it. A simulated payment (test mode, simulated: true) carries its sim_… id here.
data.object.payment.tx_index optional	integer	Position of the transfer inside the transaction. Present exactly when tx_hash is.
data.object.payment.amount	string	A whole number written as a string of digits.
data.object.payment.confirmations	integer
data.object.payment.block_height optional	integer
data.object.payment.block_hash optional	string
data.object.payment.usd_value optional	string	Value at the price snapshot taken at confirmation. A decimal number written as a string, with up to 8 decimal places.
data.object.payment.late	boolean	Confirmed after the invoice had expired or been canceled.
data.object.payment.simulated	boolean
data.object.payment.detected_by	string	How the payment was found, fixed when it is first seen: poll (its transaction was seen while watching the address), hint (its transaction was reported through the checkout and found on the network), balance (the address’s balance rose; the transaction is identified later, and tx_hash is absent until then), simulated (test mode). One of poll, hint, balance, simulated.
data.object.payment.detected_at	string (date-time)
data.object.payment.confirmed_at optional	string (date-time)
data.object.payment.settlement optional	object
data.object.payment.settlement.id	string
data.object.payment.settlement.status	string	One of pending, held, releasing, released, failed, reverted.
data.object.settlement optional	object
data.object.settlement.id	string
data.object.settlement.status	string	One of pending, held, releasing, released, failed, reverted.

A field marked optional can be missing from a payload.

Example

{
  "id": "string",
  "type": "invoice.paid",
  "api_version": "v1",
  "created": 0,
  "livemode": true,
  "data": {
    "object": {
      "id": "string",
      "number": 0,
      "status": "paid",
      "outcome_flags": [
        "overpaid"
      ],
      "kind": "fiat",
      "price": {
        "currency": "string",
        "amount": "10.00"
      },
      "options": [
        {
          "id": "string",
          "network": "string",
          "asset": "string",
          "asset_id": "string",
          "contract": "string",
          "decimals": 0,
          "amount_due": "1000000",
          "display_decimals": 0,
          "rate": "10.00",
          "quote_expires_at": "2026-01-01T00:00:00.000Z",
          "address": "string",
          "token_account": "string",
          "selected_at": "2026-01-01T00:00:00.000Z",
          "amount_paid": "1000000",
          "amount_detected": "1000000"
        }
      ],
      "selected_option_id": "string",
      "paid_option_id": "string",
      "tolerance_bps": 0,
      "order_id": "string",
      "customer_email": "string",
      "description": "string",
      "metadata": {},
      "expires_at": "2026-01-01T00:00:00.000Z",
      "pre_selection_expires_at": "2026-01-01T00:00:00.000Z",
      "created_at": "2026-01-01T00:00:00.000Z",
      "paid_at": "2026-01-01T00:00:00.000Z",
      "expired_at": "2026-01-01T00:00:00.000Z",
      "canceled_at": "2026-01-01T00:00:00.000Z",
      "refunded_at": "2026-01-01T00:00:00.000Z",
      "payment": {
        "id": "string",
        "status": "detected",
        "invoice_id": "string",
        "option_id": "string",
        "deposit_address_id": "string",
        "network": "string",
        "asset": "string",
        "asset_id": "string",
        "contract": "string",
        "decimals": 0,
        "address": "string",
        "from_address": "string",
        "tx_hash": "string",
        "tx_index": 0,
        "amount": "1000000",
        "confirmations": 0,
        "block_height": 0,
        "block_hash": "string",
        "usd_value": "10.00",
        "late": true,
        "simulated": true,
        "detected_by": "poll",
        "detected_at": "2026-01-01T00:00:00.000Z",
        "confirmed_at": "2026-01-01T00:00:00.000Z",
        "settlement": {
          "id": "string",
          "status": "pending"
        }
      },
      "settlement": {
        "id": "string",
        "status": "pending"
      }
    }
  }
}

The values are placeholders generated from the schema. They show the shape, not real data.