---
title: "Changes to Create a Transfer"
method: POST
path: "/transfers"
---

# Changes to Create a Transfer

`POST /transfers`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 12 of 27 revisions.

- **2026-10-14** `8c3b82d51eff`: 1 breaking, 2 info
- **2026-10-10** `4eb2502fcc00`: 10 warning
- **2026-09-24** `27f92cb842a4`: 3 breaking, 3 warning, 6 info
- **2026-09-12** `fa256b901d16`: 1 warning
- **2026-09-11** `c1659d0a3477`: 14 breaking, 4 warning, 17 info
- **2026-09-05** `1d6b546b10f2`: 6 breaking, 7 warning, 2 info
- **2026-09-02** `3ada948cf2c5`: 4 breaking, 2 info
- **2026-08-29** `0cf4cdf27361`: 5 breaking
- **2026-08-25** `9db82db717c5`: 4 info
- **2026-08-22** `7919e33b4853`: 10 breaking, 42 info
- **2026-08-21** `96653f0c196b`: 2 breaking, 5 info
- **2026-08-08** `5426f6f99c52`: 1 breaking

## Changes

- **2026-10-14** `8c3b82d51eff`: 1 breaking, 2 info
  - removed `#/components/schemas/createTransferMinimalFields, #/components/schemas/createTransferAllFields, #/components/schemas/createTransferCanadaEFT, #/components/schemas/createTransfer3DSecure, #/components/schemas/createTransferBankPayout, #/components/schemas/createTransferBankPayoutSameDay, #/components/schemas/createTransferCardPayout, #/components/schemas/createTransferCardPresent, #/components/schemas/createTransferUnreferencedRefund, #/components/schemas/createTransferCardVerificationCheck, #/components/schemas/createTransferConvenienceFee, #/components/schemas/createTransferDebitBankAccount, #/components/schemas/createTransferFeeProfile, #/components/schemas/createTransferAutoRental, #/components/schemas/createTransferLodging, #/components/schemas/createTransferGaming, #/components/schemas/createTransferLvl2Processing, #/components/schemas/createTransferLvl3Processing, #/components/schemas/createTransferPartialAuthorization, #/components/schemas/createTransferRecurringUnscheduled, #/components/schemas/createTransferRentSurcharge, #/components/schemas/createTransferSplitTransaction, #/components/schemas/createTransferSurcharge, #/components/schemas/createTransferMeToMePullCard, #/components/schemas/createTransferMeToMePullBank, #/components/schemas/createTransferMeToMePullBankSameDay, #/components/schemas/createTransferMeToMePayoutCard, #/components/schemas/createTransferMeToMePayoutBank, #/components/schemas/createTransferMeToMePayoutBankSameDay` from the request body `oneOf` list
  - added `#/components/schemas/createTransferMinimalFields, #/components/schemas/createTransferAllFields, #/components/schemas/createTransferCanadaEFT, #/components/schemas/createTransfer3DSecure, #/components/schemas/createTransfer3DSecureSession, #/components/schemas/createTransferBankPayout, #/components/schemas/createTransferBankPayoutSameDay, #/components/schemas/createTransferCardPayout, #/components/schemas/createTransferCardPresent, #/components/schemas/createTransferUnreferencedRefund, #/components/schemas/createTransferCardVerificationCheck, #/components/schemas/createTransferConvenienceFee, #/components/schemas/createTransferDebitBankAccount, #/components/schemas/createTransferFeeProfile, #/components/schemas/createTransferAutoRental, #/components/schemas/createTransferLodging, #/components/schemas/createTransferGaming, #/components/schemas/createTransferLvl2Processing, #/components/schemas/createTransferLvl3Processing, #/components/schemas/createTransferPartialAuthorization, #/components/schemas/createTransferRecurringUnscheduled, #/components/schemas/createTransferRentSurcharge, #/components/schemas/createTransferSplitTransaction, #/components/schemas/createTransferSurcharge, #/components/schemas/createTransferMeToMePullCard, #/components/schemas/createTransferMeToMePullBank, #/components/schemas/createTransferMeToMePullBankSameDay, #/components/schemas/createTransferMeToMePayoutCard, #/components/schemas/createTransferMeToMePayoutBank, #/components/schemas/createTransferMeToMePayoutBankSameDay` to the request body `anyOf` list
  - added the optional property `3d_secure_session` to the response with the `201` status
