1
Create a sandbox key
Sign in to the dashboard and switch the environment toggle to Sandbox. Open Settings → API keys, select Create API key, give it a name and tick the
payouts:write scope.Copy the key when it appears. It starts with sk_test_.Put the key and the sandbox base URL in your environment. Environments explains the two base URLs.2
Add a webhook endpoint
In Settings → Webhooks, add the HTTPS URL of your server and choose All events. Copy the signing secret. It starts with
whsec_ and is also shown once.Your server must answer with a 2xx status. Verify signatures has working code.3
Quote the payout
A quote tells you the rate, the fee and what the recipient gets. It holds for five minutes by default.
Response · 201
4
Send the payout
Send the same currencies and amount, plus the
quoteId. Generate one Idempotency-Key for this payout and keep it. If the request times out, send it again with the same key.Response · 202
202 means Payve accepted the payout. It has not arrived yet.Your sandbox wallet needs a balance first. Fund it from the dashboard’s payment simulator. See Test in the sandbox.
5
Receive the webhook
When the payout finishes, Payve posts Verify the signature, record the event
payout.successful or payout.failed to your endpoint. In the sandbox this takes about five seconds.id so you process it once, and answer 200. Webhook event object shows every event in full.Next
Idempotency
The rules that stop a retry paying twice.
Going live
What changes when you move from sandbox to live.

