API reference

REST endpoints for payments, subscriptions, refunds, and API key management. Every endpoint is interactive — fill in your test key and send real requests from the page.

The MintCash API follows REST conventions. All requests are JSON over HTTPS, authenticated with your API key, and every charge endpoint supports idempotency keys.

Base URL

Production: https://api.mintcash.me
Sandbox: https://sandbox.mintcash.me

Resources

Authentication

API keys, environments, IP allow lists.

Payments

Create and retrieve one-time charges.

Subscriptions

Recurring billing with retry logic built in.

Refunds

Full and partial refunds against captured payments.

API keys

List the keys currently active on your account.

Conventions

Convention	Detail
Amounts	Integers in the smallest currency unit (e.g. cents for USD). Responses also expose major units.
Currency codes	ISO 4217 three-letter codes, uppercase (`USD`, `EUR`, `GBP`).
Timestamps	ISO 8601 UTC strings (`2026-05-13T14:32:08.412Z`).
Idempotency	Send the same `externalId` on retries — we'll return the original resource and never double-charge.
Error envelope	`{ code, message, details: { requestId, ... } }` — see Errors.
Pagination	Cursor-based on list endpoints. Not yet exposed in v1 (single merchant scope).