Skip to main content
POST
/
v1
/
wallets
/
{id}
/
deposit-addresses
Create a wallet deposit address
curl --request POST \
  --url https://api.paystack.com/v1/wallets/{id}/deposit-addresses \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "label": "<string>",
  "metadata": {},
  "merchantReference": "<string>"
}
'
{
  "status": true,
  "message": "Wallet deposit address created successfully",
  "code": "ok",
  "data": {
    "id": "da_01HXYZABC1234567890ABCDEFG",
    "type": "crypto",
    "currency": "USDC",
    "wallet": {
      "id": "wal_01HXYZABC1234567890ABCDEFG",
      "currency": "USDC",
      "label": "USDC Wallet"
    },
    "metadata": {
      "invoice_id": "inv_001"
    },
    "details": {
      "network": "base",
      "address": "0xseedaliceusdc000000000000000000000000"
    },
    "status": "pending",
    "created_at": "2026-05-20T12:00:00.000Z",
    "updated_at": "2026-05-20T12:00:00.000Z",
    "label": "Invoice payments"
  },
  "meta": {
    "request_id": "req_01HXYZ4K5ABCDEFGHJKLMNPQRS",
    "timestamp": "2026-05-14T15:43:55.732Z",
    "version": "1"
  }
}

Authorizations

​
Authorization
string
header
required

API key issued during merchant onboarding.

Headers

​
Idempotency-Key
string

Optional client-supplied key. Identical key + identical body within 24h replays the original response. Identical key + different body returns 409 idempotency_conflict. The hash is over raw bytes — clients retrying must send the byte-identical body; a re-serialised JSON payload will produce a different hash and a 409. Strongly recommended for retry-safe clients.

Pattern: ^[A-Za-z0-9_\-]{8,255}$

Body

application/json

CreateDepositAddressDto

​
network
enum<string>
required
Available options:
solana,
base,
ethereum
​
label
string
Maximum string length: 128
​
metadata
object
​
merchantReference
string
Maximum string length: 128

Response

Wallet deposit address created successfully

​
status
enum<boolean>
required
Available options:
true
Example:

true

​
message
string
required

Human-readable summary

Example:

"Wallet deposit address created successfully"

​
code
enum<string>
required
Available options:
ok
Example:

"ok"

​
data
object
required
​
meta
object
required