Escrow Infrastructure API
Escrow infrastructurefor the modern web.
Build trust into your marketplace with WePay's robust API. Conditional contracts, KYC/KYB flows, and automated payouts! all in one escrow infrastructure.
# 1. Authenticate your application
curl -X POST "https://test-api.welink-sa.com/connect/token" \
-H "Content-Type: application/x-www-form-urlencoded" \
-d "grant_type=client_credentials" \
-d "client_id= YOUR_CLIENT_ID " \
-d "client_secret= YOUR_CLIENT_SECRET "
# 2. Create an escrow contract
curl -X POST "https://test-api.welink-sa.com/api/Contract" \
-H "Authorization: Bearer <access_token> " \
-H "Content-Type: application/json" \
-d '{"title":"Website Redesign","amount":5400}'
# 3. Redirect buyer to checkout
# Response includes a 10-min secure checkout URL ↓
➜ https://checkout.welink-sa.com/pay/<checkout_id>Core Integration Paths
Everything you need to ship
Four conceptual buckets — from first OAuth token to real-time webhook processing.
Auth & Identity
Secure your requests using OAuth 2.0 Client Credentials and manage user onboarding with integrated KYC via Nafath/Absher.
Read Auth Docs →Escrow Contracts
Create detailed B2B/B2C contracts. Define service types, set delivery milestones, and automatically calculate escrow fees and VAT.
Explore Contracts API →Checkout & Payment
Generate secure, 10-minute checkout URLs to redirect buyers. Handle Apple Pay, Mada, and STC Pay seamlessly out of the box.
View Checkout Flow →Real-Time Webhooks
Stop polling. Receive automated HTTP POST notifications for events like payment.completed, contract.released, and disputes.
Configure Webhooks →Developer Resources
Essential References
API Reference Data
Integration Support
📦 Changelog
v1.6.0Latest
- New workflow and refund
v1.5.0
- Unified refund API for full/partial refunds at contract and milestone level
v1.4.0
- User onboarding and release flow updates