Create Payout

View as Markdown

Create a Payout by providing the Payout Request ID.

Notes:

  • You can provide multiple IDs eg: 7f839bdd-5acd-4ce3-984d-1be8357b642d,7f839bdd-5asd-4ce3-984d-1be8357b646d.

Method: POST

Path: https://api.blockbee.io/payout/create/

Parameters

Query Parameters

apikeystring•Required

API Key provided by BlockBee's Dashboard. Unsure how to get yours? Check this tutorial.

Note: The API key can also be sent as a header named apikey.

Request Body

This endpoint requires a request body with the payout_request_ids.

request_idsstring•Required

The ID or a list of IDs of the Payout Requests you want to include in the Payout.

Example:{request_ids=7f839bdd-5acd-4ce3-984d-1be8357b642d,7f839bdd-5asd-4ce3-914d-1be8357b646d}

Returns

Returns information about the newly created payout.

statusstring

Status of the request. Indicates success if the request has been accepted.

payout_infoobject

Contains detailed information about the created payout.

idstring

The ID of the created payout.

statusstring

The status of the created payout.

display_statusstring

The verbose status of the created payout.

fromstring

The source from which the payout was created, if applicable.

requestsobject

A map of payout request addresses to their respective amounts. The keys are dynamic wallet addresses, and the values are the string amounts.

total_requestedstring

The total cryptocurrency amount requested for the payout.

total_with_feestring

The total amount requested including the fee.

errorstring

The error message given in case the payout status is error.

blockchain_feestring

The fee paid to the blockchain for the transaction.

feestring

The fee associated with the payout.

coinstring

The cryptocurrency for the payout.

txidstring

The transaction ID of the payout, if it has been processed.

timestampstring

The timestamp when the payout was created.