Skip to main content
POST
/
payouts
/
{payoutId}
/
action
Create Payout Action
curl --request POST \
  --url https://api.dfns.io/payouts/{payoutId}/action \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'X-DFNS-USERACTION: <api-key>' \
  --data '
{
  "walletId": "wa-5pfuu-9euek-h0odgb6snva8ph3k",
  "transfer": {
    "amount": "<string>",
    "contract": "<string>",
    "to": "<string>"
  }
}
'
{}

​
Authentication

✅ Organization User (CustomerEmployee)
✅ Delegated User (EndUser)
✅ Service Account

​
Required Permissions

Payouts:Write: Always required.

Authorizations

​
Authorization
string
header
required

Bearer Token: Used to authenticate API requests. More details how to generate the token: Authentication flows

​
X-DFNS-USERACTION
string
header
required

User Action Signature: Used to sign the change-inducing API requests. More details how to generate the token: User Action Signing flows

Path Parameters

​
payoutId
string
required

Payout id.

Required string length: 1 - 64

Body

application/json
​
action
enum<string>
required
Available options:
Confirm
​
walletId
string
required

The wallet ID to use for the transfer.

Required string length: 1 - 64
Pattern: ^wa-[a-z0-9]{5}-[a-z0-9]{5}-[a-z0-9]{14,16}$
Example:

"wa-5pfuu-9euek-h0odgb6snva8ph3k"

​
transfer
ERC-20 Transfer · object
required

The transfer details for the payout settlement.

Response

200 - application/json

Success

The response is of type object.

Last modified on May 29, 2026