Execute a Payout Request

Using the payout request ID and the transfer-api-key header, execute the payout request using the execute Payout Request endpoint

You will need to ensure the specified sourceAccountId has sufficient balance to cover the total value of the Payout Request before execution otherwise execution will fail.

Example request body

curl --request POST \
     --url http://app.muralpay.com/api/payouts/payout/e5728f35-f13e-45a2-ba38-144da973938a/execute \
     --header 'accept: application/json' \
     --header 'authorization: Bearer $API-KEY' \
     --header 'on-behalf-of: 807742f0-e76c-44cd-bbe9-30b02e0060f4' \
     --header 'transfer-api-key: $TRANSFER-KEY'

Example response

{
    "id": "e5728f35-f13e-45a2-ba38-144da973938a",
    "createdAt": "2025-04-05T04:24:03.862Z",
    "updatedAt": "2025-04-05T04:24:03.862Z",
    "sourceAccountId": "5d75e362-0812-4ea8-b203-c7c3a09f8473",
    "memo": "December Contract",
    "status": "PENDING",
    "payouts": [
        {
            "id": "34998641-c981-44bc-beda-14b930999284",
            "createdAt": "2025-04-05T04:24:03.869Z",
            "updatedAt": "2025-04-05T04:24:03.869Z",
            "amount": {
                "tokenSymbol": "USDC",
                "tokenAmount": 100
            },
            "details": {
                "type": "fiat",
                "fiatAndRailCode": "cop",
                "fiatAmount": {
                    "fiatAmount": 305421.23,
                    "fiatCurrencyCode": "COP"
                },
                "transactionFee": {
                    "tokenSymbol": "USDC",
                    "tokenAmount": 0.35
                },
                "exchangeFeePercentage": 1.4,
                "exchangeRate": 3108.613065,
                "feeTotal": {
                    "tokenSymbol": "USDC",
                    "tokenAmount": 1.75
                },
                "fiatPayoutStatus": {
                    "type": "created"
                }
            }
        }
    ]
}

Your Payout Request is now in process and your funds are on their way to your recipient!

For more information on the various statuses associated with this Payout Request, see documentation on Payout Request statuses .