Skip to main content
POST
/
v1
/
cashout
/
funding-transfers
curl -X POST https://api.zebedee.io/v1/cashout/funding-transfers \
  -H "apikey: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "zbd_user_id": "4ac4fd8a-cc2c-4d03-af09-a76f4e89d652",
    "amount": 1000,
    "currency": "USD",
    "idempotency_key": "90f9371e-c48a-4bc9-9075-ef7a4c6816ec",
    "external_id": "game-match-123",
    "description": "Level 37 reward"
  }'

{
  "success": true,
  "message": "Publisher fund completed successfully.",
  "data": {
    "transfer_id": "f4ba94c1-1234-5678-abcd-ef0123456789",
    "zbd_user_id": "4ac4fd8a-cc2c-4d03-af09-a76f4e89d652",
    "amount": 1000,
    "currency": "USD",
    "status": "COMPLETED",
    "external_id": "game-match-123",
    "description": "Level 37 reward",
    "created_at": "2026-05-28T22:21:02.987Z",
    "updated_at": "2026-05-28T22:21:03.067Z"
  }
}

​
Description

Credits a user’s cashout balance from your project’s funded pool. The user can then withdraw these funds via the widget. Amount is in currency minor units — for USD, 100 equals $1.00. This endpoint is idempotent on idempotency_key.

​
Configuration

​
Header Parameters

​
apikey
string
required
Your ZBD project API key (production scope).
​
Content-Type
string
Content Type

​
Body Parameters

​
zbd_user_id
string
required
The ZBD user ID returned by Create User.
​
amount
integer
required
Amount in currency minor units. For USD: 100 = 1.00,‘1000‘=1.00, `1000` = 10.00.
​
currency
string
required
Currency code. Currently only USD is supported.
​
idempotency_key
string
required
Unique key to prevent duplicate transfers. Use a UUID.
​
external_id
string
Optional: your internal transaction identifier for reconciliation.
​
description
string
Optional: human-readable description shown in transaction history.
curl -X POST https://api.zebedee.io/v1/cashout/funding-transfers \
  -H "apikey: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "zbd_user_id": "4ac4fd8a-cc2c-4d03-af09-a76f4e89d652",
    "amount": 1000,
    "currency": "USD",
    "idempotency_key": "90f9371e-c48a-4bc9-9075-ef7a4c6816ec",
    "external_id": "game-match-123",
    "description": "Level 37 reward"
  }'

{
  "success": true,
  "message": "Publisher fund completed successfully.",
  "data": {
    "transfer_id": "f4ba94c1-1234-5678-abcd-ef0123456789",
    "zbd_user_id": "4ac4fd8a-cc2c-4d03-af09-a76f4e89d652",
    "amount": 1000,
    "currency": "USD",
    "status": "COMPLETED",
    "external_id": "game-match-123",
    "description": "Level 37 reward",
    "created_at": "2026-05-28T22:21:02.987Z",
    "updated_at": "2026-05-28T22:21:03.067Z"
  }
}