---
title: "CardVault"
method: POST
path: "/payhost/card-vault"
tags: ["Vault"]
---

# CardVault

`POST /payhost/card-vault`

### CardVaultRequest

The `CardVaultRequest` lets you securely store a customer’s credit card in PayGate’s PCI-compliant vaulting system — **PayVault**. In return, you’ll receive a `VaultId`, which acts as a tokenised reference to the card. This VaultId can then be used in future transactions, eliminating the need to handle raw card data again.

> ⚠️ You must have **PayVault** enabled on your merchant profile to use this feature. 
  

Common use cases:

- Speeding up repeat purchases by storing customer cards securely
    
- Supporting “one-click” checkouts
    
- Preparing for recurring or subscription-based billing
    

> 💡 The returned `VaultId` is compatible with the `CardPaymentRequest`, `WebPaymentRequest`, and `TokenPaymentRequest`.

**Runtime endpoint:** `POST https://secure.paygate.co.za/payhost/process.trans`

## Headers

- `Content-Type` string, required
- `SOAPAction` string

## Response `200`

SOAP response returned by PayHost.

---

[API](https://skmtc.dev/paygate/apis/payweb3.md) · [All operations](https://skmtc.dev/paygate/apis/payweb3/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/paygate/payweb3/revisions/e047616c029c/schema)