Fetch a wallet credential

curl --request GET \
  --url https://api.paystack.com/v1/wallets/{id}/credentials/{credentialId} \
  --header 'Authorization: Bearer <token>'

{
  "status": true,
  "message": "Wallet credential fetched successfully",
  "code": "ok",
  "data": {
    "id": "wcr_01HXYZABC1234567890ABCDEFG",
    "type": "crypto",
    "currency": "USDC",
    "network": "base",
    "wallet": {
      "id": "wal_01HXYZABC1234567890ABCDEFG",
      "currency": "USDC",
      "label": "USDC Wallet"
    },
    "metadata": {
      "team": "ops"
    },
    "details": {
      "accountName": "Medard Ilunga",
      "accountNumber": "1234567890",
      "bankName": "Wema Bank",
      "bankCode": "035",
      "currency": "NGN"
    },
    "status": "pending",
    "created_at": "2026-05-20T12:00:00.000Z",
    "updated_at": "2026-05-20T12:00:00.000Z",
    "label": "Treasury deposit"
  },
  "meta": {
    "request_id": "req_01HXYZ4K5ABCDEFGHJKLMNPQRS",
    "timestamp": "2026-05-14T15:43:55.732Z",
    "version": "1"
  }
}

Wallets

Fetch a wallet credential

Returns a single credential by its wcr_… external id, scoped to the wallet identified by the wal_… id in the path.

Errors

400 invalid_input — the wallet id does not start with wal_, or the credential id does not start with wcr_.
404 not_found — the wallet does not exist in this integration, or the credential does not exist under that wallet. A single 404 covers every miss path (unknown id, wrong wallet, wrong integration, wrong purpose).

GET

wallets

{id}

credentials

{credentialId}

Fetch a wallet credential

curl --request GET \
  --url https://api.paystack.com/v1/wallets/{id}/credentials/{credentialId} \
  --header 'Authorization: Bearer <token>'

{
  "status": true,
  "message": "Wallet credential fetched successfully",
  "code": "ok",
  "data": {
    "id": "wcr_01HXYZABC1234567890ABCDEFG",
    "type": "crypto",
    "currency": "USDC",
    "network": "base",
    "wallet": {
      "id": "wal_01HXYZABC1234567890ABCDEFG",
      "currency": "USDC",
      "label": "USDC Wallet"
    },
    "metadata": {
      "team": "ops"
    },
    "details": {
      "accountName": "Medard Ilunga",
      "accountNumber": "1234567890",
      "bankName": "Wema Bank",
      "bankCode": "035",
      "currency": "NGN"
    },
    "status": "pending",
    "created_at": "2026-05-20T12:00:00.000Z",
    "updated_at": "2026-05-20T12:00:00.000Z",
    "label": "Treasury deposit"
  },
  "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.

Path Parameters

string

required

Pattern: [^\/#\?]+?

credentialId

string

required

Pattern: [^\/#\?]+?

Response

Wallet credential fetched successfully

status

enum<boolean>

required

Available options:

true

Example:

true

message

string

required

Human-readable summary

Example:

"Wallet credential fetched successfully"

code

enum<string>

required

Available options:

ok

Example:

"ok"

data

object

required

Show child attributes