- **2026-10-10** `4eb2502fcc00`: 10 warning
  - added the new `CARD_PRESENT_IOS_TAP_TO_PAY` enum value to the `created_via` response property for the response status `201`
  - added the new `CARD_PRESENT_IOS_TAP_TO_PAY_SDK` enum value to the `created_via` response property for the response status `201`
  - added the new `DEVICE_ORDER` enum value to the `created_via` response property for the response status `201`
  - added the new `PLUGIN_ADMOJI` enum value to the `created_via` response property for the response status `201`
  - added the new `PLUGIN_GR4VY` enum value to the `created_via` response property for the response status `201`
  - added the new `PLUGIN_LACORE` enum value to the `created_via` response property for the response status `201`
  - added the new `PLUGIN_PRYZR` enum value to the `created_via` response property for the response status `201`
  - added the new `PLUGIN_SERVMAN` enum value to the `created_via` response property for the response status `201`
  - added the new `PLUGIN_SOAP_PAY` enum value to the `created_via` response property for the response status `201`
  - added the new `PLUGIN_VRIO` enum value to the `created_via` response property for the response status `201`
- **2026-09-24** `27f92cb842a4`: 3 breaking, 3 warning, 6 info
  - request property `oneOf[subschema #17: Transfer - Level 2 Processing]/additional_purchase_data/item_data/items/commodity_code` list-of-types was narrowed by removing types `integer` from media type `application/json`
  - request property `oneOf[subschema #18: Transfer - Level 3 Processing]/additional_purchase_data/item_data/items/commodity_code` list-of-types was narrowed by removing types `integer` from media type `application/json`
  - request property `oneOf[subschema #2: Transfer - All Fields]/additional_purchase_data/item_data/items/commodity_code` list-of-types was narrowed by removing types `integer` from media type `application/json`
  - the `oneOf[subschema #17: Transfer - Level 2 Processing]/additional_purchase_data/item_data/items/commodity_code` request property's maxLength was set to `12`
  - the `oneOf[subschema #18: Transfer - Level 3 Processing]/additional_purchase_data/item_data/items/commodity_code` request property's maxLength was set to `12`
  - the `oneOf[subschema #2: Transfer - All Fields]/additional_purchase_data/item_data/items/commodity_code` request property's maxLength was set to `12`
  - added the new optional request property `oneOf[subschema #17: Transfer - Level 2 Processing]/statement_descriptor`
  - added the new optional request property `oneOf[subschema #17: Transfer - Level 2 Processing]/tags`
  - added the new optional request property `oneOf[subschema #18: Transfer - Level 3 Processing]/statement_descriptor`
  - added the new optional request property `oneOf[subschema #18: Transfer - Level 3 Processing]/tags`
  - added the new optional request property `oneOf[subschema #20: Transfer - Recurring or Unscheduled]/tags`
  - response property `additional_purchase_data/item_data/items/commodity_code` list-of-types was narrowed by removing types `integer` from media type `application/json` of response `201`
- **2026-09-12** `fa256b901d16`: 1 warning
  - added the new `CARD_PRESENT_DEVICE_READER_SDK` enum value to the `created_via` response property for the response status `201`
