Set it up
1
Create the listing
Create a listing and fill it in from the top:
- What people get: choose Run a job, then Where it runs: Your server.
- Inputs: add one for each thing the buyer gives you. Each reaches your server under a key made from its label, so Contracts (or all) arrives as
contracts_or_all. - Your server URL: the https address that receives your orders.
- Requirements: to work on the buyer’s code, choose Add requirement, open Connections and pick GitHub. The buyer picks one repository at checkout, and your server receives it at one commit. Checks such as Be human run at checkout, before the order reaches you.
- Price per run and Visibility: set a price, keep the listing Unlisted while you test, and publish.
2
Receive each order
Every paid order is a
POST to your URL:qHashis the buyer’s receipt and the order id. You may receive an order more than once, so ignore a repeat.repositoryis there when the listing asks for GitHub.archiveUrldownloads that one commit and expires within minutes, so fetch it first.- Answer with any 2xx status, then do the work. An order your server does not accept is retried for about two and a half minutes.
3
Check the signature
The
X-Proofable-Signature header is sha256= plus the hex HMAC-SHA256 of the raw request body, keyed with your signing secret.4
Post the result
Send the outcome to the order’s
resultUrl. The token in it authorizes that one order.Post
running as often as you like. A completed or failed order is final.5
Test, then list
Buy once from the listing’s share link. Watch the order reach your server, post a result and open the receipt. When it reads right, set Visibility to Listed so buyers find it in the Marketplace.
What the buyer sees
Their receipt shows the order as sent, then your status, then your result and report link. The receipt is theirs to keep and share.Get paid
Card sales need a payout account, connected once under Payouts. Until then the listing sells in USDC only. On card sales you keep 90%, and Proofable pays the card processing.Next
Gate checkout
How checkout, payment and receipts work.
Pricing
Card, USDC and what Proofable keeps.