SimpliFi
HomeContact Us
HomeContact Us
  1. Card
  • Introduction
  • SimpliFi Architecture
  • Webhooks
  • Auth
    • Login to generate JWT token
      POST
  • Card Program
    • Create Card Program
      POST
    • Get Card Program
      GET
    • Change Card Program Status
      PATCH
    • Link Funding Source to Card Program
      POST
    • Get Balance of Funding Source
      GET
    • Transfer funds from one Card Program to other
      POST
    • Raise Funding Document Upload
      POST
    • Raise Funding
      POST
    • Funding Source Statement
      GET
  • Funding Source
    • Create Rule Group on Funding Account
      POST
    • Update Rule Group on Funding Account
      PUT
    • Delete Rule Group on Funding Account
      DELETE
    • Get Rule Groups on Funding Account
      GET
    • Appply Rule Group on Funding Account
      POST
    • Remove Rule Group on Funding Account
      DELETE
  • Card
    • List all Cards
      GET
    • Create a Card
      POST
    • Get Card Details
      GET
    • Retrieve Balance on the Card
      GET
    • Activate a Card
      POST
    • Manage Card Status
      POST
    • Load a Card
      POST
    • Unload a Card
      POST
    • Renewal of the Card
      POST
    • Request a Physical Card
      POST
    • Get Card Statement
      GET
    • Apply rule group on card
      POST
    • Remove rule group on card
      DELETE
  • User
    • List all Users
    • Create a User
    • Upload Document
    • Retrieve a User
    • Update a User
    • Delete a User
  • Transaction
    • List All Transactions
  • Fee
    • Add fee configuration
    • Fetch fee config
    • Change the status of fee config
    • Add Fee event against card uuid in queue
    • Apply fee against card uuid present in queue
  • Webhook
    • Get all events
    • Create a webhook
    • Update a Webhook
    • Delete a Webhook
    • Updates the status of Webhook
  1. Card

Manage Card Status

POST
https://{{env}}-lb.simplifipay.com/v1/card/{uuid}/status
Card
The Manage Card Status endpoint manages the status of a card. This endpoint is helpful as
cards can be locked (temporarily suspended), disabled, reissued depending upon the
business requirements. Following are the properties of this endpoint.
Request Request Example
Shell
JavaScript
Java
Swift
curl --location -g --request POST 'https://uat-lb.simplifipay.com/v1/card//status' \
--header 'requestUuid;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "status": "LOCKED",
    "reason": "ALL_GOOD"
}'
Response Response Example
{
    "errorCode": "99997",
    "message": "General Error"
}

Request

Authorization
JWT
Add the parameter
Authorization
to Headers
Example:
Authorization: ********************
or
Path Params
uuid
string 
required
This field contains a unique identifier of the card.
Header Params
requestUuid
string 
required
A unique id is required to be passed as part of the header whenever a SimpliFi API is called from your
system. This would help us in debugging in case of a discrepancy in the expected behavior of the API.
Example:
00d366f2-a6e9-4714-b172-02c4e58c29d8
Body Params application/json
status
enum<string> 
required
This field contains the status of the card.
Allowed values:
LOCKEDDISABLEDACTIVATED
Example:
LOCKED
reason
enum<string> 
required
This field specifies the reason for changing the card status.
Allowed values:
ALL_GOODSTOLENLOSTFRAUDULENCESECURITY_VIOLATIONRESTRICTEDVOIDED
Example:
STOLEN
Examples

Responses

🟢200OK
OK
This response does not have a body.
🟠400Bad Request
🟠401Unauthorized
Modified at 2025-06-27 12:44:57
Previous
Activate a Card
Next
Load a Card
Built with