- **2026-09-11** `c1659d0a3477`: 14 breaking, 4 warning, 17 info
  - the response property `additional_lodging_data/extra_charge_details/gift_shop_amount` became nullable for the status `201`
  - the response property `additional_lodging_data/extra_charge_details/laundry_amount` became nullable for the status `201`
  - the response property `additional_lodging_data/extra_charge_details/mini_bar_amount` became nullable for the status `201`
  - the response property `additional_lodging_data/extra_charge_details/other_amount` became nullable for the status `201`
  - the response property `additional_lodging_data/extra_charge_details/phone_amount` became nullable for the status `201`
  - the response property `additional_lodging_data/extra_charge_details/restaurant_amount` became nullable for the status `201`
  - the response property `additional_motor_vehicle_rental_data/extra_charge_details/extra_mileage_amount` became nullable for the status `201`
  - the response property `additional_motor_vehicle_rental_data/extra_charge_details/fuel_amount` became nullable for the status `201`
  - the response property `additional_motor_vehicle_rental_data/extra_charge_details/insurance_amount` became nullable for the status `201`
  - the response property `additional_motor_vehicle_rental_data/extra_charge_details/late_return_amount` became nullable for the status `201`
  - the response property `additional_motor_vehicle_rental_data/extra_charge_details/one_way_service_fee_amount` became nullable for the status `201`
  - the response property `additional_motor_vehicle_rental_data/extra_charge_details/parking_violation_amount` became nullable for the status `201`
  - response property `additional_purchase_data/item_data/items/commodity_code` list-of-types was widened by adding types `integer` to media type `application/json` of response `201`
  - the `additional_purchase_data/item_data/items/commodity_code` response property's maxLength was unset from `12` for the response status `201`
  - added the new `REFUND_MERCHANT_CREDIT_ADJUSTMENT` enum value to the `operation_key` response property for the response status `201`
  - added the new `REFUND_MERCHANT_CREDIT_ADJUSTMENT` enum value to the `subtype` response property for the response status `201`
  - added the new `REFUND_MERCHANT_DEBIT_ADJUSTMENT` enum value to the `operation_key` response property for the response status `201`
  - added the new `REFUND_MERCHANT_DEBIT_ADJUSTMENT` enum value to the `subtype` response property for the response status `201`
  - the request property `oneOf[subschema #14: Transfer - Motor Vehicle Rental]/additional_motor_vehicle_rental_data/allOf[#/components/schemas/additional_motor_vehicle_rental_data]/extra_charge_details/extra_mileage_amount` became nullable
  - the request property `oneOf[subschema #14: Transfer - Motor Vehicle Rental]/additional_motor_vehicle_rental_data/allOf[#/components/schemas/additional_motor_vehicle_rental_data]/extra_charge_details/fuel_amount` became nullable
  - the request property `oneOf[subschema #14: Transfer - Motor Vehicle Rental]/additional_motor_vehicle_rental_data/allOf[#/components/schemas/additional_motor_vehicle_rental_data]/extra_charge_details/insurance_amount` became nullable
  - the request property `oneOf[subschema #14: Transfer - Motor Vehicle Rental]/additional_motor_vehicle_rental_data/allOf[#/components/schemas/additional_motor_vehicle_rental_data]/extra_charge_details/late_return_amount` became nullable
  - the request property `oneOf[subschema #14: Transfer - Motor Vehicle Rental]/additional_motor_vehicle_rental_data/allOf[#/components/schemas/additional_motor_vehicle_rental_data]/extra_charge_details/one_way_service_fee_amount` became nullable
  - the request property `oneOf[subschema #14: Transfer - Motor Vehicle Rental]/additional_motor_vehicle_rental_data/allOf[#/components/schemas/additional_motor_vehicle_rental_data]/extra_charge_details/parking_violation_amount` became nullable
  - the request property `oneOf[subschema #15: Transfer - Lodging]/additional_lodging_data/allOf[#/components/schemas/additional_lodging_data]/extra_charge_details/gift_shop_amount` became nullable
  - the request property `oneOf[subschema #15: Transfer - Lodging]/additional_lodging_data/allOf[#/components/schemas/additional_lodging_data]/extra_charge_details/laundry_amount` became nullable
  - the request property `oneOf[subschema #15: Transfer - Lodging]/additional_lodging_data/allOf[#/components/schemas/additional_lodging_data]/extra_charge_details/mini_bar_amount` became nullable
  - the request property `oneOf[subschema #15: Transfer - Lodging]/additional_lodging_data/allOf[#/components/schemas/additional_lodging_data]/extra_charge_details/other_amount` became nullable
  - the request property `oneOf[subschema #15: Transfer - Lodging]/additional_lodging_data/allOf[#/components/schemas/additional_lodging_data]/extra_charge_details/phone_amount` became nullable
  - the request property `oneOf[subschema #15: Transfer - Lodging]/additional_lodging_data/allOf[#/components/schemas/additional_lodging_data]/extra_charge_details/restaurant_amount` became nullable
  - request property `oneOf[subschema #17: Transfer - Level 2 Processing]/additional_purchase_data/item_data/items/commodity_code` list-of-types was widened by adding types `integer` to media type `application/json`
  - request property `oneOf[subschema #18: Transfer - Level 3 Processing]/additional_purchase_data/item_data/items/commodity_code` list-of-types was widened by adding types `integer` to media type `application/json`
  - request property `oneOf[subschema #2: Transfer - All Fields]/additional_purchase_data/item_data/items/commodity_code` list-of-types was widened by adding types `integer` to media type `application/json`
  - added the optional property `expires_at` to the response with the `201` status
  - added the optional property `processed_at` to the response with the `201` status
