API Reference

Complete documentation for the mCards Developer Platform API v2. All endpoints require authentication via HMAC-SHA256 or OAuth2 Bearer token unless noted otherwise.

Base URL: https://api.mcards.com

Partner

Partner profile, API keys, and role management

GET/api/v2/partner/profileGet partner profile GET/api/v2/partner/api_keysList API keys GET/api/v2/partner/rolesList partner roles

OAuth

OAuth2 client credentials flow and application management

POST/api/v2/oauth/tokenExchange credentials for access token POST/api/v2/oauth/revokeRevoke an access token GET/api/v2/oauth/token_infoIntrospect current token GET/api/v2/oauth/scopesList available API scopes GET/api/v2/oauth/rate_limitGet rate limit status GET/api/v2/oauth/applicationsList OAuth applications POST/api/v2/oauth/applicationsCreate OAuth application GET/api/v2/oauth/applications/{uuid}Get application details DELETE/api/v2/oauth/applications/{uuid}Revoke application

Wallets

Wallet (card program) management

GET/api/v2/walletsList wallets GET/api/v2/wallets/{uuid}Get wallet details PUT/api/v2/wallets/{uuid}Update wallet

Cards

Card issuing, activation, and lifecycle management

GET/api/v2/cardsList cards POST/api/v2/cardsIssue a new card GET/api/v2/cards/{uuid}Get card details PUT/api/v2/cards/{uuid}/activateActivate a card PUT/api/v2/cards/{uuid}/deactivateDeactivate a card GET/api/v2/cards/{uuid}/balanceGet card balance

Transactions

Transaction querying and filtering

GET/api/v2/transactionsList transactions GET/api/v2/transactions/{uuid}Get transaction details

Cardholders

Cardholder management and KYC

GET/api/v2/cardholdersList cardholders POST/api/v2/cardholdersCreate cardholder GET/api/v2/cardholders/{uuid}Get cardholder details PUT/api/v2/cardholders/{uuid}Update cardholder

Programs

Card program configuration

GET/api/v2/programsList programs GET/api/v2/programs/{uuid}Get program details

Rewards

Reward currency management

GET/api/v2/rewardsList reward currencies GET/api/v2/rewards/{uuid}Get reward details

Offers

Offer and campaign management

GET/api/v2/offersList offers GET/api/v2/offers/{uuid}Get offer details

Webhooks

Webhook registration, testing, and log inspection

GET/api/v2/webhooksList webhooks POST/api/v2/webhooksRegister a webhook GET/api/v2/webhooks/{uuid}Get webhook details PUT/api/v2/webhooks/{uuid}Update webhook DELETE/api/v2/webhooks/{uuid}Delete webhook POST/api/v2/webhooks/{uuid}/testTest webhook GET/api/v2/webhooks/{uuid}/logsGet delivery logs

Payments

Payment gateway and account management

GET/api/v2/payments/gatewaysList payment gateways GET/api/v2/payments/accountsList payment accounts

Branding

Card design and branding customization

GET/api/v2/branding/designsList card designs GET/api/v2/branding/designs/{uuid}Get design details

Analytics

Usage metrics, transaction analytics, and card statistics

GET/api/v2/analytics/overviewGet analytics overview GET/api/v2/analytics/transactionsTransaction analytics GET/api/v2/analytics/cardsCard statistics

Sandbox

Sandbox environment simulation endpoints

GET/api/v2/sandboxGet sandbox environment info POST/api/v2/sandbox/transactions/authorizeSimulate authorization POST/api/v2/sandbox/transactions/settleSimulate settlement POST/api/v2/sandbox/transactions/refundSimulate refund POST/api/v2/sandbox/transactions/declineSimulate decline