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
Prefer to explore in Postman? Import our collection — every merchant-facing endpoint, pre-configured with Basic Auth and example request bodies.
Download Postman collectionResources
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 | Decimal major units (e.g. 49.99 for $49.99). Sub-cent precision is rejected. |
| Currency codes | ISO 4217 three-letter codes, uppercase. |
| 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). |