Set it up
1
Create the listing
Create a listing, choose Run a job, then Where it runs: Your server, and paste the https URL that receives your orders.Add the inputs buyers fill in. To work on the buyer’s code, add Connections → GitHub, and the buyer picks one repository at checkout.Set a price and publish. Copy the signing secret the listing shows.
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.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.Next
Gate checkout
How checkout, payment and receipts work.
Pricing
Card, USDC and what Proofable keeps.