Create Withdraw (Crypto)

POST

/api/v2/withdraw

Opens a crypto pay-out. type must be crypto, and the destination is a chain address instead of an IBAN — iban is not required.

Nothing is sent on this request. A chain transfer cannot be recalled, so the withdrawal is created as pending and the transfer leaves only once it is approved in the Pay2Pays panel. It then stays pending until the network confirms it, and the final result arrives at your callback_url.

Check the address and network carefully: funds sent on the wrong network cannot be recovered.

Request

Header Params

Body Params application/json

Examples

Responses

🟢201

application/json

Bodyapplication/json

🟠422

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://sandbox-api.pay2pays.co/api/v2/withdraw' \
--header 'x-api-key: {{api_key}}' \
--header 'x-secret-key: {{secret_key}}' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data '{
    "transaction_id": "WTH_{{$randomInt}}",
    "first_name": "John",
    "last_name": "Doe",
    "username": "johndoe",
    "amount": 500.0,
    "currency": "TRY",
    "type": "crypto",
    "crypto_address": "TJRyWwFs9wTFGZg3JbrVriFbNfCug5tDeC",
    "crypto_asset": "USDT",
    "crypto_network": "tron",
    "callback_url": "https://www.site.com/callback/pay2pays",
    "extra_fields": {
        "note": "Crypto withdrawal"
    }
}'

Response Example

201 - Success

{
    "success": true,
    "message": "Withdrawal request created successfully.",
    "data": {
        "transaction_id": "WTH_507",
        "hashed_transaction_id": "90eb7665-1e98-4912-a68c-f9b408987e0c",
        "status": "pending",
        "amount": "500.00"
    },
    "code": 201
}

Modified at 2026-10-16 08:38:30

Check Withdrawal Status

Callback