LOMA Merchant API

LOMA provides a set of HTTP APIs for merchants to send LINE messages to bound customers, check delivery status, and check a customer's LINE binding status.

• Base URL: https://loma-dev.acorners.com/api/v1/merchant
• Protocol: HTTPS, Content-Type: application/json
• Auth: each request carries X-Api-Key + X-Api-Secret (see Authentication)

Capabilities

Capability	Endpoint
Send a message (notification / OTP delivery)	POST /message/send
Get message delivery status	GET /message/{messageRequestId}
Get customer LINE binding status	GET /customer/{customerExternalId}/line-binding

Unified response envelope

Every response uses this envelope:

{
  "code": "OK",
  "message": "Success",
  "requestId": "req_...",
  "data": { }
}

• Success: HTTP 200, code = "OK".
• Failure: HTTP 4xx/5xx, code is a machine-readable error code (see Errors), data may be null.

About customer binding

LOMA identifies a customer by customerExternalId (the customer ID in your system). Before sending, the customer must be bound to a LINE user and still be a friend of the Official Account, otherwise you get CUSTOMER_NOT_BOUND / CUSTOMER_UNFOLLOWED. Use Binding status to check first.

About OTP

LOMA only delivers. OTP generation, expiry and verification stay on your side — just send the code you generated as the message content via POST /message/send (category=OTP).