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`.
Authentication
requestTokenstring
Long-lived API token sent in the requestToken header. See API token authentication.
OR
AuthorizationBearer
OAuth2 Bearer access token from the client-credentials flow. See OAuth authentication.
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