ForjioHuudisIdentityPlugipayPaymentsStorlaunchE-commerceFulkrumaFulfilmentRiplloMarketingLinkSnapShort URLsPawpadoGPU streaming
Ripllo Docs
⌘K

Quickstart

You'll have a working discount code in about five minutes. By the end of this page you'll have:

  1. Signed up for a Ripllo workspace.
  2. Generated an API key.
  3. Created a discount code and redeemed it against a test storefront cart.

If you'd rather read about concepts first, jump to Concepts. If you'd rather install the SDK first, see Installation.

Prerequisites

You'll need:

  • A working email address — we use Huudis SSO for sign-in, and verifying an email is part of sign-up.
  • About five minutes.
  • Either a terminal with curl (to follow this page's examples literally) or an SDK installed (covered in Installation).

You do not need a real Storlaunch storefront or a customer database. The redeem endpoint is happy to take a synthetic order ID for this walkthrough.

1. Sign up

Head to ripllo.com and click Get started. We use Huudis as our identity provider — you'll create one Huudis account and use it across every Forjio product (Ripllo, Storlaunch, Plugipay, Fulkruma, LinkSnap, and the rest).

Sign-up takes two clicks:

  1. Enter your email and choose a password.
  2. Click the verification link we send you.

Once you're verified, you land in your first workspace's dashboard.

Workspaces are how Ripllo isolates data. You get one workspace by default, and you can create more for different storefronts or environments. Each workspace has its own discount codes, referral programs, pixels, and API keys.

2. Get an API key

In the dashboard, navigate to Settings → API keys (or go directly to /dashboard/api-keys).

Click Create API key. Give it a name (something like "Quickstart").

Ripllo shows the secret once. Copy both values into your terminal as environment variables:

export RIPLLO_KEY_ID=AKIARPLO...
export RIPLLO_KEY_SECRET=...

Treat the secret like a password. Anyone with RIPLLO_KEY_SECRET can read and write data in this workspace. We never display it again after creation. If you lose it, revoke the key from the portal and mint a new one.

3. Create a discount code

The simplest end-to-end action is a discount code: a promo code with a value (% or fixed amount), scope (all products / specific products / tag filter), and optional usage limits.

Create one with the Node SDK:

import { RiplloClient } from '@forjio/ripllo-node';

const ripllo = new RiplloClient({
  keyId: process.env.RIPLLO_KEY_ID,
  secret: process.env.RIPLLO_KEY_SECRET,
});

const code = await ripllo.discountCodes.create({
  code: 'WELCOME10',
  type: 'percent',
  value: 10,
  currency: 'IDR',
  scope: 'all',
  maxUsesTotal: 100,
});

console.log('Created:', code.id);

Or with raw curl:

curl -X POST https://ripllo.com/api/v1/discount-codes \
  -H "Content-Type: application/json" \
  -H "Authorization: Ripllo-HMAC-SHA256 keyId=$RIPLLO_KEY_ID, scope=*, signature=<see below>" \
  -H "X-Ripllo-Timestamp: $(date +%s)" \
  -d '{
    "code": "WELCOME10",
    "type": "percent",
    "value": 10,
    "currency": "IDR",
    "scope": "all",
    "maxUsesTotal": 100
  }'

Ripllo uses HMAC signing — you compute a SHA-256 HMAC of method + path + timestamp + body_hash with your secret key. The exact algorithm is documented in API Authentication. The SDKs handle this for you automatically.

4. Redeem it

Pretend your storefront just took a successful order using WELCOME10. Call redeem to stamp a DiscountRedemption row:

const result = await ripllo.discountCodes.redeem({
  code: 'WELCOME10',
  customerId: 'cust_test_001',
  orderId: 'order_test_001',
  subtotal: 250000,
  currency: 'IDR',
});

console.log('Redeemed:', result.id, 'newly created:', result.created);

redeem is idempotent keyed on orderId — if your payment webhook fires twice, you won't double-count.

5. Verify it worked

Check the dashboard at Dashboard → Discounts and click WELCOME10. You should see the redemption listed with the order ID, subtotal, and customer ID.

Or fetch the stats via API:

ripllo discount get WELCOME10

You did it — you've created and redeemed your first Ripllo discount code.

What's next