This walk-through uses the sandbox. No real money moves.
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_.
The key is shown once. Payve stores only a hash of it and cannot show it again. If you lose it, revoke it and create a new one.
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 payout.successful or payout.failed to your endpoint. In the sandbox this takes about five seconds.
Verify the signature, record the event 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.