Channels
Payment channels connect Dimebia to external payment providers. This guide covers configuring and managing payment channels.
Overview
A payment channel represents a connection to an external payment service provider (PSP) such as Stripe, PayPal, or a bank. Channels determine how payments are processed and settled.
Supported Channels
| Channel | Type | Description |
|---|---|---|
| Stripe | Online | Credit/debit cards, Apple Pay, Google Pay |
| PayPal | Online | PayPal wallet payments |
| Bank Transfer | Offline | Wire transfers, ACH, SEPA |
| Alipay | Online | Chinese payment method |
| WeChat Pay | Online | Chinese payment method |
| Credit Card | Direct | Direct credit card processing |
Configure a Channel
POST /api/channel/modify
Request Body
| Field | Type | Required | Description |
|---|---|---|---|
id | Long | No | Channel ID (omit for new channel) |
name | String | Yes | Channel name |
code | String | Yes | Unique channel code |
type | String | Yes | ONLINE or OFFLINE |
currency | String | Yes | Supported currency codes |
country | String | Yes | Country code (ISO 3166-1 alpha-2) |
apiKey | String | No | API key for the provider |
apiSecret | String | No | API secret for the provider |
webhookSecret | String | No | Webhook verification secret |
state | Boolean | Yes | Active/inactive |
Example
curl -X POST http://localhost:8080/api/channel/modify \
-H "Content-Type: application/json" \
-H "Authorization: Bearer <YOUR_TOKEN>" \
-d '{
"name": "Stripe Production",
"code": "stripe_prod",
"type": "ONLINE",
"currency": "USD,EUR,GBP",
"country": "US",
"apiKey": "sk_live_...",
"apiSecret": "whsec_...",
"state": true
}'
List Channels
GET /api/channel/list
Channel Routing
Dimebia supports automatic channel routing based on:
- Currency: Route to channels that support the transaction currency
- Country: Route to channels available in the customer's country
- Amount: Route high-value transactions to specific channels
- Availability: Automatically failover to backup channels
Best Practices
- Test Mode: Always configure test/sandbox channels before production
- Webhooks: Configure webhook endpoints for real-time status updates
- Monitoring: Set up alerts for channel failures and high latency
- Fallback: Configure at least one backup channel for critical payment flows