---
title: "Convert alias"
method: POST
path: "/v1/aliases"
tags: ["/v1/aliases"]
---

# Convert alias

`POST /v1/aliases`

Currently, only Card, PostFinance, Twint, PayPal, Byjuno and Reka aliases can be converted.

## Request body

- union
  - object
    - `legacyAlias` string, required — The legacy alias
    - `type` 'CARD' | 'PFC' | 'PFP' | 'TWI' | 'PAP' | 'INT' | 'REK', required — Legacy alias type.
    - `expiryMonth` string — The expiry month of the credit card behind alias.
    - `expiryYear` string — The expiry year of the credit card behind the alias
  - object
    - `legacyAlias` string, required — The legacy alias
    - `type` 'CARD' | 'PFC' | 'PFP' | 'TWI' | 'PAP' | 'INT' | 'REK', required — Legacy alias type.
  - object
    - `legacyAlias` string, required — The legacy alias
    - `type` 'CARD' | 'PFC' | 'PFP' | 'TWI' | 'PAP' | 'INT' | 'REK', required — Legacy alias type.
  - object
    - `legacyAlias` string, required — The legacy alias
    - `type` 'CARD' | 'PFC' | 'PFP' | 'TWI' | 'PAP' | 'INT' | 'REK', required — Legacy alias type.
  - object
    - `legacyAlias` string, required — The legacy alias
    - `type` 'CARD' | 'PFC' | 'PFP' | 'TWI' | 'PAP' | 'INT' | 'REK', required — Legacy alias type.
  - object
    - `legacyAlias` string, required — The legacy alias
    - `type` 'CARD' | 'PFC' | 'PFP' | 'TWI' | 'PAP' | 'INT' | 'REK', required — Legacy alias type.

## Response `201`

Successfully converted an alias

- AliasConvertResponse
  - `alias` string — The requested alias.

## Other responses

- `400` — Invalid request

---

[API](https://skmtc.dev/pci-proxy/apis/pci-proxy-api-reference-datatrans-endpoints.md) · [All operations](https://skmtc.dev/pci-proxy/apis/pci-proxy-api-reference-datatrans-endpoints/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/pci-proxy/pci-proxy-api-reference-datatrans-endpoints/revisions/1f4f905fd175/schema)