Skip to main content
POST
/
v1
/
partner
/
card
/
withdraw
curl -X POST https://services-staging.getplu.com/api/v1/partner/card/withdraw \
  -H "Authorization: Bearer sk_staging_your_api_key" \
  -H "Content-Type: application/json" \
  -H "idempotency-key: 770f9500-f30c-52e5-b827-557766551002" \
  -d '{
    "serviceCardId": "acme-card-xyz789jkl012mno",
    "amount": 25,
    "reference": "ref-test-001"
  }'

{
  "status": "success",
  "message": "Card withdrawal successful",
  "data": {}
}

Documentation Index

Fetch the complete documentation index at: https://docs.getplu.com/llms.txt

Use this file to discover all available pages before exploring further.

Withdraws funds from a card and credits the amount back to your partner wallet. Supported on both float-funded and crypto-funded cards.
​
Authorization
string
required
Bearer token. Example: Bearer sk_staging_your_api_key
​
idempotency-key
string
required
A unique key to ensure the request is processed only once. Use a UUID v4.
​
serviceCardId
string
required
The card’s service ID.
​
amount
number
required
Amount to withdraw in USD. Must be between 5 and 10000.
​
reference
string
required
Partner-supplied opaque correlator (1–256 chars). Echoed back on the resulting wallet.deposit.card-withdrawal webhook so you can match the wallet credit to your originating user transaction.
curl -X POST https://services-staging.getplu.com/api/v1/partner/card/withdraw \
  -H "Authorization: Bearer sk_staging_your_api_key" \
  -H "Content-Type: application/json" \
  -H "idempotency-key: 770f9500-f30c-52e5-b827-557766551002" \
  -d '{
    "serviceCardId": "acme-card-xyz789jkl012mno",
    "amount": 25,
    "reference": "ref-test-001"
  }'

{
  "status": "success",
  "message": "Card withdrawal successful",
  "data": {}
}
Minimum withdrawal amount is 5∗∗.Maximumis∗∗5**. Maximum is **10,000 per transaction. A withdrawal fee may apply based on your partner fee configuration.
Once the wallet is credited, a wallet.deposit.card-withdrawal webhook is delivered to your endpoint with the same reference echoed in data.reference. Use it to fan funds out to your end-user’s destination address.