- **2026-09-05** `1d6b546b10f2`: 6 breaking, 7 warning, 2 info
  - added `#/components/schemas/tags` to the `oneOf[subschema #22: Transfer - Split Transaction]/split_transfers/allOf[#/components/schemas/split_transfers]/items/tags` request property `allOf` list
  - added `#/components/schemas/tags` to the `oneOf[subschema #2: Transfer - All Fields]/split_transfers/allOf[#/components/schemas/split_transfers]/items/tags` request property `allOf` list
  - the `oneOf[subschema #14: Transfer - Motor Vehicle Rental]/additional_motor_vehicle_rental_data/allOf[#/components/schemas/additional_motor_vehicle_rental_data]/rental_rate` request property type changed from `integer` to `string`
  - the `oneOf[subschema #22: Transfer - Split Transaction]/split_transfers/allOf[#/components/schemas/split_transfers]/items/tags` request property type changed from `object` to no type
  - the `oneOf[subschema #2: Transfer - All Fields]/split_transfers/allOf[#/components/schemas/split_transfers]/items/tags` request property type changed from `object` to no type
  - the `additional_motor_vehicle_rental_data/rental_rate` response's property type changed from `integer` to `string` for status `201`
  - removed the request property `oneOf[subschema #20: Transfer - Recurring or Unscheduled]/credential_on_file/initial_transfer_id`
  - removed the request property `oneOf[subschema #2: Transfer - All Fields]/credential_on_file/initial_transfer_id`
  - added the new `API` enum value to the `created_via` response property for the response status `201`
  - added the new `PULL_FROM_ACH` enum value to the `operation_key` response property for the response status `201`
  - added the new `PULL_FROM_SAME_DAY_ACH` enum value to the `operation_key` response property for the response status `201`
  - added the new `PUSH_TO_ACH` enum value to the `operation_key` response property for the response status `201`
  - added the new `PUSH_TO_SAME_DAY_ACH` enum value to the `operation_key` response property for the response status `201`
  - the request property `oneOf[subschema #22: Transfer - Split Transaction]/split_transfers/allOf[#/components/schemas/split_transfers]/items/fee` became nullable
  - the request property `oneOf[subschema #2: Transfer - All Fields]/split_transfers/allOf[#/components/schemas/split_transfers]/items/fee` became nullable
