API reference
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.
Postman collection
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). |
| Error envelope | { code, message, details } — see Errors. |