Live demo, open source

Payout to points, reversals and cash-out prices, exact to the last unit

Enter an offer payout and your currency settings. Every number on the right is returned by the library's own functions from src/index.js, running in your browser with integer math only.

Integer-only BigInt math JavaScript and PHP 164 shared test vectors

Examples

Inputs

Offer and currency

Offer payout (USD)

Points per $1

User share (%)

Point decimals

Rounding

Time-limited bonus

Run a daily bonus window

Bonus (%)

Daily from (UTC)

Until (UTC)

Offer completed at (UTC)

Reversal

Balance when it arrives

Allow a negative balance

Cash-out

Reward value (USD)

Provider fee passed on (%)

Minimum cash-out (USD)

Balance before this offer

Points per $1 at cash-out (blank = same as earning)

Points credited

Why integers

If the offer is reversed

Cash-out

Inflation check

Library calls behind these numbers

Use it

npm install github:moonetix/reward-economy-kit

import { defineCurrency, parseUsd, pointsForPayout, applyReversal } from 'reward-economy-kit';

const coins = defineCurrency({ rate: '1000', userShareBps: 6000 });
const credited = pointsForPayout(parseUsd('0.85'), coins, { bonusBps: 1000 });
applyReversal({ balance: 400n, credited });

A PHP port with the same results lives in php/. The design guide in docs/guide.md covers choosing a rate, a share and a rounding mode.