Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.platnova.com/llms.txt

Use this file to discover all available pages before exploring further.

Manage your cards effectively with freeze, unfreeze, and status controls. These features help you maintain security and control over card usage.

​
Freezing Cards

Freeze a card to temporarily disable it. Frozen cards cannot be used for purchases until they are unfrozen.

​
When to Freeze a Card

  • Suspected unauthorized activity
  • Employee termination or leave
  • Lost or stolen card reports
  • Temporary spending restrictions needed

​
Freezing a Card

curl -X PUT https://api.platnova.com/v1/cards/{card_id}/freeze \
  -H "X-API-KEY: YOUR_API_KEY"
The card status will change to “frozen” and all attempts to use it will be declined.

​
Unfreezing Cards

Unfreeze a card to restore its functionality. The card can be used immediately after unfreezing.

​
Unfreezing a Card

curl -X PUT https://api.platnova.com/v1/cards/{card_id}/unfreeze \
  -H "X-API-KEY: YOUR_API_KEY"
The card status will change back to “active” and normal usage can resume.

​
Checking Card Status

Retrieve the current status of a card: 
curl -X GET https://api.platnova.com/v1/cards/{card_id} \
  -H "X-API-KEY: YOUR_API_KEY"

​
Card Statuses

  • active - Card is active and can be used
  • frozen - Card is frozen and cannot be used
  • cancelled - Card has been cancelled permanently

​
Card Information

View complete card details including masked card number, expiration date, and balance: 
curl -X GET https://api.platnova.com/v1/cards/{card_id} \
  -H "X-API-KEY: YOUR_API_KEY"

​
Revealing Card Details

For security, card numbers and CVVs are masked by default. Use the reveal endpoint to get the full card details: 
curl -X GET https://api.platnova.com/v1/cards/{card_id}/reveal \
  -H "X-API-KEY: YOUR_API_KEY"
Note: The reveal endpoint is rate-limited to prevent abuse. Use it only when necessary.

​
Best Practices

  • Freeze cards immediately if suspicious activity is detected
  • Regularly review card status and balances
  • Use unfreeze only when you’re certain the card should be active
  • Keep card details secure and never expose CVVs unnecessarily

​
Next Steps