Fiat Payouts

Send fiat currency (VND, USD, etc.) from your Neutron wallet to bank accounts and mobile money providers. Fiat payouts require KYC information and source of funds declarations.

Create a Fiat Payout

curl -X POST https://api.neutron.me/api/v2/transaction/ \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -d '{
    "extRefId": "payout-001",
    "sourceReq": {
      "ccy": "BTC",
      "method": "neutronpay",
      "amtRequested": 0.001
    },
    "destReq": {
      "ccy": "VND",
      "method": "vnd-instant",
      "reqDetails": {
        "bankAcctNum": "0123456789",
        "institutionCode": "970422"
      },
      "kyc": {
        "type": "individual",
        "details": {
          "legalFullName": "LE VAN A",
          "countryCode": "VN"
        }
      }
    },
    "sourceOfFunds": {
      "purpose": 1,
      "source": 5,
      "relationship": 3
    }
  }'

Required Fields

FieldDescription
destReq.reqDetails.bankAcctNumRecipient bank account number
destReq.reqDetails.institutionCodeBank code from Get Fiat Institutions
destReq.kycRecipient identity: type, legalFullName, countryCode
sourceOfFunds.purposeReason for transfer (Purpose values)
sourceOfFunds.sourceOrigin of funds (Source values)
sourceOfFunds.relationshipSender-recipient relationship (Relationship values)

Look Up Bank Codes

curl "https://api.neutron.me/api/v2/reference/fiat-institution/by-country/VN" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

When is KYC Required?

Transaction TypeKYC?
BTC Lightning send/receiveNo
BTC on-chain send/receiveNo
USDT send/receiveNo
Internal wallet swapsNo
Fiat payouts (bank/mobile)Yes

Tips

  • Not all countries supported -- check fiat institutions endpoint first
  • Exchange rate shown in quoted response -- review before confirming
  • Fiat payouts go through additional states (destpendsent, destsent)
  • Use extRefId to track payouts in your system