Confirm a transaction

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

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 TypeAfter Confirm
Lightning sendPayment sent immediately, settles in seconds
Lightning receiveInvoice becomes active, waiting for sender to pay
On-chain sendBitcoin transaction broadcast to network
On-chain receiveAddress activated, waiting for on-chain payment
Internal swapExecutes instantly — funds moved between wallets
Fiat payoutPayout queued for processing

Error Cases

ErrorCause
400 — Transaction in final stateAlready confirmed, completed, cancelled, or expired
401 — UnauthorizedInvalid or expired access token
404 — Not foundTransaction 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

Path Params
string
required
Responses
200

Success

401

Unauthorized - Invalid or missing authentication credentials

404

Not Found - The requested transaction does not exist

Language
Credentials
Bearer
JWT
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json