Withdraw Funds

To initiate a withdrawal, the process is carried out in two steps:

You initiate a withdrawal by sending a request to /balance/withdraw/request. The API returns a unique identifier for that request.
You finalize the payout by calling /balance/withdraw/confirm passing only the previously received identifier.

1. Create a withdraw Request

POST /balance/withdraw/request

Create a Withdraw Request and get some interesting data.

Headers

Name

Value

Content-Type

application/json

X-API-KEY

<token>

Body

Name

Type

Description

currency*

string

Currency

address*

string

Address to send

amount*

number

Amount to send

Response

{
  "identifier": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "currency": "USDTBEP20",
  "address": "0x...",
  "amount": 0,
  "amount_usd": 0,
  "service_fee": 0,
  "service_fee_usd": 0,
  "expires_at": "2025-06-12T10:04:32.962319Z"
}

{
    "detail": "<CURRENCY> is not available for withdraw at this moment"
}

{
    "detail": "Amount is less than minimum withdraw amount for <CURRENCY> (<CURRENCY.MIN_WITHDRAW>)"
}

{
    "detail": "Withdraw request not found"
}

{
    "detail": "Withdraw request expired"
}

{
    "detail": "Not enough balance"
}

Amount sent to the wallet = amount - service fee

Example

curl -X POST "https://api.nord-pay.com/balance/withdraw/request" \
     -H "Content-Type: application/json" \
     -H "X-API-KEY: YOUR_API_KEY" \
     -d '{
       "currency": "USDTBEP20",
       "address": "0x1234...abcd",
       "amount": 100.0
     }'

import requests

def create_withdraw_request(currency, address, amount):
    url = "https://api.nord-pay.com/balance/withdraw/request"
    headers = {
        "Content-Type": "application/json",
        "X-API-KEY": "YOUR_API_KEY"
    }
    payload = {
        "currency": currency,
        "address": address,
        "amount": amount
    }
    resp = requests.post(url, json=payload, headers=headers)
    resp.raise_for_status()
    return resp.json()

# usage:
request_data = create_withdraw_request(
    currency="USDTBEP20",
    address="0x1234...abcd",
    amount=100.0
)
# request_data["identifier"] — UUID for confirming

<?php
function createWithdrawRequest(
    string $currency,
    string $address,
    float $amount
): array {
    $url = "https://api.nord-pay.com/balance/withdraw/request";
    $payload = [
        "currency" => $currency,
        "address"  => $address,
        "amount"   => $amount
    ];

    $ch = curl_init($url);
    curl_setopt_array($ch, [
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_POST           => true,
        CURLOPT_POSTFIELDS     => json_encode($payload),
        CURLOPT_HTTPHEADER     => [
            "Content-Type: application/json",
            "X-API-KEY: YOUR_API_KEY"
        ],
    ]);
    $response = curl_exec($ch);
    curl_close($ch);

    return json_decode($response, true);
}

// usage:
$req = createWithdrawRequest("USDTBEP20", "0x1234...abcd", 100.0);
// $req["identifier"] — UUID for confirming

async function createWithdrawRequest({ currency, address, amount }) {
  const response = await fetch(
    "https://api.nord-pay.com/balance/withdraw/request",
    {
      method: "POST",
      headers: {
        "Content-Type": "application/json",
        "X-API-KEY": "YOUR_API_KEY"
      },
      body: JSON.stringify({ currency, address, amount })
    }
  );
  if (!response.ok) throw new Error(`HTTP ${response.status}`);
  return response.json();
}

// usage:
createWithdrawRequest({
  currency: "USDTBEP20",
  address: "0x1234...abcd",
  amount: 100.0
}).then(req => {
  // req.identifier — UUID for confirm
});

const axios = require('axios');

async function createWithdrawRequest({ currency, address, amount }) {
  const { data } = await axios.post(
    "https://api.nord-pay.com/balance/withdraw/request",
    { currency, address, amount },
    {
      headers: {
        "Content-Type": "application/json",
        "X-API-KEY": "YOUR_API_KEY"
      }
    }
  );
  return data;
}

// usage:
createWithdrawRequest({
  currency: "USDTBEP20",
  address: "0x1234...abcd",
  amount: 100.0
}).then(req => {
  // req.identifier — UUID for confirm
});

2. Confirm the Withdrawal

POST /balance/withdraw/confirm

Confirming Withdraw Request and sent money.

Headers

Name

Value

Content-Type

application/json

X-API-KEY

<token>

Body

Name

Type

Description

identifier*

string

UUID Of your Withdraw Request

Response

{
    "detail": "Withdrawal request created and waiting for admin approval", 
    "status": "pending,
    "id": 1
}

Example

curl -X POST "https://api.nord-pay.com/balance/withdraw/confirm" \
     -H "Content-Type: application/json" \
     -H "X-API-KEY: YOUR_API_KEY" \
     -d '{
       "identifier": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
     }'

import requests

def confirm_withdraw(identifier):
    url = "https://api.nord-pay.com/balance/withdraw/confirm"
    headers = {
        "Content-Type": "application/json",
        "X-API-KEY": "YOUR_API_KEY"
    }
    payload = { "identifier": identifier }
    resp = requests.post(url, json=payload, headers=headers)
    resp.raise_for_status()
    return resp.json()

# usage:
result = confirm_withdraw("xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx")
# result["tx_hash"], result["url"], etc.

<?php
function confirmWithdraw(string $identifier): array {
    $url = "https://api.nord-pay.com/balance/withdraw/confirm";
    $payload = [ "identifier" => $identifier ];

    $ch = curl_init($url);
    curl_setopt_array($ch, [
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_POST           => true,
        CURLOPT_POSTFIELDS     => json_encode($payload),
        CURLOPT_HTTPHEADER     => [
            "Content-Type: application/json",
            "X-API-KEY: YOUR_API_KEY"
        ],
    ]);
    $response = curl_exec($ch);
    curl_close($ch);

    return json_decode($response, true);
}

// usage:
$confirm = confirmWithdraw("xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx");
// $confirm["tx_hash"], $confirm["url"], $confirm["detail"]

async function confirmWithdraw({ identifier }) {
  const response = await fetch(
    "https://api.nord-pay.com/balance/withdraw/confirm",
    {
      method: "POST",
      headers: {
        "Content-Type": "application/json",
        "X-API-KEY": "YOUR_API_KEY"
      },
      body: JSON.stringify({ identifier })
    }
  );
  if (!response.ok) throw new Error(`HTTP ${response.status}`);
  return response.json();
}

// usage:
confirmWithdraw({ identifier: "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx" })
  .then(res => {
    // res.tx_hash, res.url, res.detail
  });

const axios = require('axios');

async function confirmWithdraw({ identifier }) {
  const { data } = await axios.post(
    "https://api.nord-pay.com/balance/withdraw/confirm",
    { identifier },
    {
      headers: {
        "Content-Type": "application/json",
        "X-API-KEY": "YOUR_API_KEY"
      }
    }
  );
  return data;
}

// usage:
confirmWithdraw({ identifier: "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx" })
  .then(res => {
    // res.tx_hash, res.url, res.detail
  });

PreviousRetrieve Balances NextMultiple Withdrawals

Last updated 3 months ago