Wallet

Credit (win)

Adds the payout to the player’s wallet and settles the bet identified by referenceTransactionId.

You receive a credit for every settled round, including losses — a lost round arrives with payout.amount of 0. Do not treat a zero payout as an error.

Important — This endpoint must not require a live player session. Credits are retried for up to 3 days and can arrive long after the player logged out.

Free rounds: the stake is already deducted from payout. Credit exactly the amount you are given.

POST

credit

curl --request POST \
  --url https://{host}/credit \
  --header 'Content-Type: application/json' \
  --header 'X-Zd-Signature: <api-key>' \
  --header 'X-Zd-Timestamp: <api-key>' \
  --data '
{
  "playerId": "acct_8f2c19",
  "transactionId": "test-transaction-1113",
  "referenceTransactionId": "test-transaction-1112",
  "gameId": "lucky-duck",
  "gameRoundId": "round-1234",
  "payout": {
    "amount": 1.97,
    "currency": "USD"
  },
  "reason": "paid"
}
'

{
  "operatorTransactionId": "op-tx-55902",
  "balance": {
    "amount": 96.97,
    "currency": "USD",
    "updatedAt": "2026-01-29T14:05:29.678Z"
  },
  "createdAt": "2026-01-29T14:05:29.678Z"
}

{
  "message": "missing field gameRoundId"
}

{
  "message": "invalid signature"
}

{
  "message": "transaction to settle not found"
}

{
  "message": "internal error"
}

Authorizations

X-Zd-Signature

string

header

required

Hex-encoded HMAC-SHA512(apiPath|timestamp|data, secretKey) computed by Zero-Dash. Recompute it and compare before doing anything else. See Request signature.

X-Zd-Timestamp

string

header

required

Unix time in milliseconds, and the exact value that was signed. Reject requests older than 5 minutes.

Body

application/json

playerId

string

required

Player account ID.

transactionId

string

required

Zero-Dash ID of this credit transaction. Use it as your idempotency key.

referenceTransactionId

string

required

transactionId of the bet being settled.

gameId

string

required

Slug of the game the round belongs to.

Example:

"lucky-duck"

gameRoundId

string

required

Same value as the debit that opened this round.

Example:

"round-1234"

payout

object

required

Decimal amount to add to the balance. 0 when the player lost — you still receive the call.

Show child attributes

reason

enum<string>

Type of the bet. paid is real money; freeround is a free round — each free spin is a separate bet with its own debit call.

Available options:

paid,

freeround

freeRoundData

object

Present only when reason is freeround.

Show child attributes

Response

Payout credited.

operatorTransactionId

string

required

Your internal transaction ID. Stored by Zero-Dash for troubleshooting only.

balance

object

required

The player's balance after the operation was applied.

Show child attributes

createdAt

string<date-time>

Transaction creation date (ISO-8601 UTC). Defaults to the time of processing when omitted.

curl --request POST \
  --url https://{host}/credit \
  --header 'Content-Type: application/json' \
  --header 'X-Zd-Signature: <api-key>' \
  --header 'X-Zd-Timestamp: <api-key>' \
  --data '
{
  "playerId": "acct_8f2c19",
  "transactionId": "test-transaction-1113",
  "referenceTransactionId": "test-transaction-1112",
  "gameId": "lucky-duck",
  "gameRoundId": "round-1234",
  "payout": {
    "amount": 1.97,
    "currency": "USD"
  },
  "reason": "paid"
}
'

{
  "operatorTransactionId": "op-tx-55902",
  "balance": {
    "amount": 96.97,
    "currency": "USD",
    "updatedAt": "2026-01-29T14:05:29.678Z"
  },
  "createdAt": "2026-01-29T14:05:29.678Z"
}

{
  "message": "missing field gameRoundId"
}

{
  "message": "invalid signature"
}

{
  "message": "transaction to settle not found"
}

{
  "message": "internal error"
}

Overview

Wallet

Troubleshooting

Credit (win)

Authorizations

Body

Response