Skip to main content
POST
Send Rewards from Server
Send rewards securely from your backend using the ZBD Earn API (v2). This method ensures all rewards are issued from a trusted environment, preventing client-side abuse and maintaining full control over reward distribution.
Reward Unit Configuration. The reward unit (e.g., 1 satoshi or $0.10) is defined for your game by your ZBD Customer Success Manager.

Configuration

Header Parameters

x-api-key
string
required
API key used for authentication. Obtain this from the Create an API Key step.

Body Parameters

rewardsUserId
string
required
The recipient’s ZBD Rewards User ID
amount
number
required
Reward amount in configured unitsExample: 10 (units defined by your ZBD Customer Success Manager)

Response Status Codes

Response Fields


Security Reminder, Never expose your API key in client-side code. Always send rewards from your backend server where your API key is securely stored.

Code Examples

Try It Out

Ready to send your first reward from the server? Use our API playground on the right to test with your API key.