- **2026-09-02** `3ada948cf2c5`: 4 breaking, 2 info
  - the request property `oneOf[subschema #2: Transfer - All Fields]/receipt_options/additional_details/items/name` became required
  - the request property `oneOf[subschema #2: Transfer - All Fields]/receipt_options/additional_details/items/value` became required
  - the request property `oneOf[subschema #8: Transfer - Card Present]/receipt_options/additional_details/items/name` became required
  - the request property `oneOf[subschema #8: Transfer - Card Present]/receipt_options/additional_details/items/value` became required
  - the request property `oneOf[subschema #2: Transfer - All Fields]/receipt_options/additional_details` became nullable
  - the request property `oneOf[subschema #8: Transfer - Card Present]/receipt_options/additional_details` became nullable
- **2026-08-29** `0cf4cdf27361`: 5 breaking
  - the response property `card_present_details/emv_data/application_identifier` became nullable for the status `201`
  - the response property `card_present_details/emv_data/application_label` became nullable for the status `201`
  - the response property `card_present_details/emv_data/application_transaction_counter` became nullable for the status `201`
  - the response property `card_present_details/emv_data/cryptogram` became nullable for the status `201`
  - the response property `card_present_details/payment_type` became nullable for the status `201`
- **2026-08-25** `9db82db717c5`: 4 info
  - added the new optional request property `oneOf[subschema #14: Transfer - Motor Vehicle Rental]/additional_motor_vehicle_rental_data/allOf[#/components/schemas/additional_motor_vehicle_rental_data]/rental_rate`
  - added the new optional request property `oneOf[subschema #14: Transfer - Motor Vehicle Rental]/additional_motor_vehicle_rental_data/allOf[#/components/schemas/additional_motor_vehicle_rental_data]/renter_name`
  - added the optional property `additional_motor_vehicle_rental_data/rental_rate` to the response with the `201` status
  - added the optional property `additional_motor_vehicle_rental_data/renter_name` to the response with the `201` status
