Set Up Payment Processing
Configure your WickiePay account to start accepting merchant payments.
Prerequisites
Before processing payments, ensure you have completed:
- Account Creation — Tenant account with KYB verification
- API Authentication — RSA key pair registered
- Asset Pool — At least one pool for settlement
Configuration Steps
1. Create a Merchant Account
Each merchant needs a merchantId. See Merchant Account Setup.
2. Configure Settlement
In the WickiePay Portal, navigate to Merchant Settings and configure:
| Setting | Description |
|---|---|
| Settlement Currency | Which currency to settle in (EUR, USD, USDT, etc.) |
| Settlement Pool | Which asset pool receives settled funds |
| Auto-Conversion | Automatically convert to settlement currency |
3. Set Up Webhook Endpoints
Register endpoints to receive payment notifications:
POST /api/v1/hook/destination
{
"url": "https://yourserver.com/webhooks/payments",
"events": ["payment.*", "channel.payment.*"]
}
4. Configure Branding
Customize the Hosted Payment Page (HPP) with your merchant branding:
- Logo — Displayed on the payment page
- Display Name — Shown to customers
- Return URL — Where customers go after payment
5. Choose Integration Method
| Method | Best For | Effort |
|---|---|---|
| Hosted Checkout (HPP) | Quick start, standard checkout | Minimal |
| Direct API | Custom payment experience | Moderate |
| Payment Channels | Recurring deposits, top-ups | Minimal |
Test in Sandbox
Before going live, test your integration in the Sandbox Environment.
Go Live Checklist
- KYB verification complete
- Production API keys generated
- Webhook endpoints configured and tested
- Settlement currency and pool configured
- Payment flow tested end-to-end in sandbox
- Error handling implemented
- Compliance screening configured
Next Steps
- Accept Payments — Payment In flow
- Send Payouts — Payment Out flow
- Hosted Checkout — HPP integration