All APIs
Rewards

Corporate Gold Rewards

POST/api/marketplace/v1/corporate/gift-gold starter+ plan

Overview

Trigger a digital 24K-gold gift for an employee or customer. Powered by L4B Labs + OroPocket — India's trusted digital-gold infrastructure. 0.25% platform fee + 18% GST on fee only, no setup costs, no per-seat fees. Perfect for HRMS, employee-engagement, loyalty and CRM systems.

Use case
Automate birthdays, work-anniversaries, festival campaigns and one-off rewards from your HR / loyalty platform. Returns a claim URL you deliver to the recipient over email / SMS / WhatsApp.

Authentication

All requests require the X-API-Key header. Sandbox and live keys share the same base URL — the platform routes based on the key prefix.

Base URL
https://api.loan4bank.com/v3
Auth header
X-API-Key: <YOUR_KEY>

Request parameters

NameTypeRequiredDescriptionExample
employer_namestringRequiredDisplay name shown to the recipient."Acme Corp"
recipient_namestringRequiredEmployee / customer full name."Priya Sharma"
recipient_mobilestringRequired10-digit Indian mobile (auto-normalised)."9876543210"
recipient_emailstringOptionalOptional — used for delivery receipt."priya@acme.com"
amountintegerRequiredGift amount in INR. Min ₹101.2100
occasion_labelstringRequiredFree-text label shown on the claim page."Birthday"
idempotency_keystringOptionalDedupes retries. Header `Idempotency-Key` wins over body."acme-2026-07-14-priya"

Response schema

FieldTypeDescription
data.txn_idstringLoan4Bank transaction ID (L4B-EXT-*).
data.claim_urlstringPWA URL to deliver to the recipient.
data.claim_tokenstringOne-time secret — deliver, DO NOT log.
data.amountintegerEcho of gift amount (INR).
data.feeinteger0.25% platform fee (min ₹1).
data.gst_on_feeinteger18% GST charged on the platform fee only.
data.total_chargeintegerAmount billed to your account (gift + fee + GST).
data.employerstringEcho of the employer_name field.
data.occasion_labelstringEcho of the occasion_label field.
data.created_atstringISO-8601 UTC timestamp.

Sample request & response

Request · cURL
curl -X POST 'https://api.loan4bank.com/v3/marketplace/v1/corporate/gift-gold' \
  -H 'X-API-Key: <YOUR_KEY>' \
  -H 'Content-Type: application/json' \
  -d '{"employer_name":"Acme Corp","recipient_name":"Priya Sharma","recipient_mobile":"9876543210","recipient_email":"priya@acme.com","amount":2100,"occasion_label":"Birthday","idempotency_key":"acme-2026-07-14-priya"}'
Sample response
{
  "status": "SUCCESS",
  "message": "Gift scheduled",
  "data": {
    "txn_id": "L4B-EXT-6DAD4011EF",
    "claim_url": "/gold/claim/zJsuLm6ZDlsUDV-HEEvQeuILrV0a4cwQ",
    "claim_token": "zJsuLm6ZDlsUDV-HEEvQeuILrV0a4cwQ",
    "amount": 2100,
    "fee": 6,
    "gst_on_fee": 2,
    "total_charge": 2108,
    "employer": "Acme Corp",
    "occasion_label": "Birthday",
    "created_at": "2026-08-07T00:10:24Z"
  }
}
Want to hit this endpoint without leaving the docs? and use the in-modal runner — it's pre-loaded with this endpoint's sample body.

Error codes

HTTPCodeFix
400L4B-001Check the params table for the endpoint and re-send.
401L4B-101Include the header on every request.
401L4B-102Rotate via /developer/dashboard or grab a fresh sandbox key.
402L4B-201Upgrade to the min plan shown in the endpoint's docs page.
403L4B-301Toggle it on via `POST /developers/apis/toggle` or the dashboard.
404L4B-401Verify the URL path and version prefix (`/v1/`).
422L4B-421Check the response body for `detail` — it names the offending field.
429L4B-491Backoff `Retry-After` seconds, or upgrade the plan.
See the full error reference

Rate limits by plan

PlanMonthly quotaBurstPrice
free100 calls10 / minute₹0
starter5,000 calls60 / minute₹999 / month
growth25,000 calls240 / minute₹2,999 / month
enterpriseUnlimited1,200 / minuteCustom

Changelog

See the platform changelog for version-level history covering this endpoint.