moneyOut

Renew a 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.

put/MoneyOutCard/vcard/{cardToken}/renew

Request

  • Base URL: https://api-sandbox.payabli.com/api
  • URL: https://api-sandbox.payabli.com/api/MoneyOutCard/vcard/{cardToken}/renew
  • Auth: HTTP bearer

Path parameters

cardTokenstring required

ID for the virtual card to renew.

Request body

expirationDatestring required

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

responseTextstring required

Response text for operation: 'Success' or 'Declined'.

isSuccessboolean required

Boolean indicating whether the operation was successful. A true value indicates success. A false value indicates failure.

Changes

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