---
title: "Withdraw from a Card"
method: POST
path: "/pms/api/external/request/virtual-cards/{card_id}/withdraw/"
tags: ["Issuing"]
---

# Withdraw from a Card

`POST /pms/api/external/request/virtual-cards/{card_id}/withdraw/`

Move USD from card to business wallet (min $3).

## Path parameters

- `card_id` string, uuid, required

## Headers

- `api-key` string, required
- `api-secret` string, required
- `Content-Type` 'application/json', required

## Request body

- VirtualCardAmountRequest
  - `amount` string, required — USD amount (e.g. 25.00). Fund minimum 1.00; withdraw minimum 3.00

## Response `200`

Withdrawal successful

- VirtualCardResponse
  - `status` boolean, required — Indicates whether the request succeeded
  - `message` string, required — Human-readable result message
  - `data` IssuedCard, required
    - `id` string, uuid — PayVessel card ID
    - `business_id` string, uuid — Owning business
    - `kind` string — customer card
    - `customer_id` string, uuid — Linked customer ID
    - `customer_name` string — Customer display name
    - `card_name` string — Name on card
    - `masked_pan` string — Masked PAN (empty while PENDING)
    - `status` 'PENDING' | 'ACTIVE' | 'FROZEN' | 'TERMINATED' | 'FAILED' — Card lifecycle status
    - `currency` string — USD
    - `brand` string — VISA or MASTERCARD
    - `balance` string — Issuer-synced balance in USD
    - `expiry` string — Card expiry (MM/YY)
    - `card_number` string — Full PAN (GET card only, when ACTIVE/FROZEN)
    - `cvv` string — CVV (GET card only, when ACTIVE/FROZEN)
    - `created_datetime` string, date-time
    - `updated_datetime` string, date-time

## Other responses

- `401` — Unauthorized request
- `403` — Forbidden request
- `404` — Resource not found
- `500` — Internal server error

---

[API](https://skmtc.dev/payvessel/apis/payvessel-value-added-services-api.md) · [All operations](https://skmtc.dev/payvessel/apis/payvessel-value-added-services-api/llms.txt) · [OpenAPI document](https://skmtc.dev/payvessel/apis/payvessel-value-added-services-api/revisions/31040a9358ef?raw)