---
title: "Changes to Purchase Subscription with New Card"
method: POST
path: "/subscription/{merchantId}/subscribers/card"
---

# Changes to Purchase Subscription with New Card

`POST /subscription/{merchantId}/subscribers/card`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 4 of 43 revisions.

- **2026-09-17** `81b590227b14`: 1 warning, 1 info
- **2026-09-12** `66b771d6d31f`: 1 info
- **2026-08-22** `c6be39c0cb2f`: 31 breaking, 9 warning
- **2026-08-06** `7eea51c8775d`: 1 info

## Changes

- **2026-09-17** `81b590227b14`: 1 warning, 1 info
  - deleted the `header` request parameter `x-coinflow-auth-session-key`
  - the endpoint scheme security `sessionKey` was added to the API
- **2026-09-12** `66b771d6d31f`: 1 info
  - api operation id `create-subscription-card` removed and replaced with `subscription_CreateSubscriptionCard`
- **2026-08-22** `c6be39c0cb2f`: 31 breaking, 9 warning
  - the `accountFundingTransaction/recipientAftInfo/address1` request property's minLength was increased from `0` to `2`
  - the `accountFundingTransaction/recipientAftInfo/city` request property's minLength was increased from `0` to `2`
  - the `accountFundingTransaction/recipientAftInfo/countryCode` request property's minLength was increased from `0` to `2`
  - the `accountFundingTransaction/recipientAftInfo/firstName` request property's minLength was increased from `0` to `2`
  - the `accountFundingTransaction/recipientAftInfo/lastName` request property's minLength was increased from `0` to `2`
  - the `accountFundingTransaction/recipientAftInfo/postalCode` request property's minLength was increased from `0` to `2`
  - the `accountFundingTransaction/recipientAftInfo/state` request property's minLength was increased from `0` to `2`
  - the `card/oneOf[subschema #1: CardData]/address1` request property's minLength was increased from `0` to `1`
  - the `card/oneOf[subschema #1: CardData]/cardToken` request property's minLength was increased from `0` to `1`
  - the `card/oneOf[subschema #1: CardData]/city` request property's minLength was increased from `0` to `1`
  - the `card/oneOf[subschema #1: CardData]/country` request property's minLength was increased from `0` to `2`
  - the `card/oneOf[subschema #1: CardData]/expMonth` request property's minLength was increased from `0` to `2`
  - the `card/oneOf[subschema #1: CardData]/expYear` request property's minLength was increased from `0` to `2`
  - the `card/oneOf[subschema #1: CardData]/firstName` request property's minLength was increased from `0` to `2`
  - the `card/oneOf[subschema #1: CardData]/lastName` request property's minLength was increased from `0` to `2`
  - the `card/oneOf[subschema #2: CardDataWithoutAddress]/cardToken` request property's minLength was increased from `0` to `1`
  - the `card/oneOf[subschema #2: CardDataWithoutAddress]/expMonth` request property's minLength was increased from `0` to `2`
  - the `card/oneOf[subschema #2: CardDataWithoutAddress]/expYear` request property's minLength was increased from `0` to `2`
  - the `card/oneOf[subschema #2: CardDataWithoutAddress]/firstName` request property's minLength was increased from `0` to `2`
  - the `card/oneOf[subschema #2: CardDataWithoutAddress]/lastName` request property's minLength was increased from `0` to `2`
  - the `chargebackProtectionData/items/oneOf[subschema #1: Pick_nftCartItem.Exclude_keyofnftCartItem.sellingPrice-or-itemClass__]/productName` request property's minLength was increased from `0` to `1`
  - the `customerInfo/oneOf[subschema #1: SplitNameCustomerInfo]/firstName` request property's minLength was increased from `0` to `1`
  - the `customerInfo/oneOf[subschema #1: SplitNameCustomerInfo]/lastName` request property's minLength was increased from `0` to `1`
  - added the pattern `(([^<>()[\]\\.,;:\s@"]+(\.[^<>()[\]\\.,;:\s@"]+)*)|(".+"))@((\[[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}])|(([a-zA-Z\-0-9]+\.)+[a-zA-Z]{2,}))` to the request property `card/oneOf[subschema #1: CardData]/email`
  - added the pattern `(([^<>()[\]\\.,;:\s@"]+(\.[^<>()[\]\\.,;:\s@"]+)*)|(".+"))@((\[[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}])|(([a-zA-Z\-0-9]+\.)+[a-zA-Z]{2,}))` to the request property `card/oneOf[subschema #2: CardDataWithoutAddress]/email`
  - added the pattern `^\d+$` to the request property `accountFundingTransaction/recipientAftInfo/phoneNumber`
  - added the pattern `^\d+$` to the request property `card/oneOf[subschema #1: CardData]/expMonth`
  - added the pattern `^\d+$` to the request property `card/oneOf[subschema #1: CardData]/expYear`
  - added the pattern `^\d+$` to the request property `card/oneOf[subschema #2: CardDataWithoutAddress]/expMonth`
  - added the pattern `^\d+$` to the request property `card/oneOf[subschema #2: CardDataWithoutAddress]/expYear`
  - added the pattern `^\d{8}$` to the request property `accountFundingTransaction/recipientAftInfo/dateOfBirth`
  - the `accountFundingTransaction/recipientAftInfo/countryCode` request property's maxLength was set to `2`
  - the `card/oneOf[subschema #1: CardData]/country` request property's maxLength was set to `2`
  - the `card/oneOf[subschema #1: CardData]/expMonth` request property's maxLength was set to `2`
  - the `card/oneOf[subschema #1: CardData]/expYear` request property's maxLength was set to `2`
  - the `card/oneOf[subschema #2: CardDataWithoutAddress]/expMonth` request property's maxLength was set to `2`
  - the `card/oneOf[subschema #2: CardDataWithoutAddress]/expYear` request property's maxLength was set to `2`
  - the `feePercentage` request property's max was set to `100.00`
  - the `feePercentage` request property's min was set to `0.00`
  - the `fixedFee/cents` request property's min was set to `0.00`
- **2026-08-06** `7eea51c8775d`: 1 info
  - added `#/components/schemas/TravelCartItem, #/components/schemas/FlightTicketCartItem, #/components/schemas/FlightUpgradeCartItem, #/components/schemas/LodgingCartItem` to the `chargebackProtectionData/items/` request property `oneOf` list

---

[Operation](https://skmtc.dev/coinflow/apis/api-reference/docs/subscription/:merchantId/subscribers/card/post.md) - [API](https://skmtc.dev/coinflow/apis/api-reference.md) - [Page](https://skmtc.dev/coinflow/apis/api-reference/changes/subscription/:merchantId/subscribers/card/post)