Post-purchase
The purchase is only the first step. After it, you ship and capture, you handle returns, and you match the payout against your books. These three APIs cover the rest of the order's life, and they work the same way no matter which Walley product created it.
📦 Management API
Act on an order once it exists. Capture what you ship, refund what comes back, change it before it leaves the warehouse, and read its current state whenever you need to.
💰 Settlements
Get the payout report that explains what Walley paid you and why. Fetch it with the Reports API or download it from Merchant Hub.
🔔 Webhooks
Let Walley call your system when something changes: an order is updated, an authorization comes through, a settlement is ready.
Common tasks
The scenarios most merchants build first, walked through end to end.
✏️ Change an order
Adjust items or amount before anything is captured.
🚚 Deliver an order
Capture on shipment, in full or in parts.
↩️ Refund a return
Give money back, in full or per item.
🧾 Reconcile a payout
Find a settlement and read the transactions on it.
How the pieces fit together
- A payment is created, by Walley Checkout, Pay Link, a token charge or the Payments API.
- Your system acts on the order through the Management API. Capture is what triggers the payout.
- Webhooks tell you when the order changes, including changes made in Merchant Hub or by Walley.
- Captures, returns and fees land on a settlement that you reconcile against your ledger.
Before you integrate
- Both APIs use OAuth2 client credentials. Create the API key in Merchant Hub, then read Management API authentication or Reports API authentication.
- Point at the test environment first. See Management API endpoints and Reports API endpoints.
- Webhook URLs are registered in Merchant Hub, not through an API.
- Changes are applied asynchronously. Read Asynchronous operations before you build retries, and Order lifecycle to know which actions an order accepts.
Getting access
Your organization needs access to these services before you can create an API key. Contact Merchant Services to get set up.