Create a transaction

Time	Status	User Agent
Retrieving recent requests…

Creates a new transaction in quoted state. The transaction must be confirmed before it executes.

This is the universal endpoint for all payment types — Lightning, on-chain Bitcoin, USDT, fiat payouts, and internal swaps. The method and ccy fields determine the flow.

Example: Lightning Send

curl -X POST https://api.neutron.me/api/v2/transaction/ \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -d '{
    "sourceReq": {
      "ccy": "BTC",
      "method": "neutronpay"
    },
    "destReq": {
      "ccy": "BTC",
      "method": "lightning",
      "reqDetails": {
        "paymentRequest": "lnbc100u1p..."
      }
    }
  }'

Example: Lightning Receive

curl -X POST https://api.neutron.me/api/v2/transaction/ \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -d '{
    "sourceReq": {
      "ccy": "BTC",
      "method": "lightning",
      "reqDetails": {}
    },
    "destReq": {
      "ccy": "BTC",
      "method": "neutronpay",
      "amtRequested": 0.0001,
      "reqDetails": {}
    }
  }'

Payment Methods

Method	Description	reqDetails
`neutronpay`	Internal Neutron wallet	`{}`
`lightning`	Lightning Network	Send: `{ "paymentRequest": "lnbc..." }` / Receive: `{}`
`on-chain`	Bitcoin on-chain	Send: `{ "address": "bc1q..." }` / Receive: `{}`
`tron`	USDT via TRON	`{ "address": "T..." }`
`vnd-instant`	Vietnamese Dong bank payout	`{ "bankAcctNum": "...", "institutionCode": "..." }`

Key Rules

Amounts are in BTC (not satoshis) — 0.00000100 = 100 sats
Set amtRequested on one side only (source OR dest), not both
The response includes fee breakdown (neutronpayFees, networkFees) — review before confirming
KYC and sourceOfFunds are only required for fiat payouts
Use extRefId to attach your own reference ID for tracking

Response

Returns the transaction in quoted state with fees and exchange rate. See Schema & Sample Payloads for the full response structure.

Next Step

→ Confirm the transaction to execute it.

Schema & Sample Payloads — Full request/response reference
Transaction Status Types — All states explained
Send Bitcoin via Lightning — Lightning-specific guide
Receive Bitcoin via Lightning — Lightning receive guide