Sign in
Debit Cards

Update card

Updates card details, such as PIN reset or to lock a lost card.

post/debit-cards/{id}

Request

  • Base URL: https://apigateway.jpmorgan.com/tsapi/ef/v1
  • URL: https://apigateway.jpmorgan.com/tsapi/ef/v1/debit-cards/{id}
  • Auth: none declared

Path parameters

idstring required

Unique identifier for the debit card.

Headers

tokenstring

JWT Client token

Request body

pinstring

4 digit ATM pin to be used for associated card. Optional field. Only include if setting a new PIN.

status'LOCKED' | 'UNLOCKED' | 'REPLACED' | 'CANCELLED'

New status of the card after request. Can be locked/unlocked/replaced/cancelled status. Optional field. Only use if you want to update the status of the card.

replacementReason'LOST' | 'STOLEN' | 'DAMAGED' | 'DEFECTIVE'

Reason for replacing card. Only required if status is set to REPLACED.

cancellingReason'LOST' | 'STOLEN' | 'DEACTIVE'

Reason for cancelling card. Only required if status is set to CANCELLED.

maxSpendLimitnumber

The maximum total amount that can be spent in a single day. Resets at 00:00 each day.

maxCashWithdrawalLimitnumber

The total amount of cash that can be withdrawn in a single day. Resets at 00:00 each day.

clearSpendLimitboolean

Clears spending limits on this card. Set value to TRUE to remove any daily spending limits. If set to TRUE, any maxSpendLimit limit is ignored. You can still apply daily cash withdrawal limits even when clearSpendLimit is set to TRUE.

clearCashWithdrawalLimitboolean

Clears daily cashwithdrawal limits on this card. Set value to TRUE to remove any daily cashwithdrawal limits. If set to TRUE, any maxCashWithdrawalLimit limit is ignored. You can still apply daily spend limits even when clearCashWithdrawalLimit is set to TRUE.

Example request

{
  "maxSpendLimit": 100,
  "maxCashWithdrawalLimit": 100,
  "clearSpendLimit": true,
  "clearCashWithdrawalLimit": true
}

Response

Ok.

messagestring

Message for operation status.

idstring

New Card Identifier to Update

Example response

{
  "message": "New pin set successfully",
  "id": "100000160987"
}

Changes

No recorded changes to this operation across all 1 revision of this API.