💻
Docs
  • Introduction
  • VIRTUAL CARD
    • Page Integration
      • Quick Page Integration
      • Login-free Page Integration
      • About The Sign
      • Explanation of Return Codes
    • API Integration
      • Things Need To Know
      • About The Sign
      • API For Fetching Usable Card Segments
      • API For Retrieve Enumerations Of The States In The United States
      • API For Creating Virtual Card
      • API For Virtual Card Deposit (recharge)
      • API For Obtaining Card Details
      • API For Updating Virtual Card (update cardholder address)
      • API For Card Refund
      • API For Deleting Card
      • API For Querying Order History
      • Successful card opening callback
      • Fail card opening callback (COPY)
      • Risk Control webhook
      • Error Code
  • Physical card
    • Page Integration
      • Page customization
    • API Integration
      • Create Cardholder
      • Modify Cardholder Information
      • Cardholder Document Upload
      • Cardholder Query
      • Bank Card Application
      • Bank Card Application Result Query
      • Bank Card Activation
      • Bank Card Top-up
      • Bank Card Top-up Order Query
      • Bank Card Query
      • Bank Card Transaction Details Query
      • Bank Card Replacement
      • Bank Card Unloss
      • Bank Card Password Retrieval
      • Bank Card Authorized Transaction Details
      • Partner Account Balance Inquiry
      • Partner Top-up Account Information Inquiry
      • Cardholder Audit Result Notification
      • Bank Card Transaction Notification
  • KYC Sharing API
    • Integration Options
    • Signature Description
    • API
      • Submit basic information
      • Upload photo
      • Submit for approval
      • Query Approval Results
      • Approval Results[Webhook]
Powered by GitBook
On this page
  1. Physical card
  2. API Integration

Bank Card Replacement

POST Bank Card Replacement

POST /api/mastercard/changeCard.html

Replace a bank card. Note: After a successful card replacement, the old card will be frozen, and the new card will be automatically activated using the cardholder information from the old card. The balance from the old card will be transferred to the new card within 24 hours. During this period, please ensure the security of the card to prevent any user losses.

Request Body

{
  "cardId": "card123",
  "cardNo": "**** **** **** 1234",
  "cvv": "123",
  "oldCardId": "old_card123",
  "oldCardNo": "**** **** **** 5678",
  "randomStr": "abcdef1234567890"
}

Request Parameters

Name
Type
Required
Base64 Encoded
Description

cardId

string

false

none

cardId or cardNo must be filled in at least

cardNo

string

false

none

cardId or cardNo must be filled in at least

cvv

string

false

none

CVV will be validated if provided

oldCardId

string

true

none

Either oldCardId or oldCardNo must be filled in at least

oldCardNo

string

true

none

Either oldCardId or oldCardNo must be filled in at least

randomStr

string

true

none

32-digit random string

Example Response

200 Response

Last updated 1 year ago