Create E-Wallet Transaction

Creates an e-wallet payment request and returns a payment_url to redirect the customer to the channel's checkout page.

Endpoint

POST /api/v1/transaction/create

Headers

Header Type Required Description
Content-Type string Yes application/json
X-API-KEY string Yes API Key issued by Manjo

Request Body Parameters

Field Type Required Description
method int Yes Must be 2 (E-Wallet enum).
amount float Yes Transaction amount. Greater than 0, maximum 99999999.
expired_date string Optional Payment deadline. May be set at the root or in additional_info.
additional_info object Yes E-wallet-specific fields, see the table below.

additional_info Fields

Field Type Required Description
channel string Yes Channel code from the Channel List, e.g. DANA, OVOE, ESHP.
redirect_url string Yes URL the customer is sent to after finishing on the channel page.
customer_name string Optional Customer name.
account_email string Optional Customer email. Alias: email. If both are present, account_email is used.
account_phone string Optional Customer phone number, 10–15 digits. Alias: phone.
currency string Optional ISO 4217 currency code. Defaults to IDR.
callback_url string Optional Merchant webhook URL that receives the payment notification.
expired_date string Optional RFC 3339 with offset (e.g. 2026-12-31T23:59:59+07:00) or YYYY-MM-DD HH:mm:ss local time. Must be in the future.

Example Request

{
	"method": 2,
	"amount": 50000,
	"additional_info": {
		"channel": "DANA",
		"customer_name": "John Doe",
		"account_email": "johndoe@example.com",
		"account_phone": "081234567890",
		"currency": "IDR",
		"callback_url": "https://webhook.site/your-webhook-url",
		"redirect_url": "https://your-frontend.com/success",
		"expired_date": "2026-12-31T23:59:59+07:00"
	}
}

Example Response

HTTP 200 - Success

{
	"success": true,
	"message": "Transaction created successfully",
	"data": {
		"uid": "bc804633-9f79-4d58-ade9-fa566d8262df",
		"trx_id": "cmr1h08xk000342qq3fmnl5u1",
		"method": "EWallet",
		"status": "PENDING",
		"channel": "DANA",
		"channel_type": "EWALLET",
		"customer_name": "John Doe",
		"email": "johndoe@example.com",
		"phone": "081234567890",
		"merchant_name": "Ayoborong",
		"amount": 50000,
		"fee_amount": 0,
		"total_amount": 50000,
		"currency": "IDR",
		"external_ref_id": "EXTREF02202607010942441460",
		"payment_url": "https://pay.example.com/redirect/v2/payment?tXid=EXTREF02202607010942441460",
		"redirect_url": "https://your-frontend.com/success",
		"callback_url": "https://webhook.site/your-webhook-url",
		"trx_date": "2026-07-01T09:42:44+07:00",
		"expired_date": "2026-12-31T23:59:59+07:00",
		"created_at": "2026-07-01T09:42:44+07:00"
	},
	"timestamp": "2026-07-01T09:42:44+07:00"
}

Next Steps: Take the payment_url from the response and redirect the customer to that URL to complete the payment.

Note: fee_amount and total_amount follow the merchant account's fee and are frozen when the transaction is created; later fee changes do not affect transactions already in progress.


Error Responses

HTTP 400 - Bad Request

A required field is missing or invalid (e.g. empty channel/redirect_url, amount ≤ 0 or more than 8 digits, invalid email/phone, expired_date malformed or in the past):

{
	"success": false,
	"message": "redirect_url is required for e-wallet",
	"error": {
		"code": "BAD_REQUEST"
	},
	"timestamp": "2026-07-01T09:42:44+07:00"
}

HTTP 401 - Unauthorized

X-API-KEY is missing or invalid:

{
	"success": false,
	"message": "invalid api key",
	"error": {
		"code": "UNAUTHORIZED"
	},
	"timestamp": "2026-07-01T09:42:44+07:00"
}

HTTP 403 - Forbidden

The account has no E-Wallet access, the channel is not enabled for the merchant, or there is no active E-Wallet IMID:

{
	"success": false,
	"message": "channel DANA is not enabled for this merchant",
	"error": {
		"code": "FORBIDDEN"
	},
	"timestamp": "2026-07-01T09:42:44+07:00"
}

HTTP 503 - Service Unavailable

The fee cannot be determined at the moment. Retry the request:

{
	"success": false,
	"message": "unable to resolve fee, please retry",
	"timestamp": "2026-07-01T09:42:44+07:00"
}