Confirms a quoted transaction to begin execution. This is the second step in the two-step transaction flow.

Flow

POST /api/v2/transaction/       →  Creates transaction (quoted)
PUT  /api/v2/transaction/{id}/confirm  →  Confirms and executes (this endpoint)

Example Request

curl -X PUT https://api.neutron.me/api/v2/transaction/5e25d2f4-9bca-4b7a-a1ad-2cf056100cb6/confirm \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

No request body is needed — just the transaction ID in the URL.

What Happens After Confirmation

Transaction Type	After Confirm
Lightning send	Payment sent immediately, settles in seconds
Lightning receive	Invoice becomes active, waiting for sender to pay
On-chain send	Bitcoin transaction broadcast to network
On-chain receive	Address activated, waiting for on-chain payment
Internal swap	Executes instantly — funds moved between wallets
Fiat payout	Payout queued for processing

Error Cases

Error	Cause
400 — Transaction in final state	Already confirmed, completed, cancelled, or expired
401 — Unauthorized	Invalid or expired access token
404 — Not found	Transaction ID doesn't exist

Example error (already in final state):

{
  "resultStatus": "error",
  "code": "2005",
  "error": "transaction 5e25d2f4-... already in final state usercanceled",
  "errorMetadata": {
    "params": "{\"State\":\"usercanceled\",\"TxnID\":\"5e25d2f4-...\"}"
  }
}

Important Notes

Quoted transactions have an expiry time — confirm before it expires or the transaction moves to expired state
Review the fxRate and fee breakdown from the create response before confirming
Confirmation is irreversible for most transaction types (especially Lightning and on-chain sends)
If you don't want to proceed, use Cancel instead

Related