- **2026-08-22** `7919e33b4853`: 10 breaking, 42 info
  - the response property `additional_purchase_data/customs_duty_amount` became nullable for the status `201`
  - the response property `additional_purchase_data/destination_country_code` became nullable for the status `201`
  - the response property `additional_purchase_data/destination_postal_code` became nullable for the status `201`
  - the response property `additional_purchase_data/discount_amount` became nullable for the status `201`
  - the response property `additional_purchase_data/invoice_reference_number` became nullable for the status `201`
  - the response property `additional_purchase_data/order_date` became nullable for the status `201`
  - the response property `additional_purchase_data/sales_tax` became nullable for the status `201`
  - the response property `additional_purchase_data/ship_from_postal_code` became nullable for the status `201`
  - the response property `additional_purchase_data/shipping_amount` became nullable for the status `201`
  - the `additional_purchase_data/item_data/items/quantity` response's property format changed from `decimal` to no format for status `201`
  - added the new optional request property `oneOf[subschema #17: Transfer - Level 2 Processing]/additional_purchase_data/item_data/items/sales_tax_amount`
  - added the new optional request property `oneOf[subschema #17: Transfer - Level 2 Processing]/additional_purchase_data/item_data/items/sales_tax_rate`
  - added the new optional request property `oneOf[subschema #18: Transfer - Level 3 Processing]/additional_purchase_data/item_data/items/sales_tax_amount`
  - added the new optional request property `oneOf[subschema #18: Transfer - Level 3 Processing]/additional_purchase_data/item_data/items/sales_tax_rate`
  - added the new optional request property `oneOf[subschema #2: Transfer - All Fields]/additional_purchase_data/item_data/items/sales_tax_amount`
  - added the new optional request property `oneOf[subschema #2: Transfer - All Fields]/additional_purchase_data/item_data/items/sales_tax_rate`
  - added the new optional request property `oneOf[subschema #2: Transfer - All Fields]/receipt_options/items/items/item_details`
  - added the new optional request property `oneOf[subschema #8: Transfer - Card Present]/receipt_options/items/items/item_details`
  - the request property `oneOf[subschema #17: Transfer - Level 2 Processing]/additional_purchase_data/customs_duty_amount` became nullable
  - the request property `oneOf[subschema #17: Transfer - Level 2 Processing]/additional_purchase_data/destination_country_code` became nullable
  - the request property `oneOf[subschema #17: Transfer - Level 2 Processing]/additional_purchase_data/destination_postal_code` became nullable
  - the request property `oneOf[subschema #17: Transfer - Level 2 Processing]/additional_purchase_data/discount_amount` became nullable
  - the request property `oneOf[subschema #17: Transfer - Level 2 Processing]/additional_purchase_data/invoice_reference_number` became nullable
  - the request property `oneOf[subschema #17: Transfer - Level 2 Processing]/additional_purchase_data/order_date` became nullable
  - the request property `oneOf[subschema #17: Transfer - Level 2 Processing]/additional_purchase_data/sales_tax` became nullable
  - the request property `oneOf[subschema #17: Transfer - Level 2 Processing]/additional_purchase_data/ship_from_postal_code` became nullable
  - the request property `oneOf[subschema #17: Transfer - Level 2 Processing]/additional_purchase_data/shipping_amount` became nullable
  - the request property `oneOf[subschema #18: Transfer - Level 3 Processing]/additional_purchase_data/customs_duty_amount` became nullable
  - the request property `oneOf[subschema #18: Transfer - Level 3 Processing]/additional_purchase_data/destination_country_code` became nullable
  - the request property `oneOf[subschema #18: Transfer - Level 3 Processing]/additional_purchase_data/destination_postal_code` became nullable
  - the request property `oneOf[subschema #18: Transfer - Level 3 Processing]/additional_purchase_data/discount_amount` became nullable
  - the request property `oneOf[subschema #18: Transfer - Level 3 Processing]/additional_purchase_data/invoice_reference_number` became nullable
  - the request property `oneOf[subschema #18: Transfer - Level 3 Processing]/additional_purchase_data/order_date` became nullable
  - the request property `oneOf[subschema #18: Transfer - Level 3 Processing]/additional_purchase_data/sales_tax` became nullable
  - the request property `oneOf[subschema #18: Transfer - Level 3 Processing]/additional_purchase_data/ship_from_postal_code` became nullable
  - the request property `oneOf[subschema #18: Transfer - Level 3 Processing]/additional_purchase_data/shipping_amount` became nullable
  - the request property `oneOf[subschema #2: Transfer - All Fields]/additional_purchase_data/customs_duty_amount` became nullable
  - the request property `oneOf[subschema #2: Transfer - All Fields]/additional_purchase_data/destination_country_code` became nullable
  - the request property `oneOf[subschema #2: Transfer - All Fields]/additional_purchase_data/destination_postal_code` became nullable
  - the request property `oneOf[subschema #2: Transfer - All Fields]/additional_purchase_data/discount_amount` became nullable
  - …12 more
- **2026-08-21** `96653f0c196b`: 2 breaking, 5 info
  - the response property `network_details` became nullable for the status `201`
  - the response property `security_code_verification` became nullable for the status `201`
  - added the optional property `additional_lodging_data` to the response with the `201` status
  - added the optional property `additional_motor_vehicle_rental_data` to the response with the `201` status
  - added the optional property `card_present_details/digital_signature_file_id` to the response with the `201` status
  - added the optional property `card_present_details/emv_data/network_emv_response` to the response with the `201` status
  - added the optional property `messages` to the response with the `201` status
- **2026-08-08** `5426f6f99c52`: 1 breaking
  - the `oneOf[subschema #2: Transfer - All Fields]/statement_descriptor` request property's maxLength was decreased to `20`

---

[Operation](https://skmtc.dev/finix/apis/finix-api-reference/docs/transfers/post.md) - [API](https://skmtc.dev/finix/apis/finix-api-reference.md) - [Page](https://skmtc.dev/finix/apis/finix-api-reference/changes/transfers/post)
