Guides
Disclose and verify a receipt
Copy a link to one payment, send it, and check it against the chain on the Verify page.
A receipt shows one payment to one person: an accountant, a counterparty, a customer asking what they were charged for. The person who receives it reads that payment and nothing else, and needs no wallet.
Disclose a payment
Find the payment
An owner opens the remit's page from the app and finds the payment in the statement. A payee opens Earn and finds it under Settled payments.
Press Disclose
The button is in the payment's Receipt column. It copies a link and reads Link copied.
Send the link
Paste it into a message to the person who should see the payment. Whoever opens the link reads that payment, so send it as you would send the document itself.
The link opens Verify with the receipt in it. The receipt sits after the # of the link, which a browser does not send to the server when it loads the page.
Verify a receipt
Open the link
The check starts by itself. To check a receipt you were sent as text, open Verify, paste it under Receipt and press Verify.
Read the result
"Verified against the chain" means every value below was checked against the payment's transaction on Solana.
| Field | What it tells you |
|---|---|
| Status | held, settled or refunded. |
| Payee | Who was paid, with its name if it is in the directory. |
| Paid by the remit of | The owner whose remit paid. |
| Paid | When. |
| Settled | When the payee settled, once it has. |
| Request hash | The hash of the request that was paid for. |
| Response hash | The hash of the response the payee returned, once settled. |
| Pay transaction, Settle transaction | The two signatures, to open in any explorer. |
| On chain | The slot the status was read at. |
The amount and its mint head the result. Each hash and signature copies on a click.
When it does not verify
| Result | Meaning |
|---|---|
| "Not found" | The chain has no Remit payment with this receipt's signature. Check that the whole receipt was pasted and that it was made on this network. |
| "The receipt does not match" | The transaction exists, and what the receipt says about it is not what the chain holds. Nothing about the payment can be confirmed from it. |
| "Not checked" | The check could not run. Press Try again. |
Matching a receipt to the request and the response
The receipt holds two hashes. If you also have the request and the response, compute the same hashes and compare:
import { computeRequestHash, sha256Hex } from '@remit/sdk'
const requestHash = computeRequestHash('GET', 'https://api.example.com/quote?pair=SOL-USDC')
const responseHash = sha256Hex('<the response body, byte for byte>')Equal hashes mean the receipt is for that exact request and that exact response.
With the SDK
import { createOwner, verifyReceipt } from '@remit/sdk'
const owner = createOwner({ keys: process.env.OWNER_SECRET_KEY! })
const { receipt } = await owner.disclose('<pay signature>')
const checked = await verifyReceipt(receipt)
console.log(checked.status, checked.payee, checked.amount, checked.requestHash, checked.responseHash)disclose works for the owner of the remit and for the payee of the payment. verifyReceipt takes no keys.