CVS (Convenience Store)
Integration guide for the Manjo Gate Convenience Store module. Customers pay in cash at a minimarket cashier using a payment code (pay_no) issued by Gate.
Overview
CVS transactions are created through the unified transaction/create endpoint with method: 8. Gate issues a payment code for the selected store (mitra). There is no payment_url: you display the pay_no to the customer, who pays it at the cashier before expired_date. Once paid, 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 |
Issue a CVS payment code. |
| Mitra List | GET /api/v1/cvs/mitras |
List of stores (mitra) with their amount limits. |
| Payment Callback | POST {your_callback_url} |
Real-time notification from Gate after the code is paid. |
Payment Workflow
- Select a mitra: Get the
codeand amount limits from the Mitra List. - Create the transaction: Your backend sends
POST /api/v1/transaction/createwithmethod: 8andmitra_code. - Show the code: Take
pay_noandexpired_datefrom the response and display them to the customer. - Customer pays: The customer gives the
pay_noto the store cashier and pays in cash. - 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: 8is Convenience Store. - Currency:
IDRonly. - Amount: a whole number (no decimals) within the range of the selected mitra.
- Validity period: defaults to 24 hours (1440 minutes) if
expired_dateis omitted. - IMID: The merchant account must have an active CVS IMID; otherwise Gate rejects the request with
422. Contact Manjo for activation. - Idempotency: Callbacks may be re-sent. Handle the same
trx_ididempotently.