Reprint (re-issue) a card

Re-issues a card, producing a new VendorCard (for example after a physical
card is lost or damaged). Authorized for admins or the cardholder.

Flow:

  • The card's vendor must support re-issuing (can_reprint?), otherwise 412.
  • Shipping fields (recipient_name, shipping_address, contact_phone) are
    only valid for physical cards; sending them for a virtual card returns
    422.
  • If the card is not already canceled, it is first canceled for reprint; if the
    cancellation cannot complete, the endpoint returns 412.
  • On success the newly issued card is returned.

The request body is optional; provide shipping details to redirect the
reprinted physical card.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required

The id of the vendor card

Body Params

Payload to re-issue (reprint) a card. All fields are optional. Shipping fields
(recipient_name, shipping_address, contact_phone) apply to physical
cards only — sending them for a virtual card returns 422.

string

Recipient full name for the reprinted physical card.

string

Contact phone for the shipment.

shipping_address
object

Shipping address for the reprinted physical card.

Headers
uuid
required

UUID of the company that owns the card.

Responses

400

Bad Request — reprint failed. { "error_code": "vendor_cards/reprint_failed" }.

401

Unauthorized

404

Vendor card not found (or not visible to the caller).

412

Precondition Failed — card type does not support re-issuing, or the card could not be canceled for reprint.

422

Unprocessable Entity — shipping fields sent for a virtual card, or validation failed on the new card. Body: { "message": ..., "errors": {...} }.

Language
Credentials
Bearer
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json