Burn MPT tokens

Reduce the token supply by burning tokens.

How burning works

When a holder sends tokens back to the issuer address, the tokens are automatically burned. This is the standard mechanism for reducing token supply on the XRP Ledger.

Tokens sent to the issuer are automatically destroyed, reducing the total supply. There is no separate "burn" transaction — the burn happens automatically when tokens are sent to the issuer.

Prerequisites

The holder must have tokens to send
The MPT must allow transfers (or be sent by the issuer)

Burn tokens

To burn tokens, send them to the issuer address using a Payment operation:

{
  "payload": {
    "id": "{{intent_id}}",
    "accountId": "{{holder_account_id}}",
    "parameters": {
      "type": "XRPL",
      "feeStrategy": {
        "priority": "Medium",
        "type": "Priority"
      },
      "operation": {
        "type": "Payment",
        "destination": {
          "address": "rIssuerAddress...",
          "type": "Address"
        },
        "amount": "500000",
        "currency": {
          "issuanceId": "000004C463C52827307480341125DA0577AFFC21D4B2D0831E",
          "type": "MultiPurposeToken"
        }
      }
    },
    "customProperties": {},
    "type": "v0_CreateTransactionOrder"
  }
}

Parameters

Field	Type	Required	Description
`destination`	object	Yes	The issuer account to send tokens to (for burning).
`destination.type`	string	Yes	One of: `Account` (internal account UUID), `Address` (XRPL address), or `Endpoint` (endpoint UUID).
`destination.address`	string	Conditional	The issuer's XRPL address. Required when `destination.type` is `Address`.
`destination.accountId`	string	Conditional	Internal account UUID. Required when `destination.type` is `Account`.
`destination.endpointId`	string	Conditional	Endpoint UUID. Required when `destination.type` is `Endpoint`.
`amount`	string	Yes	The amount to burn (raw integer value).
`currency.issuanceId`	string	Yes	The 192-bit MPT issuance ID.
`currency.type`	string	Yes	Must be `MultiPurposeToken`.

Response

A successful request returns the transaction order with status Pending. After confirmation:

The holder's balance decreases by the burned amount.
The total supply decreases accordingly.
The tokens are permanently destroyed.

Multi-purpose tokens — Overview of MPT operations.
Destroy issuance — Permanently retire the MPT when supply is zero.