Merchant docs
Start here to integrate and operate with Alpha DigiWallet.
Everything merchant teams need is reachable from this docs hub: onboarding, staging tests, payment API integration, webhook handling, settlement and payout operations, security rules, and production cutover.
Merchant setup
Accounts, KYB, staging, production, and responsibilities.
OpenTwo-factor authentication
Set up 2FA, save backup codes, and approve sensitive actions.
OpenAPI integration
Create payments, send buyers to checkout, and read status.
OpenWebhooks
Signed events, encryption, retries, and testing.
OpenSandbox testing
Use Test Shop and Test Center before live traffic.
OpenMoney movement
Refunds, settlements, payouts, ledgers, and disputes.
OpenSecurity model
API keys, checkout boundaries, idempotency, and environments.
OpenGo-live checklist
Production cutover steps and operational readiness.
OpenMerchant functionality guide
Legacy single-page map of portal capabilities. Kept for compatibility while the /docs hub becomes the primary entry point.
OpenQuick path
Recommended path for a new merchant
Get staging access
Alpha provisions a staging merchant account so your team can test without production data or live money movement.
Build API integration
Create payments from your server, redirect buyers to hosted checkout, and verify webhook signatures.
Rehearse operations
Use Test Shop and Test Center to exercise checkout, webhooks, refunds, settlements, chargebacks, and payout dry-runs.
Cut over to production
Upload KYB in production, create live keys and webhooks, confirm pricing/reserves, then run one low-value live transaction.
Hosts
Environment map
| Environment | Portal | API | Checkout | Purpose |
|---|---|---|---|---|
| Test | https://test.alphadigiwallet.com | https://test-api.alphadigiwallet.com | https://checkout-test.alphadigiwallet.com | Shared sandbox and automated E2E target. |
| Staging | https://staging.alphadigiwallet.com | https://staging-api.alphadigiwallet.com | https://checkout-staging.alphadigiwallet.com | Merchant pilot and integration rehearsal. |
| Production | https://app.alphadigiwallet.com | https://api.alphadigiwallet.com | https://checkout.alphadigiwallet.com | Live merchant operations after approval. |
OpenAPI
Public API surface
The machine-readable OpenAPI contract is intentionally narrow. Merchant secret API keys currently create and read payments only. Other actions, such as refunds, webhooks, payouts, settlement views, KYB, and support, are handled from the merchant dashboard.
| Method | Path | Use | Scope |
|---|---|---|---|
| POST | /payments | Create a hosted checkout payment | payments:create |
| GET | /payments | List payments | payments:read |
| GET | /payments/{id} | Get a payment | payments:read |
| GET | /checkout/{token} | Read hosted checkout state | public |