Concepts
Standing
A payee's standing is the count of payments it settled and payments refunded from it, kept by the program.
Standing is what the directory shows about a payee's record: how many payments it has settled, how many holds went back to their owners unsettled, and when it first settled one. The Remit program keeps the counts itself, in the payee's record on chain, and changes them only inside settle and refund.
What is counted
| Field | Type | Meaning |
|---|---|---|
settled | u64 | Goes up by one each time the payee settles a hold. |
refunded | u64 | Goes up by one each time a hold for the payee passes its deadline and is refunded. |
firstSettledAt | unix seconds | The cluster time of the payee's first settlement. Zero until then. |
A settlement counts once, when the payee takes a hold with a valid proof. Each one moved real money from a remit to the payee and paid the protocol fee, so a count cannot be raised without paying for it.
A refund counts once, when a hold for the payee goes back to its owner after the deadline. It means an agent paid and the payee did not settle in time.
Standing holds counts, never amounts. What each payment was worth stays private to the owner and the payee.
Where the counts live
Each registered payee has one record: a program account at the address derived from the seeds "payee" and the payee's wallet. It holds the directory fields the payee wrote (name, URL, description, price hint, mint) and the three standing fields, which only the program writes.
register_payeecreates the record with both counts at zero.update_payeerewrites the directory fields and leaves the standing as it is.settleandrefundchange the counts. No other instruction does, and the payee cannot write them.
Payments to an address with no record still work, and they are not counted. Standing starts when the payee registers.
Reading standing
The directory at /directory lists every registered payee with its counts and its first settled date, and a payee's own page shows the counts per UTC day.
The same figures come from the API:
| Call | Returns |
|---|---|
GET /v1/payees | Every payee with settledCount, refundedCount, firstSettledAt and lastSettledAt. sort takes settled (most settled first, the default), reliability (fewest refunds first), recent or name. |
GET /v1/payees/:payee | One payee's record and counts. |
GET /v1/payees/:payee/standing?days=30 | The totals and one point per UTC day with that day's settled and refunded counts. days is 1 to 365. |
The record itself can be read from any Solana RPC node, without Remit's API: The program gives its layout.
Choosing payees by standing
An owner reads standing before putting a payee on a remit's list. A long settled count with few refunds, starting from an early first settled date, is a payee that has been paid by agents for a while and delivered. A payee's page in the directory gives the line to add it to a remit's payees.