---
title: "Changes to Card On File Checkout"
method: POST
path: "/checkout/card-on-file"
---

# Changes to Card On File Checkout

`POST /checkout/card-on-file`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 6 of 43 revisions.

- **2026-09-29** `f7dc6dbf5437`: 2 warning
- **2026-09-19** `c6e94e0ae714`: 4 breaking
- **2026-09-17** `81b590227b14`: 1 warning, 1 info
- **2026-09-12** `66b771d6d31f`: 1 info
- **2026-08-22** `c6be39c0cb2f`: 28 breaking, 14 warning
- **2026-08-06** `7eea51c8775d`: 2 info

## Changes

- **2026-09-29** `f7dc6dbf5437`: 2 warning
  - removed the request property `oneOf[subschema #1: CardOnFileCheckoutArgsWithOriginalPaymentId]/redemptionCheck`
  - removed the request property `oneOf[subschema #2: CardOnFileCheckoutArgsWithToken]/redemptionCheck`
- **2026-09-19** `c6e94e0ae714`: 4 breaking
  - request property `oneOf[subschema #1: CardOnFileCheckoutArgsWithOriginalPaymentId]/rent/lamports` list-of-types was narrowed by removing types `number` from media type `application/json`
  - request property `oneOf[subschema #2: CardOnFileCheckoutArgsWithToken]/rent/lamports` list-of-types was narrowed by removing types `number` from media type `application/json`
  - the `oneOf[subschema #1: CardOnFileCheckoutArgsWithOriginalPaymentId]/rent/lamports/oneOf[subschema #2]/` request property type changed from `number` to `integer`, and format from `double` to no format
  - the `oneOf[subschema #2: CardOnFileCheckoutArgsWithToken]/rent/lamports/oneOf[subschema #2]/` request property type changed from `number` to `integer`, and format from `double` to no format
- **2026-09-17** `81b590227b14`: 1 warning, 1 info
  - deleted the `header` request parameter `x-coinflow-auth-user-id`
  - the endpoint scheme security `userId` was added to the API
- **2026-09-12** `66b771d6d31f`: 1 info
  - api operation id `card-on-file-checkout` removed and replaced with `checkout_CardOnFileCheckout`
