Hosted Checkout API
Hosted checkout is powered by merchant payment sessions and presents an EgaCard-branded payment experience with wallet, giftcard, and optional provider-funding options.
Implementation Note
- Use the merchant payment-session endpoint and render the resulting session in an EgaCard-hosted flow.
- Checkout pages should always show merchant identity, amount, fees, payment reason, and transaction reference before confirmation.
Endpoints
| Endpoint | Method | Auth | Headers | Notes |
|---|---|---|---|---|
Create checkout session/business/api/v1/public/payment-sessions/Create a hosted session for wallet, giftcard, or merchant settlement payment collection. |
POST | Merchant HMAC Authenticated caller |
X-EGACARD-API-KEY: <merchant-public-key>X-EGACARD-SIGNATURE: <hmac-signature>X-EGACARD-TIMESTAMP: <unix-timestamp>X-EGACARD-IDEMPOTENCY-KEY: <unique-request-key> |
Sandbox: Supported with sandbox keys and adapters. Production: Available subject to verification, country activation, and provider support. Rate limits: Standard authenticated rate limits |