Skip to main content

Retrieve Virtual Card Image

The Retrieve Virtual Card Image endpoint returns a Base-64–encoded PNG/JPEG of a single- or multi-use virtual card that was previously issued to a customer.

PCI note: Access to cardholder data (card number, CVV, images, etc.) is restricted. Your application must be PCI-DSS compliant and the card program must allow card-data retrieval. Contact your Ahrvo Account Manager for enablement.

Resource Access​

Production (api.ahrvo.network)

GET https://api.ahrvo.network/banking/us2/v1/customer/id/{customerId}/account/id/{accountId}/virtualCard/id/{virtualCardId}/image

Staging (gateway.ahrvo.network)

GET https://gateway.ahrvo.network/banking/us2/v1/customer/id/{customerId}/account/id/{accountId}/virtualCard/id/{virtualCardId}/image

Sample Request — Retrieve Virtual Card Image​

GET /v1/customer/id/4007329/account/id/4004867/virtualCard/id/18960/image HTTP/1.1
Host: <hostname>
Authorization: Bearer <JWT token>
x-api-key: {apiKey}
Accept: application/json
Sample Response​
{
  "image": "iVBORw0KGgoAAAANSUhEUgAAA+4=="
}
HTTP/1.1 200 OK

The image field contains the Base-64 string of the virtual-card image. Decode and render it (e.g., in an <img> tag with a data:image/png;base64, … source) to display the card to the user.