- **2026-08-22** `c6be39c0cb2f`: 28 breaking, 14 warning
  - the `oneOf[subschema #1: CardOnFileCheckoutArgsWithOriginalPaymentId]/accountFundingTransaction/recipientAftInfo/address1` request property's minLength was increased from `0` to `2`
  - the `oneOf[subschema #1: CardOnFileCheckoutArgsWithOriginalPaymentId]/accountFundingTransaction/recipientAftInfo/city` request property's minLength was increased from `0` to `2`
  - the `oneOf[subschema #1: CardOnFileCheckoutArgsWithOriginalPaymentId]/accountFundingTransaction/recipientAftInfo/countryCode` request property's minLength was increased from `0` to `2`
  - the `oneOf[subschema #1: CardOnFileCheckoutArgsWithOriginalPaymentId]/accountFundingTransaction/recipientAftInfo/firstName` request property's minLength was increased from `0` to `2`
  - the `oneOf[subschema #1: CardOnFileCheckoutArgsWithOriginalPaymentId]/accountFundingTransaction/recipientAftInfo/lastName` request property's minLength was increased from `0` to `2`
  - the `oneOf[subschema #1: CardOnFileCheckoutArgsWithOriginalPaymentId]/accountFundingTransaction/recipientAftInfo/postalCode` request property's minLength was increased from `0` to `2`
  - the `oneOf[subschema #1: CardOnFileCheckoutArgsWithOriginalPaymentId]/accountFundingTransaction/recipientAftInfo/state` request property's minLength was increased from `0` to `2`
  - the `oneOf[subschema #1: CardOnFileCheckoutArgsWithOriginalPaymentId]/chargebackProtectionData/items/oneOf[subschema #1: Pick_nftCartItem.Exclude_keyofnftCartItem.sellingPrice-or-itemClass__]/productName` request property's minLength was increased from `0` to `1`
  - the `oneOf[subschema #1: CardOnFileCheckoutArgsWithOriginalPaymentId]/customerInfo/oneOf[subschema #1: SplitNameCustomerInfo]/firstName` request property's minLength was increased from `0` to `1`
  - the `oneOf[subschema #1: CardOnFileCheckoutArgsWithOriginalPaymentId]/customerInfo/oneOf[subschema #1: SplitNameCustomerInfo]/lastName` request property's minLength was increased from `0` to `1`
  - the `oneOf[subschema #1: CardOnFileCheckoutArgsWithOriginalPaymentId]/transactionData/oneOf[subschema #3: KnownTokenIdRedeem]/nftContract` request property's minLength was increased from `0` to `42`
  - the `oneOf[subschema #1: CardOnFileCheckoutArgsWithOriginalPaymentId]/transactionData/oneOf[subschema #3: KnownTokenIdRedeem]/nftId` request property's minLength was increased from `0` to `1`
  - the `oneOf[subschema #2: CardOnFileCheckoutArgsWithToken]/accountFundingTransaction/recipientAftInfo/address1` request property's minLength was increased from `0` to `2`
  - the `oneOf[subschema #2: CardOnFileCheckoutArgsWithToken]/accountFundingTransaction/recipientAftInfo/city` request property's minLength was increased from `0` to `2`
  - the `oneOf[subschema #2: CardOnFileCheckoutArgsWithToken]/accountFundingTransaction/recipientAftInfo/countryCode` request property's minLength was increased from `0` to `2`
  - the `oneOf[subschema #2: CardOnFileCheckoutArgsWithToken]/accountFundingTransaction/recipientAftInfo/firstName` request property's minLength was increased from `0` to `2`
  - the `oneOf[subschema #2: CardOnFileCheckoutArgsWithToken]/accountFundingTransaction/recipientAftInfo/lastName` request property's minLength was increased from `0` to `2`
  - the `oneOf[subschema #2: CardOnFileCheckoutArgsWithToken]/accountFundingTransaction/recipientAftInfo/postalCode` request property's minLength was increased from `0` to `2`
  - the `oneOf[subschema #2: CardOnFileCheckoutArgsWithToken]/accountFundingTransaction/recipientAftInfo/state` request property's minLength was increased from `0` to `2`
  - the `oneOf[subschema #2: CardOnFileCheckoutArgsWithToken]/chargebackProtectionData/items/oneOf[subschema #1: Pick_nftCartItem.Exclude_keyofnftCartItem.sellingPrice-or-itemClass__]/productName` request property's minLength was increased from `0` to `1`
  - the `oneOf[subschema #2: CardOnFileCheckoutArgsWithToken]/customerInfo/oneOf[subschema #1: SplitNameCustomerInfo]/firstName` request property's minLength was increased from `0` to `1`
  - the `oneOf[subschema #2: CardOnFileCheckoutArgsWithToken]/customerInfo/oneOf[subschema #1: SplitNameCustomerInfo]/lastName` request property's minLength was increased from `0` to `1`
  - the `oneOf[subschema #2: CardOnFileCheckoutArgsWithToken]/transactionData/oneOf[subschema #3: KnownTokenIdRedeem]/nftContract` request property's minLength was increased from `0` to `42`
  - the `oneOf[subschema #2: CardOnFileCheckoutArgsWithToken]/transactionData/oneOf[subschema #3: KnownTokenIdRedeem]/nftId` request property's minLength was increased from `0` to `1`
  - added the pattern `^\d+$` to the request property `oneOf[subschema #1: CardOnFileCheckoutArgsWithOriginalPaymentId]/accountFundingTransaction/recipientAftInfo/phoneNumber`
  - added the pattern `^\d+$` to the request property `oneOf[subschema #2: CardOnFileCheckoutArgsWithToken]/accountFundingTransaction/recipientAftInfo/phoneNumber`
  - added the pattern `^\d{8}$` to the request property `oneOf[subschema #1: CardOnFileCheckoutArgsWithOriginalPaymentId]/accountFundingTransaction/recipientAftInfo/dateOfBirth`
  - added the pattern `^\d{8}$` to the request property `oneOf[subschema #2: CardOnFileCheckoutArgsWithToken]/accountFundingTransaction/recipientAftInfo/dateOfBirth`
  - the `oneOf[subschema #1: CardOnFileCheckoutArgsWithOriginalPaymentId]/accountFundingTransaction/recipientAftInfo/countryCode` request property's maxLength was set to `2`
  - the `oneOf[subschema #1: CardOnFileCheckoutArgsWithOriginalPaymentId]/transactionData/oneOf[subschema #3: KnownTokenIdRedeem]/nftContract` request property's maxLength was set to `42`
  - the `oneOf[subschema #2: CardOnFileCheckoutArgsWithToken]/accountFundingTransaction/recipientAftInfo/countryCode` request property's maxLength was set to `2`
  - the `oneOf[subschema #2: CardOnFileCheckoutArgsWithToken]/transactionData/oneOf[subschema #3: KnownTokenIdRedeem]/nftContract` request property's maxLength was set to `42`
  - the `oneOf[subschema #1: CardOnFileCheckoutArgsWithOriginalPaymentId]/feePercentage` request property's max was set to `100.00`
  - the `oneOf[subschema #2: CardOnFileCheckoutArgsWithToken]/feePercentage` request property's max was set to `100.00`
  - the `oneOf[subschema #1: CardOnFileCheckoutArgsWithOriginalPaymentId]/feePercentage` request property's min was set to `0.00`
  - the `oneOf[subschema #1: CardOnFileCheckoutArgsWithOriginalPaymentId]/fixedFee/cents` request property's min was set to `0.00`
  - the `oneOf[subschema #1: CardOnFileCheckoutArgsWithOriginalPaymentId]/subtotal/oneOf[subschema #1: CurrencyCents]/cents` request property's min was set to `0.00`
  - the `oneOf[subschema #1: CardOnFileCheckoutArgsWithOriginalPaymentId]/subtotal/oneOf[subschema #2: Cents]/cents` request property's min was set to `0.00`
  - the `oneOf[subschema #2: CardOnFileCheckoutArgsWithToken]/feePercentage` request property's min was set to `0.00`
  - the `oneOf[subschema #2: CardOnFileCheckoutArgsWithToken]/fixedFee/cents` request property's min was set to `0.00`
  - …2 more
- **2026-08-06** `7eea51c8775d`: 2 info
  - added `#/components/schemas/TravelCartItem, #/components/schemas/FlightTicketCartItem, #/components/schemas/FlightUpgradeCartItem, #/components/schemas/LodgingCartItem` to the `oneOf[subschema #1: CardOnFileCheckoutArgsWithOriginalPaymentId]/chargebackProtectionData/items/` request property `oneOf` list
  - added `#/components/schemas/TravelCartItem, #/components/schemas/FlightTicketCartItem, #/components/schemas/FlightUpgradeCartItem, #/components/schemas/LodgingCartItem` to the `oneOf[subschema #2: CardOnFileCheckoutArgsWithToken]/chargebackProtectionData/items/` request property `oneOf` list

---

[Operation](https://skmtc.dev/coinflow/apis/api-reference/docs/checkout/card-on-file/post.md) - [API](https://skmtc.dev/coinflow/apis/api-reference.md) - [Page](https://skmtc.dev/coinflow/apis/api-reference/changes/checkout/card-on-file/post)