> For the complete documentation index, see [llms.txt](https://docs.txn.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.txn.io/invoices/invoice-webhooks.md).

# Invoice webhooks

Txn sends an invoice webhook each time an invoice's `status` changes. The payload has the shape of the [Read invoice](https://docs.txn.io/invoices/reading-invoice.md) response: the same `data` object and a JSON:API `included` array with the related entities. The **Response Body** table on that page describes every field. One thing differs from the API response: the `author` relationship of `invoiceTransactions` is not expanded, so `included[]` never carries an `apiKeys` entity.

Which entities `included[]` carries depends on how far the invoice has progressed:

| Entity                                | Present                                                                                                                                   |
| ------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- |
| `accounts`                            | Always. The target account the invoice is credited to.                                                                                    |
| `addresses`                           | Always. The receiving address.                                                                                                            |
| `invoiceTransactions`, `transactions` | Always. The settlement record and the account transaction on the target account.                                                          |
| `binanceOrders`                       | When `paymentMethods` includes `binance_pay`.                                                                                             |
| `coinDeposits`                        | Once a payment has been detected: `processing`, `on_hold`, `completed`, and `cancelled` after a rejected payment. One entry per transfer. |
| `exchangeQuotes`                      | On `completed`, when `chargedCurrency` differs from `targetCurrency`.                                                                     |
| `paymentLinks`                        | When a refund link was created. See [Invoice refunds](https://docs.txn.io/invoices/invoice-refunds.md).                                   |

The tabs below show an example payload for each status. All but On Hold were captured from Sandbox. On Hold is an older Sandbox payload brought up to the current format; in a current On Hold payload the `coinDeposits` entity also carries `sourceAddresses`, `riskScore`, `clusterCategory` and `clusterName`. For the rules that govern transitions and the meaning of `status`, `statusContext`, and `paymentStatus`, see [Invoice status flow](https://docs.txn.io/invoices/invoice-status-flow.md).

For configuring webhook URLs, retry behaviour, source IPs, and signature verification, see the general [Webhooks](https://docs.txn.io/api-basics/webhooks.md) section.

{% tabs %}
{% tab title="Status Pending" %}

```json
{
  "data": {
    "attributes": {
      "amountBilled": "12.000000",
      "amountCharged": "12.000000",
      "billedCurrency": "USDT",
      "chargedCurrency": "USDT",
      "chargedTargetRate": "0.88289",
      "chargedTargetRateCurrency": "EUR",
      "createdAt": "2026-11-04T12:29:44.180Z",
      "exchangeRate": "1.0",
      "expiresAt": "2026-11-04T12:49:44.144Z",
      "hostedPageUrl": "https://sandbox.txn.io/redirect?item_id=2516c5da-197f-472b-9be2-b0b080989ba1&request_type=item_hosted_page",
      "network": "ttrx:usdt",
      "networkName": "Tron (TRC20)",
      "paymentMethods": [
        "on_chain"
      ],
      "paymentStatus": "expecting",
      "reference": "docs-webhook-invoice-1793795383",
      "scAddress": null,
      "status": "pending",
      "statusContext": "unpaid",
      "successRedirectUrl": null,
      "targetAmount": "9.49",
      "targetCurrency": "EUR",
      "unsuccessRedirectUrl": null
    },
    "id": "2516c5da-197f-472b-9be2-b0b080989ba1",
    "relationships": {
      "address": {
        "data": {
          "id": "8166bfb1-2f43-469c-8b14-9328edbd304b",
          "type": "addresses"
        }
      },
      "binanceOrder": {
        "data": null
      },
      "coinDeposits": {
        "data": []
      },
      "invoiceTransactions": {
        "data": [
          {
            "id": "420648c5-9a24-4316-9be5-b3b423e919a4",
            "type": "invoiceTransactions"
          }
        ]
      },
      "refundLinks": {
        "data": []
      },
      "targetAccount": {
        "data": {
          "id": "13a85b45-8543-41c7-b963-394d4ea128ae",
          "type": "accounts"
        }
      }
    },
    "type": "invoices"
  },
  "included": [
    {
      "attributes": {
        "balance": "39261.83",
        "bankDepositAvailable": true,
        "bankReference": "BDR6421088115176062",
        "bankWithdrawalAvailable": true,
        "currencyCode": "EUR",
        "currencyType": "fiat",
        "label": "master",
        "master": true,
        "totalBalance": null,
        "transferAvailable": true
      },
      "id": "13a85b45-8543-41c7-b963-394d4ea128ae",
      "relationships": {
        "company": {
          "meta": {
            "included": false
          }
        },
        "networks": {
          "meta": {
            "included": false
          }
        },
        "txnBankCredentials": {
          "meta": {
            "included": false
          }
        }
      },
      "type": "accounts"
    },
    {
      "attributes": {
        "createdAt": "2026-11-04T12:16:57.529Z",
        "label": "Tron (TRC20)",
        "value": "TTesiim14FHGyRWAx9tD4RQM2e4LxMgLV2"
      },
      "id": "8166bfb1-2f43-469c-8b14-9328edbd304b",
      "relationships": {
        "account": {
          "meta": {
            "included": false
          }
        },
        "network": {
          "meta": {
            "included": false
          }
        }
      },
      "type": "addresses"
    },
    {
      "attributes": {
        "amountBilled": "12.000000",
        "billedChargedRate": "1.0",
        "billedChargedRateCurrency": "USDT",
        "consolidationFee": "0.000000",
        "simplifiedState": "pending",
        "targetTransactionFee": "1.10",
        "targetTransactionFeeCurrency": "EUR",
        "transactionFee": "1.246986",
        "transactionFeeCurrency": "USDT"
      },
      "id": "420648c5-9a24-4316-9be5-b3b423e919a4",
      "relationships": {
        "account": {
          "meta": {
            "included": false
          }
        },
        "author": {
          "meta": {
            "included": false
          }
        },
        "exchangeQuote": {
          "data": null
        },
        "invoice": {
          "meta": {
            "included": false
          }
        },
        "txn": {
          "data": {
            "id": "420648c5-9a24-4316-9be5-b3b423e919a4",
            "type": "transactions"
          }
        }
      },
      "type": "invoiceTransactions"
    },
    {
      "attributes": {
        "accountId": "13a85b45-8543-41c7-b963-394d4ea128ae",
        "amount": "9.49",
        "balance": null,
        "createdAt": "2026-11-04T12:29:44.221Z",
        "currency": "EUR",
        "reference": "docs-webhook-invoice-1793795383",
        "simplifiedState": "pending",
        "transactionType": "InvoiceTransaction"
      },
      "id": "420648c5-9a24-4316-9be5-b3b423e919a4",
      "relationships": {
        "account": {
          "meta": {
            "included": false
          }
        },
        "author": {
          "meta": {
            "included": false
          }
        },
        "transactionDetails": {
          "meta": {
            "included": false
          }
        }
      },
      "type": "transactions"
    }
  ],
  "meta": {}
}
```

{% endtab %}

{% tab title="Status Processing" %}

```json
{
  "data": {
    "attributes": {
      "amountBilled": "12.000000",
      "amountCharged": "12.000000",
      "billedCurrency": "USDT",
      "chargedCurrency": "USDT",
      "chargedTargetRate": "0.88289",
      "chargedTargetRateCurrency": "EUR",
      "createdAt": "2026-11-04T12:29:44.180Z",
      "exchangeRate": "1.0",
      "expiresAt": "2026-11-04T12:49:44.144Z",
      "hostedPageUrl": "https://sandbox.txn.io/redirect?item_id=2516c5da-197f-472b-9be2-b0b080989ba1&request_type=item_hosted_page",
      "network": "ttrx:usdt",
      "networkName": "Tron (TRC20)",
      "paymentMethods": [
        "on_chain"
      ],
      "paymentStatus": "on_time",
      "reference": "docs-webhook-invoice-1793795383",
      "scAddress": null,
      "status": "processing",
      "statusContext": "unpaid",
      "successRedirectUrl": null,
      "targetAmount": "9.49",
      "targetCurrency": "EUR",
      "unsuccessRedirectUrl": null
    },
    "id": "2516c5da-197f-472b-9be2-b0b080989ba1",
    "relationships": {
      "address": {
        "data": {
          "id": "8166bfb1-2f43-469c-8b14-9328edbd304b",
          "type": "addresses"
        }
      },
      "binanceOrder": {
        "data": null
      },
      "coinDeposits": {
        "data": [
          {
            "id": "ab1c16f8-b8cc-49ef-8eec-71c54744549b",
            "type": "coinDeposits"
          }
        ]
      },
      "invoiceTransactions": {
        "data": [
          {
            "id": "420648c5-9a24-4316-9be5-b3b423e919a4",
            "type": "invoiceTransactions"
          }
        ]
      },
      "refundLinks": {
        "data": []
      },
      "targetAccount": {
        "data": {
          "id": "13a85b45-8543-41c7-b963-394d4ea128ae",
          "type": "accounts"
        }
      }
    },
    "type": "invoices"
  },
  "included": [
    {
      "attributes": {
        "balance": "39269.57",
        "bankDepositAvailable": true,
        "bankReference": "BDR6421088115176062",
        "bankWithdrawalAvailable": true,
        "currencyCode": "EUR",
        "currencyType": "fiat",
        "label": "master",
        "master": true,
        "totalBalance": null,
        "transferAvailable": true
      },
      "id": "13a85b45-8543-41c7-b963-394d4ea128ae",
      "relationships": {
        "company": {
          "meta": {
            "included": false
          }
        },
        "networks": {
          "meta": {
            "included": false
          }
        },
        "txnBankCredentials": {
          "meta": {
            "included": false
          }
        }
      },
      "type": "accounts"
    },
    {
      "attributes": {
        "createdAt": "2026-11-04T12:16:57.529Z",
        "label": "Tron (TRC20)",
        "value": "TTesiim14FHGyRWAx9tD4RQM2e4LxMgLV2"
      },
      "id": "8166bfb1-2f43-469c-8b14-9328edbd304b",
      "relationships": {
        "account": {
          "meta": {
            "included": false
          }
        },
        "network": {
          "meta": {
            "included": false
          }
        }
      },
      "type": "addresses"
    },
    {
      "attributes": {
        "amountBilled": "12.000000",
        "billedChargedRate": "1.0",
        "billedChargedRateCurrency": "USDT",
        "consolidationFee": "0.000000",
        "simplifiedState": "pending",
        "targetTransactionFee": "1.10",
        "targetTransactionFeeCurrency": "EUR",
        "transactionFee": "1.246986",
        "transactionFeeCurrency": "USDT"
      },
      "id": "420648c5-9a24-4316-9be5-b3b423e919a4",
      "relationships": {
        "account": {
          "meta": {
            "included": false
          }
        },
        "author": {
          "meta": {
            "included": false
          }
        },
        "exchangeQuote": {
          "data": null
        },
        "invoice": {
          "meta": {
            "included": false
          }
        },
        "txn": {
          "data": {
            "id": "420648c5-9a24-4316-9be5-b3b423e919a4",
            "type": "transactions"
          }
        }
      },
      "type": "invoiceTransactions"
    },
    {
      "attributes": {
        "accountId": "e289de2b-37bd-4eff-b832-f754c31a2d95",
        "amount": "12.000000",
        "clusterCategory": null,
        "clusterName": null,
        "createdAt": "2026-11-04T12:30:26.594Z",
        "currencyCode": "USDT",
        "reference": "docs-webhook-invoice-1793795383",
        "riskScore": null,
        "simplifiedState": "pending",
        "sourceAddresses": [
          "TPE3bwwmwMBHyddFpruHeFWMVUibxs3rq8"
        ],
        "state": "unconfirmed",
        "txHash": "d42e4543e9b56aa46aa8fb686d9553ec24152291f7cacada8063bdda113aef35"
      },
      "id": "ab1c16f8-b8cc-49ef-8eec-71c54744549b",
      "relationships": {
        "address": {
          "meta": {
            "included": false
          }
        },
        "author": {
          "meta": {
            "included": false
          }
        },
        "network": {
          "meta": {
            "included": false
          }
        }
      },
      "type": "coinDeposits"
    },
    {
      "attributes": {
        "accountId": "13a85b45-8543-41c7-b963-394d4ea128ae",
        "amount": "9.49",
        "balance": null,
        "createdAt": "2026-11-04T12:29:44.221Z",
        "currency": "EUR",
        "reference": "docs-webhook-invoice-1793795383",
        "simplifiedState": "pending",
        "transactionType": "InvoiceTransaction"
      },
      "id": "420648c5-9a24-4316-9be5-b3b423e919a4",
      "relationships": {
        "account": {
          "meta": {
            "included": false
          }
        },
        "author": {
          "meta": {
            "included": false
          }
        },
        "transactionDetails": {
          "meta": {
            "included": false
          }
        }
      },
      "type": "transactions"
    }
  ],
  "meta": {}
}
```

{% endtab %}

{% tab title="Status Completed" %}

```json
{
  "data": {
    "attributes": {
      "amountBilled": "12.000000",
      "amountCharged": "12.000000",
      "billedCurrency": "USDT",
      "chargedCurrency": "USDT",
      "chargedTargetRate": "0.88289",
      "chargedTargetRateCurrency": "EUR",
      "createdAt": "2026-11-04T12:29:44.180Z",
      "exchangeRate": "1.0",
      "expiresAt": "2026-11-04T12:49:44.144Z",
      "hostedPageUrl": "https://sandbox.txn.io/redirect?item_id=2516c5da-197f-472b-9be2-b0b080989ba1&request_type=item_hosted_page",
      "network": "ttrx:usdt",
      "networkName": "Tron (TRC20)",
      "paymentMethods": [
        "on_chain"
      ],
      "paymentStatus": "on_time",
      "reference": "docs-webhook-invoice-1793795383",
      "scAddress": null,
      "status": "completed",
      "statusContext": "full",
      "successRedirectUrl": null,
      "targetAmount": "9.49",
      "targetCurrency": "EUR",
      "unsuccessRedirectUrl": null
    },
    "id": "2516c5da-197f-472b-9be2-b0b080989ba1",
    "relationships": {
      "address": {
        "data": {
          "id": "8166bfb1-2f43-469c-8b14-9328edbd304b",
          "type": "addresses"
        }
      },
      "binanceOrder": {
        "data": null
      },
      "coinDeposits": {
        "data": [
          {
            "id": "ab1c16f8-b8cc-49ef-8eec-71c54744549b",
            "type": "coinDeposits"
          }
        ]
      },
      "invoiceTransactions": {
        "data": [
          {
            "id": "420648c5-9a24-4316-9be5-b3b423e919a4",
            "type": "invoiceTransactions"
          }
        ]
      },
      "refundLinks": {
        "data": []
      },
      "targetAccount": {
        "data": {
          "id": "13a85b45-8543-41c7-b963-394d4ea128ae",
          "type": "accounts"
        }
      }
    },
    "type": "invoices"
  },
  "included": [
    {
      "attributes": {
        "balance": "39279.06",
        "bankDepositAvailable": true,
        "bankReference": "BDR6421088115176062",
        "bankWithdrawalAvailable": true,
        "currencyCode": "EUR",
        "currencyType": "fiat",
        "label": "master",
        "master": true,
        "totalBalance": null,
        "transferAvailable": true
      },
      "id": "13a85b45-8543-41c7-b963-394d4ea128ae",
      "relationships": {
        "company": {
          "meta": {
            "included": false
          }
        },
        "networks": {
          "meta": {
            "included": false
          }
        },
        "txnBankCredentials": {
          "meta": {
            "included": false
          }
        }
      },
      "type": "accounts"
    },
    {
      "attributes": {
        "createdAt": "2026-11-04T12:16:57.529Z",
        "label": "Tron (TRC20)",
        "value": "TTesiim14FHGyRWAx9tD4RQM2e4LxMgLV2"
      },
      "id": "8166bfb1-2f43-469c-8b14-9328edbd304b",
      "relationships": {
        "account": {
          "meta": {
            "included": false
          }
        },
        "network": {
          "meta": {
            "included": false
          }
        }
      },
      "type": "addresses"
    },
    {
      "attributes": {
        "amountBilled": "12.000000",
        "billedChargedRate": "1.0",
        "billedChargedRateCurrency": "USDT",
        "consolidationFee": "0.000000",
        "simplifiedState": "completed",
        "targetTransactionFee": "1.10",
        "targetTransactionFeeCurrency": "EUR",
        "transactionFee": "1.246986",
        "transactionFeeCurrency": "USDT"
      },
      "id": "420648c5-9a24-4316-9be5-b3b423e919a4",
      "relationships": {
        "account": {
          "meta": {
            "included": false
          }
        },
        "author": {
          "meta": {
            "included": false
          }
        },
        "exchangeQuote": {
          "data": {
            "id": "d134ae0d-af79-4df6-826c-51337ec39730",
            "type": "exchangeQuotes"
          }
        },
        "invoice": {
          "meta": {
            "included": false
          }
        },
        "txn": {
          "data": {
            "id": "420648c5-9a24-4316-9be5-b3b423e919a4",
            "type": "transactions"
          }
        }
      },
      "type": "invoiceTransactions"
    },
    {
      "attributes": {
        "accountId": "e289de2b-37bd-4eff-b832-f754c31a2d95",
        "amount": "12.000000",
        "clusterCategory": "Exchange",
        "clusterName": "Test ENV",
        "createdAt": "2026-11-04T12:30:26.594Z",
        "currencyCode": "USDT",
        "reference": "docs-webhook-invoice-1793795383",
        "riskScore": null,
        "simplifiedState": "processed",
        "sourceAddresses": [
          "TPE3bwwmwMBHyddFpruHeFWMVUibxs3rq8"
        ],
        "state": "processed",
        "txHash": "d42e4543e9b56aa46aa8fb686d9553ec24152291f7cacada8063bdda113aef35"
      },
      "id": "ab1c16f8-b8cc-49ef-8eec-71c54744549b",
      "relationships": {
        "address": {
          "meta": {
            "included": false
          }
        },
        "author": {
          "meta": {
            "included": false
          }
        },
        "network": {
          "meta": {
            "included": false
          }
        }
      },
      "type": "coinDeposits"
    },
    {
      "attributes": {
        "accountId": "13a85b45-8543-41c7-b963-394d4ea128ae",
        "amount": "9.49",
        "balance": null,
        "createdAt": "2026-11-04T12:29:44.221Z",
        "currency": "EUR",
        "reference": "docs-webhook-invoice-1793795383",
        "simplifiedState": "completed",
        "transactionType": "InvoiceTransaction"
      },
      "id": "420648c5-9a24-4316-9be5-b3b423e919a4",
      "relationships": {
        "account": {
          "meta": {
            "included": false
          }
        },
        "author": {
          "meta": {
            "included": false
          }
        },
        "transactionDetails": {
          "meta": {
            "included": false
          }
        }
      },
      "type": "transactions"
    },
    {
      "attributes": {
        "accountChargedId": "e289de2b-37bd-4eff-b832-f754c31a2d95",
        "accountReceivedId": "13a85b45-8543-41c7-b963-394d4ea128ae",
        "amountCharged": "12.0",
        "amountChargedCurrency": "USDT",
        "amountReceived": "10.59",
        "amountReceivedCurrency": "EUR",
        "exchangeFee": "0.00",
        "exchangeFeeCurrency": "EUR",
        "expiresAt": "2026-11-04T12:31:30.818Z",
        "rate": "0.88289",
        "rateCurrency": "EUR",
        "status": "processed"
      },
      "id": "d134ae0d-af79-4df6-826c-51337ec39730",
      "relationships": {
        "accountCharged": {
          "meta": {
            "included": false
          }
        },
        "accountReceived": {
          "meta": {
            "included": false
          }
        },
        "author": {
          "meta": {
            "included": false
          }
        },
        "exchangeOrder": {
          "meta": {
            "included": false
          }
        },
        "transactions": {
          "meta": {
            "included": false
          }
        }
      },
      "type": "exchangeQuotes"
    }
  ],
  "meta": {}
}
```

{% endtab %}

{% tab title="Status On Hold" %}

```json
{
  "data": {
    "attributes": {
      "amountBilled": "10000.00",
      "amountCharged": "283.417792",
      "billedCurrency": "TRY",
      "chargedCurrency": "USDT",
      "chargedTargetRate": "0.948618",
      "chargedTargetRateCurrency": "EUR",
      "createdAt": "2025-01-28T16:26:56.275Z",
      "exchangeRate": "35.2836",
      "expiresAt": "2025-01-28T16:46:56.063Z",
      "hostedPageUrl": "https://sandbox.txn.io/redirect?item_id=fe8ea84a-8490-4133-87e9-3209e6d1f7db&request_type=item_hosted_page",
      "network": "ttrx:usdt",
      "networkName": "Tron (TRC20)",
      "paymentMethods": [
        "on_chain"
      ],
      "paymentStatus": "on_time",
      "reference": "bc32c092-8979-4435-b176-ae1b790b1ca6",
      "scAddress": null,
      "status": "on_hold",
      "statusContext": "unpaid",
      "successRedirectUrl": "https://yahoo.com",
      "targetAmount": "266.17",
      "targetCurrency": "EUR",
      "unsuccessRedirectUrl": "https://myspace.com"
    },
    "id": "fe8ea84a-8490-4133-87e9-3209e6d1f7db",
    "relationships": {
      "address": {
        "data": {
          "id": "e4c1c999-52a5-470b-a8c4-e88d875eb3cf",
          "type": "addresses"
        }
      },
      "binanceOrder": {
        "data": null
      },
      "coinDeposits": {
        "data": [
          {
            "id": "32520a71-f71a-4878-97c1-41844cd96d9d",
            "type": "coinDeposits"
          }
        ]
      },
      "invoiceTransactions": {
        "data": [
          {
            "id": "89d6e25d-70ff-4d89-b784-0aac1df896a0",
            "type": "invoiceTransactions"
          }
        ]
      },
      "refundLinks": {
        "data": []
      },
      "targetAccount": {
        "data": {
          "id": "13a85b45-8543-41c7-b963-394d4ea128ae",
          "type": "accounts"
        }
      }
    },
    "type": "invoices"
  },
  "included": [
    {
      "attributes": {
        "balance": "1500.00",
        "bankDepositAvailable": true,
        "bankReference": "BDR2891634526738095",
        "bankWithdrawalAvailable": true,
        "currencyCode": "EUR",
        "currencyType": "fiat",
        "label": "EUR account",
        "master": false,
        "totalBalance": "1500.00",
        "transferAvailable": true
      },
      "id": "13a85b45-8543-41c7-b963-394d4ea128ae",
      "relationships": {
        "company": {
          "meta": {
            "included": false
          }
        },
        "networks": {
          "meta": {
            "included": false
          }
        },
        "txnBankCredentials": {
          "meta": {
            "included": false
          }
        }
      },
      "type": "accounts"
    },
    {
      "attributes": {
        "createdAt": "2025-01-28T15:19:00.020Z",
        "label": "Tron (TRC20)",
        "value": "TSEC2CvHZ1MgiA8VhgWoRHpXSxPY6wndyW"
      },
      "id": "e4c1c999-52a5-470b-a8c4-e88d875eb3cf",
      "relationships": {
        "account": {
          "meta": {
            "included": false
          }
        },
        "network": {
          "meta": {
            "included": false
          }
        }
      },
      "type": "addresses"
    },
    {
      "attributes": {
        "amountBilled": "10000.00",
        "billedChargedRate": "35.2836",
        "billedChargedRateCurrency": "TRY",
        "consolidationFee": "0.00",
        "simplifiedState": "on_hold",
        "targetTransactionFee": "2.69",
        "targetTransactionFeeCurrency": "EUR",
        "transactionFee": "100.00",
        "transactionFeeCurrency": "TRY"
      },
      "id": "89d6e25d-70ff-4d89-b784-0aac1df896a0",
      "relationships": {
        "account": {
          "meta": {
            "included": false
          }
        },
        "author": {
          "meta": {
            "included": false
          }
        },
        "exchangeQuote": {
          "data": null
        },
        "invoice": {
          "meta": {
            "included": false
          }
        },
        "txn": {
          "data": {
            "id": "89d6e25d-70ff-4d89-b784-0aac1df896a0",
            "type": "transactions"
          }
        }
      },
      "type": "invoiceTransactions"
    },
    {
      "attributes": {
        "accountId": "e289de2b-37bd-4eff-b832-f754c31a2d95",
        "amount": "283.417792",
        "createdAt": "2025-01-28T16:28:26.669Z",
        "currencyCode": "USDT",
        "reference": "bc32c092-8979-4435-b176-ae1b790b1ca6",
        "simplifiedState": "on_hold",
        "state": "on_hold_confirmed",
        "txHash": "1c378c68c5b78573e069642036747754ed7edbad0cd35d0fa734739243906f18"
      },
      "id": "32520a71-f71a-4878-97c1-41844cd96d9d",
      "relationships": {
        "address": {
          "meta": {
            "included": false
          }
        },
        "author": {
          "meta": {
            "included": false
          }
        },
        "network": {
          "meta": {
            "included": false
          }
        }
      },
      "type": "coinDeposits"
    },
    {
      "attributes": {
        "accountId": "13a85b45-8543-41c7-b963-394d4ea128ae",
        "amount": "266.17",
        "balance": null,
        "createdAt": "2025-01-28T16:29:00.447Z",
        "currency": "EUR",
        "reference": "bc32c092-8979-4435-b176-ae1b790b1ca6",
        "simplifiedState": "on_hold",
        "transactionType": "InvoiceTransaction"
      },
      "id": "89d6e25d-70ff-4d89-b784-0aac1df896a0",
      "relationships": {
        "account": {
          "meta": {
            "included": false
          }
        },
        "author": {
          "meta": {
            "included": false
          }
        },
        "transactionDetails": {
          "meta": {
            "included": false
          }
        }
      },
      "type": "transactions"
    }
  ],
  "meta": {}
}
```

{% endtab %}

{% tab title="Status Expired" %}

```json
{
  "data": {
    "attributes": {
      "amountBilled": "12.000000",
      "amountCharged": "12.000000",
      "billedCurrency": "USDT",
      "chargedCurrency": "USDT",
      "chargedTargetRate": "0.88903",
      "chargedTargetRateCurrency": "EUR",
      "createdAt": "2026-11-04T11:07:18.828Z",
      "exchangeRate": "1.0",
      "expiresAt": "2026-11-04T11:27:18.783Z",
      "hostedPageUrl": "https://sandbox.txn.io/redirect?item_id=98e8776d-1229-4bbf-8989-2b0a18541897&request_type=item_hosted_page",
      "network": "ttrx:usdt",
      "networkName": "Tron (TRC20)",
      "paymentMethods": [
        "on_chain"
      ],
      "paymentStatus": "expecting",
      "reference": "docs-webhook-invoice-1793790438",
      "scAddress": null,
      "status": "expired",
      "statusContext": "unpaid",
      "successRedirectUrl": null,
      "targetAmount": "9.56",
      "targetCurrency": "EUR",
      "unsuccessRedirectUrl": null
    },
    "id": "98e8776d-1229-4bbf-8989-2b0a18541897",
    "relationships": {
      "address": {
        "data": {
          "id": "c59d9bfc-b24d-4748-9013-12d5f6006404",
          "type": "addresses"
        }
      },
      "binanceOrder": {
        "data": null
      },
      "coinDeposits": {
        "data": []
      },
      "invoiceTransactions": {
        "data": [
          {
            "id": "a0f00966-cca6-4377-9e02-726fd9968cd5",
            "type": "invoiceTransactions"
          }
        ]
      },
      "refundLinks": {
        "data": []
      },
      "targetAccount": {
        "data": {
          "id": "13a85b45-8543-41c7-b963-394d4ea128ae",
          "type": "accounts"
        }
      }
    },
    "type": "invoices"
  },
  "included": [
    {
      "attributes": {
        "balance": "39269.57",
        "bankDepositAvailable": true,
        "bankReference": "BDR6421088115176062",
        "bankWithdrawalAvailable": true,
        "currencyCode": "EUR",
        "currencyType": "fiat",
        "label": "master",
        "master": true,
        "totalBalance": null,
        "transferAvailable": true
      },
      "id": "13a85b45-8543-41c7-b963-394d4ea128ae",
      "relationships": {
        "company": {
          "meta": {
            "included": false
          }
        },
        "networks": {
          "meta": {
            "included": false
          }
        },
        "txnBankCredentials": {
          "meta": {
            "included": false
          }
        }
      },
      "type": "accounts"
    },
    {
      "attributes": {
        "createdAt": "2026-11-03T10:29:33.818Z",
        "label": "Tron (TRC20)",
        "value": "TCSvcJTVBCaA6QCeYcPjNWrgQkA8SCbWKg"
      },
      "id": "c59d9bfc-b24d-4748-9013-12d5f6006404",
      "relationships": {
        "account": {
          "meta": {
            "included": false
          }
        },
        "network": {
          "meta": {
            "included": false
          }
        }
      },
      "type": "addresses"
    },
    {
      "attributes": {
        "amountBilled": "12.000000",
        "billedChargedRate": "1.0",
        "billedChargedRateCurrency": "USDT",
        "consolidationFee": "0.000000",
        "simplifiedState": "pending",
        "targetTransactionFee": "1.11",
        "targetTransactionFeeCurrency": "EUR",
        "transactionFee": "1.243710",
        "transactionFeeCurrency": "USDT"
      },
      "id": "a0f00966-cca6-4377-9e02-726fd9968cd5",
      "relationships": {
        "account": {
          "meta": {
            "included": false
          }
        },
        "author": {
          "meta": {
            "included": false
          }
        },
        "exchangeQuote": {
          "data": null
        },
        "invoice": {
          "meta": {
            "included": false
          }
        },
        "txn": {
          "data": {
            "id": "a0f00966-cca6-4377-9e02-726fd9968cd5",
            "type": "transactions"
          }
        }
      },
      "type": "invoiceTransactions"
    },
    {
      "attributes": {
        "accountId": "13a85b45-8543-41c7-b963-394d4ea128ae",
        "amount": "9.56",
        "balance": null,
        "createdAt": "2026-11-04T11:07:18.843Z",
        "currency": "EUR",
        "reference": "docs-webhook-invoice-1793790438",
        "simplifiedState": "pending",
        "transactionType": "InvoiceTransaction"
      },
      "id": "a0f00966-cca6-4377-9e02-726fd9968cd5",
      "relationships": {
        "account": {
          "meta": {
            "included": false
          }
        },
        "author": {
          "meta": {
            "included": false
          }
        },
        "transactionDetails": {
          "meta": {
            "included": false
          }
        }
      },
      "type": "transactions"
    }
  ],
  "meta": {}
}
```

{% endtab %}

{% tab title="Status Cancelled" %}

```json
{
  "data": {
    "attributes": {
      "amountBilled": "12.000000",
      "amountCharged": "12.000000",
      "billedCurrency": "USDT",
      "chargedCurrency": "USDT",
      "chargedTargetRate": "0.88903",
      "chargedTargetRateCurrency": "EUR",
      "createdAt": "2026-11-04T11:07:18.828Z",
      "exchangeRate": "1.0",
      "expiresAt": "2026-11-04T11:27:18.783Z",
      "hostedPageUrl": "https://sandbox.txn.io/redirect?item_id=98e8776d-1229-4bbf-8989-2b0a18541897&request_type=item_hosted_page",
      "network": "ttrx:usdt",
      "networkName": "Tron (TRC20)",
      "paymentMethods": [
        "on_chain"
      ],
      "paymentStatus": "expecting",
      "reference": "docs-webhook-invoice-1793790438",
      "scAddress": null,
      "status": "cancelled",
      "statusContext": "unpaid",
      "successRedirectUrl": null,
      "targetAmount": "9.56",
      "targetCurrency": "EUR",
      "unsuccessRedirectUrl": null
    },
    "id": "98e8776d-1229-4bbf-8989-2b0a18541897",
    "relationships": {
      "address": {
        "data": {
          "id": "c59d9bfc-b24d-4748-9013-12d5f6006404",
          "type": "addresses"
        }
      },
      "binanceOrder": {
        "data": null
      },
      "coinDeposits": {
        "data": []
      },
      "invoiceTransactions": {
        "data": [
          {
            "id": "a0f00966-cca6-4377-9e02-726fd9968cd5",
            "type": "invoiceTransactions"
          }
        ]
      },
      "refundLinks": {
        "data": []
      },
      "targetAccount": {
        "data": {
          "id": "13a85b45-8543-41c7-b963-394d4ea128ae",
          "type": "accounts"
        }
      }
    },
    "type": "invoices"
  },
  "included": [
    {
      "attributes": {
        "balance": "39279.06",
        "bankDepositAvailable": true,
        "bankReference": "BDR6421088115176062",
        "bankWithdrawalAvailable": true,
        "currencyCode": "EUR",
        "currencyType": "fiat",
        "label": "master",
        "master": true,
        "totalBalance": null,
        "transferAvailable": true
      },
      "id": "13a85b45-8543-41c7-b963-394d4ea128ae",
      "relationships": {
        "company": {
          "meta": {
            "included": false
          }
        },
        "networks": {
          "meta": {
            "included": false
          }
        },
        "txnBankCredentials": {
          "meta": {
            "included": false
          }
        }
      },
      "type": "accounts"
    },
    {
      "attributes": {
        "createdAt": "2026-11-03T10:29:33.818Z",
        "label": "Tron (TRC20)",
        "value": "TCSvcJTVBCaA6QCeYcPjNWrgQkA8SCbWKg"
      },
      "id": "c59d9bfc-b24d-4748-9013-12d5f6006404",
      "relationships": {
        "account": {
          "meta": {
            "included": false
          }
        },
        "network": {
          "meta": {
            "included": false
          }
        }
      },
      "type": "addresses"
    },
    {
      "attributes": {
        "amountBilled": "12.000000",
        "billedChargedRate": "1.0",
        "billedChargedRateCurrency": "USDT",
        "consolidationFee": "0.000000",
        "simplifiedState": "cancelled",
        "targetTransactionFee": "1.11",
        "targetTransactionFeeCurrency": "EUR",
        "transactionFee": "1.243710",
        "transactionFeeCurrency": "USDT"
      },
      "id": "a0f00966-cca6-4377-9e02-726fd9968cd5",
      "relationships": {
        "account": {
          "meta": {
            "included": false
          }
        },
        "author": {
          "meta": {
            "included": false
          }
        },
        "exchangeQuote": {
          "data": null
        },
        "invoice": {
          "meta": {
            "included": false
          }
        },
        "txn": {
          "data": {
            "id": "a0f00966-cca6-4377-9e02-726fd9968cd5",
            "type": "transactions"
          }
        }
      },
      "type": "invoiceTransactions"
    },
    {
      "attributes": {
        "accountId": "13a85b45-8543-41c7-b963-394d4ea128ae",
        "amount": "9.56",
        "balance": null,
        "createdAt": "2026-11-04T11:07:18.843Z",
        "currency": "EUR",
        "reference": "docs-webhook-invoice-1793790438",
        "simplifiedState": "cancelled",
        "transactionType": "InvoiceTransaction"
      },
      "id": "a0f00966-cca6-4377-9e02-726fd9968cd5",
      "relationships": {
        "account": {
          "meta": {
            "included": false
          }
        },
        "author": {
          "meta": {
            "included": false
          }
        },
        "transactionDetails": {
          "meta": {
            "included": false
          }
        }
      },
      "type": "transactions"
    }
  ],
  "meta": {}
}
```

{% endtab %}
{% endtabs %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.txn.io/invoices/invoice-webhooks.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
