---
updatedAt: 2026-08-23T14:10:57.000Z
agentTools:
  projectIndex: https://transactpay.readme.io/llms.txt
---

# Save Card

The **Save Card** endpoint is used to tokenize a customer’s card after completing a successful order. Once saved, the response includes a `cardToken` that can be used for future payments via the [Tokenized Charge API](https://transactpay.readme.io/reference/tokenize-charge-with-seck-key).

<Callout icon="💡" theme="default">
  ### Good to know

  - You must **complete the order successfully** before using this endpoint.
  - Payload should be **encrypted using RSA encryption (PKCS#1 v1.5)**.
  - This helps securely store the customer’s card for seamless future payments.
</Callout>

## Headers

| Header    | Value                 | Description                 |
| --------- | --------------------- | --------------------------- |
| `api-key` | `{{your_secret_key}}` | Your TransactPay secret key |

## Payload Structure (before encryption)

| Key         | Type     | Description                                     | Required |
| ----------- | -------- | ----------------------------------------------- | -------- |
| `reference` | `string` | The unique reference of the **completed** order | ✅        |

***

## Encrypted Payload (what you send)

```json

{
  "data": "{{encrypteddata}}"
}
```

***

## Sample Payload (before encryption)

```json

{
  "reference": "ORDER123456"
}
```

***

## Sample Success Response

```json
{
    "data": "{{Card Token}}",
    "status": "success",
    "statusCode": "00",
    "message": "Card saved successfully"
}
```

<br />

```json
{
    "data": "{{encrypteddata}}"
}
```