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

  1. Select a mitra: Get the code and amount limits from the Mitra List.
  2. Create the transaction: Your backend sends POST /api/v1/transaction/create with method: 8 and mitra_code.
  3. Show the code: Take pay_no and expired_date from the response and display them to the customer.
  4. Customer pays: The customer gives the pay_no to the store cashier and pays in cash.
  5. Webhook: Gate sends a notification to your callback_url.
  6. Fulfill the order: Your server verifies the trx_id and fulfills the order.

Notes

  • Payment Method Enum: method: 8 is Convenience Store.
  • Currency: IDR only.
  • Amount: a whole number (no decimals) within the range of the selected mitra.
  • Validity period: defaults to 24 hours (1440 minutes) if expired_date is 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_id idempotently.