E-Wallet
Integration guide for the Manjo Gate E-Wallet module. With this module, merchants can accept payments from digital wallets (DANA, OVO, LinkAja, ShopeePay, Astrapay) and receive payment status notifications asynchronously.
Overview
E-wallet transactions are created through the unified transaction/create endpoint with method: 2. Gate registers the payment with the payment network, then returns a payment_url — the channel's checkout page — where the customer is redirected to pay. Once the payment is complete, Gate sends an HTTP POST to your callback_url.
Authentication
Use an API Key on every server-to-server request.
| Header | Value | Required | Description |
|---|---|---|---|
X-API-KEY |
<your_api_key> |
Yes | API Key issued by Manjo |
Content-Type |
application/json |
Yes | Request payload format |
X-API-KEY: <your_api_key>
Content-Type: application/json
Endpoints
| Page | Path | Purpose |
|---|---|---|
| Create Transaction | POST /api/v1/transaction/create |
Create an e-wallet payment and get a payment_url. |
| Channel List | GET /api/v1/ewallet/channel-list |
List of available channels (digital wallet brands). |
| Payment Callback | POST {your_callback_url} |
Real-time notification from Gate after the payment completes. |
Payment Workflow
- Select a channel: Get the
channel_codefrom the Channel List. - Create the transaction: Your backend sends
POST /api/v1/transaction/createwithmethod: 2. - Redirect the customer: Take the
payment_urlfrom the response and redirect the customer to that page. - Customer pays: The customer completes the payment in the e-wallet app / page.
- Redirect back: After completion, the customer is returned to your
redirect_url. - Webhook: Gate sends a notification to your
callback_url. - Fulfill the order: Your server verifies the
trx_idand fulfills the order.
Notes
- Payment Method Enum:
method: 2is E-Wallet. - Channel:
channelis required and must exist in the channel list. A merchant can only use channels enabled for their account; otherwise Gate rejects the request with403. - Amount limit:
amountmust be greater than0and at most99,999,999. - IMID: The merchant account must have an active E-Wallet IMID. If not, Gate rejects the request with
403. Contact Manjo for activation. - Idempotency: Callbacks may be re-sent. Handle the same
trx_ididempotently.