---
title: "POST /api/payment-cards"
method: POST
path: "/api/payment-cards"
tags: ["ApiPaymentCards"]
---

# POST /api/payment-cards

`POST /api/payment-cards`

## Request body

- IssuePaymentCardDto
  - `userId` string, nullable
  - `email` string, nullable
  - `templateId` integer
  - `dialCode` string, nullable
  - `phoneNumber` string, nullable
  - `depositAmount` number, double
  - `recipientName` string, nullable
  - `countryCode` string, nullable
  - `region` string, nullable
  - `city` string, nullable
  - `postcode` string, nullable
  - `addressLine` string, nullable
  - `kyc` PaymentCardKycDto
    - `firstName` string, nullable
    - `lastName` string, nullable
    - `gender` string, nullable
    - `dateOfBirth` string, nullable
    - `kycData` PaymentCardKycDataDto
      - `countryCode` string, nullable
      - `identificationType` string, nullable
      - `identificationNumber` string, nullable
      - `region` string, nullable
      - `city` string, nullable
      - `postcode` string, nullable
      - `addressLine` string, nullable
      - `frontImgBase64` string, nullable
      - `backImgBase64` string, nullable
      - `handheldImgBase64` string, nullable

## Response `200`

Success

- PaymentCardDto
  - `id` string, uuid
  - `userId` string, nullable
  - `status` 10 | 20 | 30 | 40 | 50 | 60
  - `currencyCode` string, nullable
  - `maskedPan` string, nullable
  - `dateCreated` string, date-time
  - `templateId` integer
  - `type` string, nullable
  - `paymentSystem` string, nullable
  - `rechargeFee` number, double, nullable
  - `rechargeMinLimit` number, double, nullable
  - `rechargeMaxLimit` number, double, nullable
  - `canActivate` boolean
  - `shipping` ShippingInfo
    - `trackingNumber` string, nullable
    - `recipientName` string, nullable
    - `countryCode` string, nullable
    - `region` string, nullable
    - `city` string, nullable
    - `postcode` string, nullable
    - `addressLine` string, nullable
    - `dateShipped` string, date-time, nullable

## Other responses

- `400` — Bad Request
- `401` — Unauthorized

---

[API](https://skmtc.dev/binibit/apis/webapp.md) · [All operations](https://skmtc.dev/binibit/apis/webapp/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/binibit/webapp/revisions/975d0a2e9e7d/schema)