Skip to main content

Virtual Card Transactions

Overview​

You can create VIRTUAL_CARD (BOOK) transactions via POST /v1/customer/id/{placeholder}/transaction.
The examples below demonstrate issuing virtual cards to contacts and email recipients.

Resource Access​

Production (api.ahrvo.network)

POST https://api.ahrvo.network/banking/us2/v1/customer/id/{customerId}/transaction

Staging (gateway.ahrvo.network)

POST https://gateway.ahrvo.network/banking/us2/v1/customer/id/{customerId}/transaction
Scenarios Covered

• Send — Ahrvo → Contact (existing)
• Send — Ahrvo → Email (one-time recipient)

Send — Ahrvo → Contact (virtual card)​

POST /banking/us2/v1/customer/id/{placeholder}/transaction
Host: <hostname>
Authorization: Bearer <JWT token>
x-api-key: {apiKey}
Content-Type: application/json
{
  "amount": "10.00",
  "allowDuplicate": true,
  "method": "VIRTUAL_CARD",
  "type": "REGULAR",
  "purpose": "For transfer",
  "source": {
    "account": { "id": "4012641" }
  },
  "destination": {
    "contact": { "id": "4013552" }
  },
  "processingDetail": {
    "virtualCard": {
      "cardProgram": { "id": "2590" }
    },
    "location": { "id": 2601 }
  },
  "comment": "Payment for service"
}

Send — Ahrvo → Email (virtual card, one-time)​

POST /banking/us2/v1/customer/id/{placeholder}/transaction
Host: <hostname>
Authorization: Bearer <JWT token>
x-api-key: {apiKey}
Content-Type: application/json
{
  "type": "REGULAR",
  "method": "VIRTUAL_CARD",
  "amount": "100",
  "destination": {
    "email": "navneet.kaur@prth.com"
  },
  "source": {
    "account": { "id": "4006612" }
  },
  "processingDetail": {
    "virtualCard": {
      "cardProgram": { "id": "1097" },
      "nickname": "testing",
      "entity": { "id": "8910" }
    }
  },
  "purpose": "Payment for Deposit",
  "allowDuplicate": true
}

OpenAPI Specification​