Renew virtual card
Renews an expired or expiring virtual card by extending its expiration date to a future month.
The card must be a virtual card that hasn't been fully used. The new expiration date must be in `MM-YYYY` or `MM/YYYY` format and no more than 2 years and 363 days in the future. The card expires on the last day of the month you specify.
On success, `referenceId` holds the renewed card's token (the card processor may issue a new token). The response reuses the standard payout result object, so the payment-transaction fields it carries don't apply to renewal and always return `null`.
Path parameters
cardToken
ID for the virtual card to renew.
Request
This endpoint expects an object.
expirationDate
The new expiration date for the virtual card, in MM-YYYY or MM/YYYY format. The card expires on the last day of the month you specify. The date can’t be more than 2 years and 363 days in the future.
Response
Success
responseText
Response text for operation: ‘Success’ or ‘Declined’.
isSuccess
Boolean indicating whether the operation was successful. A true value
indicates success. A false value indicates failure.
responseData
Errors
400
Bad Request Error
401
Unauthorized Error
500
Internal Server Error
503
Service Unavailable Error