curl -X PATCH https://services-staging.getplu.com/api/v1/partner/card \
-H "Authorization: Bearer sk_staging_your_api_key" \
-H "Content-Type: application/json" \
-d '{
"serviceCardId": "acme-card-xyz789jkl012mno",
"status": "freeze"
}'
const response = await fetch(
'https://services-staging.getplu.com/api/v1/partner/card',
{
method: 'PATCH',
headers: {
'Authorization': 'Bearer sk_staging_your_api_key',
'Content-Type': 'application/json',
},
body: JSON.stringify({
serviceCardId: 'acme-card-xyz789jkl012mno',
status: 'freeze',
}),
}
);
{
"status": "success",
"message": "Card status updated",
"data": {
"serviceCardId": "acme-card-xyz789jkl012mno",
"status": "frozen"
}
}
{
"status": "success",
"message": "Card status updated",
"data": {
"serviceCardId": "acme-card-xyz789jkl012mno",
"status": "active"
}
}
{
"status": "error",
"message": "CARD_ALREADY_FROZEN",
"data": {
"error": "Card is already frozen"
}
}
{
"status": "error",
"message": "CARD_IS_ACTIVE",
"data": {
"error": "Card is already active"
}
}
{
"status": "error",
"message": "CARD_ALREADY_TERMINATED",
"data": {
"error": "Cannot modify a terminated card"
}
}
Cards
Switch Card Status
Freeze or unfreeze a card
PATCH
/
v1
/
partner
/
card
curl -X PATCH https://services-staging.getplu.com/api/v1/partner/card \
-H "Authorization: Bearer sk_staging_your_api_key" \
-H "Content-Type: application/json" \
-d '{
"serviceCardId": "acme-card-xyz789jkl012mno",
"status": "freeze"
}'
const response = await fetch(
'https://services-staging.getplu.com/api/v1/partner/card',
{
method: 'PATCH',
headers: {
'Authorization': 'Bearer sk_staging_your_api_key',
'Content-Type': 'application/json',
},
body: JSON.stringify({
serviceCardId: 'acme-card-xyz789jkl012mno',
status: 'freeze',
}),
}
);
{
"status": "success",
"message": "Card status updated",
"data": {
"serviceCardId": "acme-card-xyz789jkl012mno",
"status": "frozen"
}
}
{
"status": "success",
"message": "Card status updated",
"data": {
"serviceCardId": "acme-card-xyz789jkl012mno",
"status": "active"
}
}
{
"status": "error",
"message": "CARD_ALREADY_FROZEN",
"data": {
"error": "Card is already frozen"
}
}
{
"status": "error",
"message": "CARD_IS_ACTIVE",
"data": {
"error": "Card is already active"
}
}
{
"status": "error",
"message": "CARD_ALREADY_TERMINATED",
"data": {
"error": "Cannot modify a terminated card"
}
}
Freezes or unfreezes a card. Frozen cards cannot be used for transactions until unfrozen.
string
required
Bearer token. Example:
Bearer sk_staging_your_api_keystring
required
The card’s service ID.
string
required
Target status. Either
freeze or unfreeze.curl -X PATCH https://services-staging.getplu.com/api/v1/partner/card \
-H "Authorization: Bearer sk_staging_your_api_key" \
-H "Content-Type: application/json" \
-d '{
"serviceCardId": "acme-card-xyz789jkl012mno",
"status": "freeze"
}'
const response = await fetch(
'https://services-staging.getplu.com/api/v1/partner/card',
{
method: 'PATCH',
headers: {
'Authorization': 'Bearer sk_staging_your_api_key',
'Content-Type': 'application/json',
},
body: JSON.stringify({
serviceCardId: 'acme-card-xyz789jkl012mno',
status: 'freeze',
}),
}
);
{
"status": "success",
"message": "Card status updated",
"data": {
"serviceCardId": "acme-card-xyz789jkl012mno",
"status": "frozen"
}
}
{
"status": "success",
"message": "Card status updated",
"data": {
"serviceCardId": "acme-card-xyz789jkl012mno",
"status": "active"
}
}
{
"status": "error",
"message": "CARD_ALREADY_FROZEN",
"data": {
"error": "Card is already frozen"
}
}
{
"status": "error",
"message": "CARD_IS_ACTIVE",
"data": {
"error": "Card is already active"
}
}
{
"status": "error",
"message": "CARD_ALREADY_TERMINATED",
"data": {
"error": "Cannot modify a terminated card"
}
}
Terminated cards cannot be frozen or unfrozen. If a card has been terminated, it is permanently deactivated.
⌘I