---
title: Execute Crypto Payout Order
slug: execute-crypto-payout-order
docTags: 
createdAt: 2025-05-02T10:40:00.252Z
---

This API is used to execute a crypto payout order and complete the user’s withdrawal. It accepts `token` , `requestId` and `clientId`

:::hint{type="info"}
Call this api after generating token from [Crypto Payout Order with mode=createEstimate](docId:_Ma9YwvAYBFe7QKrHQhWG) 
:::

:::ApiMethodV2
```json
{
  "name": "Execute Crypto Payout Order",
  "method": "POST",
  "url": "https://your-hostname.pay3.app/v1/client/crypto-payout/execute",
  "description": "Execute an order with payout details from application's backend",
  "tab": "examples",
  "examples": {
    "languages": [
      {
        "id": "nyfSHp7J-NrsuqTH3FW7t",
        "language": "curl",
        "code": "curl --location 'https://api.dev.pay3.app/v1/client/crypto-payout/execute' \\\n--header 'signature: {{signature}}' \\\n--header 'access-token: {dynamic-access-toke}' \\\n--header 'Content-Type: application/json' \\\n--data '{\n    \"token\":\"a003d60c-d0ae-40e5-a7cb-2634ab607253\",\n    \"requestId\":\"a1d4a50e-5577-4581-a980-98b03bc76260\",\n    \"clientId\":\"....\"\n}'\n",
        "customLabel": ""
      }
    ],
    "selectedLanguageId": "nyfSHp7J-NrsuqTH3FW7t"
  },
  "results": {
    "languages": [
      {
        "id": "VQyRchSR38UbBEhATUpjh",
        "language": "200",
        "code": "{\n    \"txnHash\": \"...\",\n    \"orderType\": \"PAYOUT\",\n    \"orderId\": \"3b5a941c-efef-4125-9237-3216ddd6f607\",\n    \"requestId\": \"a1d4a50e-5577-4581-a980-98b03bc76260\",\n    \"status\": \"ORDER_PAYMENT_PROCESSING\"\n}",
        "customLabel": ""
      },
      {
        "id": "tIvoQbUSKGnrqallvNDVQ",
        "language": "401",
        "code": "{\n    error: {\n      code: '7001',\n      message: 'Order already exists for given requestId'\n    }\n}",
        "customLabel": ""
      }
    ],
    "selectedLanguageId": "VQyRchSR38UbBEhATUpjh"
  },
  "request": {
    "pathParameters": [],
    "queryParameters": [],
    "headerParameters": [
      {
        "name": "token",
        "kind": "required",
        "type": "string",
        "description": "The token received from the Create Crypto Payout Order API with mode=createEstimate",
        "": "The token received from the Create Crypto Payout Order API with mode=createEstimate"
      },
      {
        "name": "requestId",
        "kind": "required",
        "type": "string",
        "description": "Identifier that is created by Application's backend. This will be passed in relevant events and webhooks from Pay3 to Application. Pass the same Id used while creating payout order.",
        "": "Identifier that is created by Application's backend. This will be passed in relevant events and webhooks from Pay3 to Application. Pass the same Id used while creating payout order."
      },
      {
        "name": "clientId",
        "kind": "required",
        "type": "string",
        "description": "Client id. Application's identifier. ",
        "": "Client id. Application's identifier. "
      }
    ],
    "bodyDataParameters": [],
    "formDataParameters": []
  },
  "currentNewParameter": {
    "label": "Header Parameter",
    "value": "headerParameters"
  },
  "hasTryItOut": false,
  "response": [
    {
      "name": "orderId",
      "kind": "optional",
      "type": "string",
      "description": "The unique identifier generated by Pay3 for this payout order. This ID can be used for referencing the payout in logs, dashboard views, API queries, and webhook events.",
      "children": []
    },
    {
      "name": "requestId",
      "kind": "optional",
      "type": "string",
      "description": "The same requestId provided during payout creation and execution. Returned here for consistency, allowing applications to correlate the execution response with the original payout request.",
      "children": []
    },
    {
      "name": "txnHash",
      "kind": "optional",
      "type": "string",
      "description": "The blockchain transaction hash generated after the payout is broadcasted to the network. This can be used to track the payout on the respective blockchain explorer. This can be null if the order is still processing."
    },
    {
      "name": "orderType",
      "kind": "optional",
      "type": "string",
      "description": "Indicates the type of order being processed. For this API, the value will always be PAYOUT, confirming that the request corresponds to a withdrawal operation.",
      "children": []
    },
    {
      "name": "status",
      "kind": "optional",
      "type": "string",
      "description": "Indicates the current stage or final outcome of the payout execution. The possible statuses include:\n\n-  ORDER_PAYMENT_PROCESSING: The payout request is under process. You will receive status updates via Webhook. Please call the Crypto Order Details api for details. \n\n- FAILED: The payout could not be processed.  ",
      "children": []
    }
  ],
  "autoGeneratedAnchorSlug": "execute-crypto-payout-order",
  "legacyHash": "sqj7sRsDC04r4g-8bBx8B"
}
```
:::

##

***