---
title: "Create card token"
method: POST
path: "/api/v1.4/tokens/cards/"
tags: ["v1.1"]
---

# Create card token

`POST /api/v1.4/tokens/cards/`

Create a card token for a customer

## Request body

- CreateCardToken — Creation of card token serializer.
  - `id` string, required
  - `customer` string, required — Customer UUID
  - `webhook_url` string, uri, required — A url that Moneyhash server will send a POST request to with payment data after payment.
  - `payment_provider` string — PayIn method ID
  - `card_token_type` 'UNIVERSAL' | 'PROVIDER' — * `UNIVERSAL` - UNIVERSAL * `PROVIDER` - PROVIDER
  - `successful_redirect_url` string, uri — A url that Moneyhash will redirect users to after a successful payment.
  - `failed_redirect_url` string, uri — A url that Moneyhash will redirect users to after a failed payment.
  - `custom_webhook_headers` unknown
  - `vault_region` 'sa' | 'default' | '' — * `sa` - sa * `default` - default
  - `network_tokenize` boolean — Whether the card is network tokenized or not
  - `agentic_data` CardTokenAgenticData
    - `max_amount` string, decimal, required
    - `currency` 'AED' | 'AFN' | 'ALL' | 'AMD' | 'ARS' | 'AUD' | 'AZN' | 'BAM' | 'BDT' | 'BGN' | 'BHD' | 'BIF' | 'BND' | 'BOB' | 'BRL' | 'BWP' | 'BYN' | 'BZD' | 'CAD' | 'CDF' | 'CHF' | 'CLP' | 'CNY' | 'COP' | 'CRC' | 'CVE' | 'CZK' | 'DJF' | 'DKK' | 'DOP' | 'DZD' | 'EEK' | 'EGP' | 'ERN' | 'ETB' | 'EUR' | 'GBP' | 'GEL' | 'GHS' | 'GNF' | 'GTQ' | 'HKD' | 'HNL' | 'HRK' | 'HUF' | 'IDR' | 'ILS' | 'INR' | 'IQD' | 'IRR' | 'ISK' | 'JMD' | 'JOD' | 'JPY' | 'KES' | 'KHR' | 'KMF' | 'KRW' | 'KWD' | 'KZT' | 'LBP' | 'LKR' | 'LTL' | 'LVL' | 'LYD' | 'MAD' | 'MDL' | 'MGA' | 'MKD' | 'MMK' | 'MOP' | 'MRU' | 'MUR' | 'MXN' | 'MYR' | 'MZN' | 'NAD' | 'NGN' | 'NIO' | 'NOK' | 'NPR' | 'NZD' | 'OMR' | 'PAB' | 'PEN' | 'PHP' | 'PKR' | 'PLN' | 'PYG' | 'QAR' | 'RON' | 'RSD' | 'RUB' | 'RWF' | 'SAR' | 'SDG' | 'SEK' | 'SGD' | 'SOS' | 'SYP' | 'THB' | 'TND' | 'TOP' | 'TRY' | 'TTD' | 'TWD' | 'TZS' | 'UAH' | 'UGX' | 'USD' | 'UYU' | 'UZS' | 'VEF' | 'VND' | 'XAF' | 'XOF' | 'YER' | 'ZAR' | 'ZMK' | 'ZWL', required — * `AED` - AED * `AFN` - AFN * `ALL` - ALL * `AMD` - AMD * `ARS` - ARS * `AUD` - AUD * `AZN` - AZN * `BAM` - BAM * `BDT` - BDT * `BGN` - BGN * `BHD` - BHD * `BIF` - BIF * `BND` - BND * `BOB` - BOB * `BRL` - BRL * `BWP` - BWP * `BYN` - BYN * `BZD` - BZD * `CAD` - CAD * `CDF` - CDF * `CHF` - CHF * `CLP` - CLP * `CNY` - CNY * `COP` - COP * `CRC` - CRC * `CVE` - CVE * `CZK` - CZK * `DJF` - DJF * `DKK` - DKK * `DOP` - DOP * `DZD` - DZD * `EEK` - EEK * `EGP` - EGP * `ERN` - ERN * `ETB` - ETB * `EUR` - EUR * `GBP` - GBP * `GEL` - GEL * `GHS` - GHS * `GNF` - GNF * `GTQ` - GTQ * `HKD` - HKD * `HNL` - HNL * `HRK` - HRK * `HUF` - HUF * `IDR` - IDR * `ILS` - ILS * `INR` - INR * `IQD` - IQD * `IRR` - IRR * `ISK` - ISK * `JMD` - JMD * `JOD` - JOD * `JPY` - JPY * `KES` - KES * `KHR` - KHR * `KMF` - KMF * `KRW` - KRW * `KWD` - KWD * `KZT` - KZT * `LBP` - LBP * `LKR` - LKR * `LTL` - LTL * `LVL` - LVL * `LYD` - LYD * `MAD` - MAD * `MDL` - MDL * `MGA` - MGA * `MKD` - MKD * `MMK` - MMK * `MOP` - MOP * `MRU` - MRU * `MUR` - MUR * `MXN` - MXN * `MYR` - MYR * `MZN` - MZN * `NAD` - NAD * `NGN` - NGN * `NIO` - NIO * `NOK` - NOK * `NPR` - NPR * `NZD` - NZD * `OMR` - OMR * `PAB` - PAB * `PEN` - PEN * `PHP` - PHP * `PKR` - PKR * `PLN` - PLN * `PYG` - PYG * `QAR` - QAR * `RON` - RON * `RSD` - RSD * `RUB` - RUB * `RWF` - RWF * `SAR` - SAR * `SDG` - SDG * `SEK` - SEK * `SGD` - SGD * `SOS` - SOS * `SYP` - SYP * `THB` - THB * `TND` - TND * `TOP` - TOP * `TRY` - TRY * `TTD` - TTD * `TWD` - TWD * `TZS` - TZS * `UAH` - UAH * `UGX` - UGX * `USD` - USD * `UYU` - UYU * `UZS` - UZS * `VEF` - VEF * `VND` - VND * `XAF` - XAF * `XOF` - XOF * `YER` - YER * `ZAR` - ZAR * `ZMK` - ZMK * `ZWL` - ZWL
    - `max_usage_count` integer
    - `valid_from` string, date-time, required
    - `expires_at` string, date-time, required
    - `agent_id` string, required
  - `created` string, date-time, required
  - `modified` string, date-time, required
  - `redirect_strategy` 'redirect_inside_embed' | 'redirect_entire_window' | 'redirect_to_new_tab' | '' | 'null', nullable — * `redirect_inside_embed` - redirect_inside_embed * `redirect_entire_window` - redirect_entire_window * `redirect_to_new_tab` - redirect_to_new_tab
  - `hide_header` boolean
  - `form_only` boolean
  - `status` string
  - `for_sandbox` boolean, required — This field used to filter data to be used in sandbox
  - `custom_fields` unknown
  - `merchant_reference` string, nullable

## Response `200`

- CardTokenIntent
  - `id` string, required
  - `hide_header` boolean
  - `standalone_tokenization` boolean, required
  - `form_only` boolean

## Other responses

- `400`
- `401`

---

[API](https://skmtc.net/moneyhash/apis/moneyhash-api.md) · [All operations](https://skmtc.net/moneyhash/apis/moneyhash-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/moneyhash/moneyhash-api/revisions/111e4c2e0826/schema)