API reference

The merchant API, generated from openapi.yaml. Version 2026-09-01.

Basics

Every request goes to https://api.lemak.cash over HTTPS. Every /v1 request carries your secret key as Authorization: Bearer sk_test_... or sk_live_.... A test key reaches only test data.

Send Api-Version to choose the version that answers one request. Without it, the version your account is pinned to answers. The changelog lists every version.

Every write takes an Idempotency-Key. A retry with the same key and the same body replays the first answer.

Errors

Every error answers with this object. code is stable and is the field to branch on. message is for a person and can change.

ErrorEnvelope

FieldTypeDescription
error requiredError
Fields of error
FieldTypeDescription
type requiredstringOne of invalid_request_error, authentication_error, idempotency_error, rate_limit_error, api_error.
code requiredstring
message requiredstring
param optionalstring
request_id optionalstring

Resources

Payment intents

Disputes

Settlements

Balance

FX quotes

Events

Webhook public keys

Hosted checkout