BxBytix

WEBHOOKcallback_url

Payout Notification

Sent to the payout's callback_url, else the payout webhook URL, else the webhook URL from Settings → Notifications, signed with the same webhook secret. We POST when a withdrawal status changes. The body is the payout object plus event, without quote_rate and created_at. Return HTTP 2xx and a body strictly equal to success.

Headers and body

X-Bytix-Eventheaderrequired

Same as event in the JSON body.

X-Bytix-Signatureheaderrequired

Hex HMAC-SHA256 of the raw JSON body with your webhook secret.

eventstringrequired

payout.awaiting_approval, payout.pending, payout.rejected, payout.submitted, payout.completed, or payout.failed: always payout. plus the payout status.

payout_idstringrequired

Your payout id from create.

idstringrequired

Bytix payout id.

amountstringrequired

USD amount as a decimal string.

currencystringrequired

USD.

assetstringoptional

Ticker sent on-chain.

networkstringoptional

Network display name.

addressstringrequired

Destination address.

crypto_amountstringoptional

Quoted crypto for the requested USD.

fee_amountstringoptional

Fees of the withdrawal, in the payout asset.

fee_paid_bystringoptional

merchant or customer. With customer the fees are taken off what is sent.

net_amountstringoptional

Crypto sent on-chain.

statusstringrequired

Current payout status after the change.

txidstringoptional

On-chain transaction id when completed.

payer_idstringrequired

Your user id from create.

demobooleanrequired

True for a payout created with a demo key. Simulated: never debit a customer for it.