SPCR Documentation
Using SPCR

For originators

Your workspace is hosted at its own subdomain, for example yourco.spcr.io. Its menu has Dashboard, Register receivables, Sell a pool, Issued receivables and API (see The SPCR API).

Before registering, confirm that your receivables documentation links the certificate to the claim. The certificate must not be transferable without the receivable it represents, and the receivable must not be transferable without the certificate. Otherwise the registry record and legal title can diverge. See Onboarding.

Dashboard

Four figures across the top (receivables registered, pools, pools available to sell, pools sold), the split of your receivables by status, your pools with their status, and the latest entries in your register: each registration and sale, with its transaction.

Register receivables

  1. Choose the pool. The page opens on Create pool: select Create a new pool to make one (see Creating a pool), or switch to Choose existing pool and pick one. The rest of the form is shown once a pool is selected. Registration cannot be undone and receivables cannot be moved between pools, so the pool must be selected explicitly.
  2. Upload a loan tape (.xlsx, .xls, .csv, .tsv or plain text) or enter Loan IDs manually, up to 1,500 rows per submission on the current test network (5,000 on Ethereum). In a demo workspace, Generate a sample tape fills in the pool's next 12 Loan IDs.
  3. Review the rows and submit.

Each row is processed independently, so an invalid row does not block valid ones. Each row returns one of the following results:

Result Action
Registered None. The receivable is on chain, with a transaction link.
Rejected, invalid format Correct the Loan ID and resubmit the row. See Loan ID rules.
Rejected, already registered Investigate. The Loan ID is already registered.
Not registered, network or time Resubmit the row. The network refused the transaction, or the submission ran out of time ("not attempted"). Nothing was written.

An unexpected Rejected, already registered result indicates either a duplicate within the file or a batch that has already been registered. Check both before resubmitting.

Accepted rows are minted immediately into custody. No STOKR approval is required. Large batches are split across multiple transactions automatically.

While the receivables are issued, the progress bar shows each step. If the network refuses a transaction for a passing reason (a busy network, for example), SPCR sends it again by itself, up to four times; the Issuing on chain step turns yellow and reads "Txn failed, resubmitting" meanwhile. A resubmission can never register a receivable twice: the registry refuses a Loan ID it already holds.

If a row reports that it was registered on chain but the record failed to save, do not retry. The certificate already exists. Contact STOKR, who can re-link it without minting again.

Creating a pool

From Register receivables, select Create pool:

  • Code. 3 to 41 characters: letters, digits and - _ / ., for example YOURCO-2026-P1.
  • Name. Free text for your own reference.
  • Passkey. See Pools and passkeys.
  • Pool represents. A whole asset or a tranche.

A pool's name can be changed on its page at any time. A pool with nothing registered in it can also be deleted there. Its code becomes free to use again 10 minutes after deletion; the code of a pool that ever held receivables stays reserved.

Tranches

A tranche is expressed as a prefix on the Loan ID, for example JUNIOR-YOURCO-2026-P1-L0001. The identifier is a hash of the Loan ID, so JUNIOR-X, SENIOR-X and X are treated as three distinct receivables by the chain and by the uniqueness check.

Each tranche is a separate pool, because a pool is sold to a single funder. The prefix does not need to appear in your loan tape: it is added automatically, and the rewritten identifiers are shown on screen before submission.

Use a different passkey for each tranche. If a passkey is shared, a funder holding the junior tranche's passkey can also verify the senior tranche.

After registering into a tranche pool, download the loan tape offered in the result panel and send it to the funder. It contains the prefixed identifiers and the passkey, allowing the whole tranche to be verified in one upload. Because it contains the passkey, send it only to the intended funder.

Sell a pool

Sell a whole pool to a funder as a single block.

  • Transfers are irreversible. A confirmed on-chain batch cannot be undone.
  • You may be asked to re-enter your password if you have not signed in recently.
  • Large pools are processed in resumable batches. If a transfer partially fails, the screen reports the exact number of receivables transferred.

Once sold, a pool is locked. Receivables subsequently registered into a sold pool are minted directly to the funder's vault rather than into custody, so the pool remains held by one funder. This supports roll-over facilities.

Issued receivables

All registered receivables, by pool, with their status and a link to each on-chain transaction. The holder reads as your own workspace while a receivable is in STOKR custody, and as the funder you sold it to once sold.