Exporter: sell a scrip for cash

An exporter holding matured RoDTEP or RoSCTL credits that would otherwise sit idle sells them for cash, at a firm price benchmarked to the Scrip Reference Rate, settled the same business day.

All calls below use the base URL and header from Authentication: export BASE_URL=https://api.scripxhq.com and X-ScripX-Key: $SCRIPX_KEY. Run the whole flow first with a scripx_test_… key in the sandbox.

1. Connect the exporter firm

curl -X POST "$BASE_URL/v1/firms" \
  -H "X-ScripX-Key: $SCRIPX_KEY" \
  -H "Content-Type: application/json" \
  -d '{"iec": "0512345678", "name": "Acme Exports", "role": "exporter"}'

Then verify the firm’s customs account and complete it with the one-time authorization code. The firm can sell once its state is connected.

2. List the sellable credits

curl "$BASE_URL/v1/firms/0512345678/credits" \
  -H "X-ScripX-Key: $SCRIPX_KEY"

Each credit carries scheme, face_paise, balance_paise, expiry_date and a sellable flag. A credit with sellable: true has already cleared provenance screening and is ready to quote.

3. Quote each credit

Price one specific credit directly by its scrip_no:

curl -X POST "$BASE_URL/v1/quote" \
  -H "X-ScripX-Key: $SCRIPX_KEY" \
  -H "Content-Type: application/json" \
  -d '{"side": "sell", "scrip_no": "SCRIP204188"}'

{
  "side": "sell",
  "scrip_no": "SCRIP204188",
  "scheme": "RODTEP",
  "face_paise": 100000000,
  "price_bps": 9650,
  "all_in_paise": 96500000,
  "valid_until": "2026-07-25T14:32:00+05:30",
  "quote_ref": "qt_01J0..."
}

all_in_paise is the one number the seller receives: net, GST-exempt, nothing deducted after. valid_until is the firm window; quote_ref is your support reference.

4. Place the order with a floor

curl -X POST "$BASE_URL/v1/orders" \
  -H "X-ScripX-Key: $SCRIPX_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: acme-scrip204188-1" \
  -d '{"side": "sell", "scheme": "RODTEP", "amount_paise": 100000000, "min_pct_bps": 9600}'

min_pct_bps is the seller’s structural price floor: the order never fills below it. The Idempotency-Key makes a retry safe.

5. Get paid, with a UTR

Settlement is delivery-versus-payment. Title moves seller to buyer on ICEGATE, and the payout fires on ICEGATE confirmation by IMPS with a UTR, in minutes, same business day (T+0). Watch it with a webhook rather than polling:

curl -X POST "$BASE_URL/v1/webhooks" \
  -H "X-ScripX-Key: $SCRIPX_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com/hooks/scripx", "event": "*"}'

The happy path is order.matched then settlement.settled then payout.sent. The audit export carries the UTR into a tamper-evident record your auditor can verify offline.

Get started

Concepts

By role

Essentials

Resources

Exporter: sell a scrip for cash

1. Connect the exporter firm

2. List the sellable credits

3. Quote each credit

4. Place the order with a floor

5. Get paid, with a UTR

​1. Connect the exporter firm

​2. List the sellable credits

​3. Quote each credit

​4. Place the order with a floor

​5. Get paid, with a UTR

​Related

1. Connect the exporter firm

2. List the sellable credits

3. Quote each credit

4. Place the order with a floor

5. Get paid, with a UTR

Related