Freeze Card For V2

POST https://mybundlepay.com/ng/api/v2/virtual-card/freeze

KEY USAGE POLICY

Important: Use your test_secret_key for sandbox testing. Switch to live_secret_key only when you are ready to go live.

Test keys use sandbox endpoints for mock data.
Live keys connect directly to your MyBundlePay virtual card account.
Ensure your IP is whitelisted in your MyBundlePay Dashboard.

⚠️ Unauthorized IPs or live key misuse will be blocked automatically.

HEADERS

Authorization * string

Send your {secret_key} as a Bearer token.

Content-Type application/json

JSON format is required.

IP WHITELISTING

Only registered server IPs can call this endpoint. Update your IP list in your MyBundlePay Dashboard.

REQUEST BODY

Parameter	Required	Description
`cardId`	✅	Unique identifier of the virtual card to be frozen.

PHP
Node.JS


<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://mybundlepay.com/ng/api/v2/virtual-card/freeze',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_POSTFIELDS =>'{
    "cardId": "xxxxx-db81-4893-ae4b-xxxxxx"
  }',
  CURLOPT_HTTPHEADER => array(
    'Content-Type: application/json',
    'Authorization: Bearer {secret_key}'
  ),
));

$response = curl_exec($curl);
curl_close($curl);
echo $response;
?>


const axios = require('axios');

axios.post("https://mybundlepay.com/ng/api/v2/virtual-card/freeze", {
  cardId: "xxxxx-db81-4893-ae4b-xxxxxx"
}, {
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer {secret_key}"
  }
})
.then(res => console.log(res.data))
.catch(err => console.error(err.response ? err.response.data : err.message));

✅ Success Response (Test Mode)


{
    "status": "success",
    "message": "freeze card successfully",
    "data": {
        "card_id": "xxxxx-db81-4893-ae4b-xxxxxx",
        "card_balance": "200.00",
        "cardNumber": "4040385771027033",
        "cardName": "Johnkj Doesdd",
        "cardType": "virtual",
        "cardBrand": "VisaCard",
        "cvv2": "947",
        "card_expiry": "2028-10-30T00:00:00",
        "card_status": "frozen",
        "valid": "10/2028",
        "card_reference": "MBP-TEST-0001",
        "card_city": "Miami",
        "card_street": "3401 N. Miami, Ave. Ste 230",
        "card_country": "United States",
        "card_zipCode": "33127",
        "card_countryCode": "US"
    },
    "mode": "test"
}

❌ Error Response (Missing Parameter)


{
  "status": "failed",
  "message": "cardId is required.",
  "mode": "unknown"
}

❌ Error Response (Invalid Token)


{
  "status": "failed",
  "code": "INVALID_TOKEN",
  "message": "Invalid secret key provided.",
  "mode": "live"
}

❌ Error Response (Card Not Found)


{
  "status": "failed",
  "message": "Card ID does not exist.",
  "mode": "live"
}