---
title: "Changes to Create Payment"
method: POST
path: "/payments"
---

# Changes to Create Payment

`POST /payments`

> Every recorded change to this endpoint, newest first.
> 74 revisions in range; 1 not diffed.

## Timeline

Changed in 28 of 74 revisions.

- **2026-09-25** `86b97292852d` — 1 warning
- **2026-09-24** `7fcefabddb0a` — 1 warning
- **2026-09-23** `140d015b9966` — 1 breaking, 4 info
- **2026-09-21** `ac2b9b1c6a00` — 1 info
- **2026-09-17** `076176906e3f` — 2 info
- **2026-09-17** `ef86d14ef691` — 1 warning, 1 info
- **2026-09-16** `ff3a76573563` — 2 info
- **2026-09-15** `c19acf2e2548` — 2 warning, 1 info
- **2026-09-09** `18cde81b6763` — 2 info
- **2026-09-09** `5fa504e78695` — 1 info
- **2026-09-05** `2fa9dfe9535a` — 5 warning
- **2026-09-04** `8473fa1d1f47` — 3 warning
- **2026-09-03** `697924df40d1` — 4 breaking, 4 warning, 27 info
- **2026-08-29** `1b5d50d09479` — 1 info
- **2026-08-28** `4da7133b2de7` — 4 warning
- **2026-08-27** `16c82685be35` — 2 warning, 4 info
- **2026-08-26** `86d0a97abfe5` — 10 warning
- **2026-08-21** `715c4defcbbf` — 63 breaking, 1 info
- **2026-08-20** `6a23760847c8` — 1 info
- **2026-08-19** `23dfbe1a0d1f` — 4 warning
- **2026-08-18** `f67a043e3190` — 1 info
- **2026-08-11** `a01100378e59` — 1 info
- **2026-08-05** `6c970f803b46` — 3 info
- **2026-08-04** `ca841fbd6786` — 3 info
- **2026-08-04** `bdd0e2c70d58` — 1 breaking, 1 info
- **2026-07-31** `099fdc3be422` — 1 info
- **2026-07-26** `60bbb4a6ffbc` — 2 warning, 1 info
- **2026-07-14** `3a06a605784b` — 1 info

## Changes

- **2026-09-25** `86b97292852d` — 1 warning
  - added the new `alipayhk` enum value to the `payment_method_type/oneOf[#/components/schemas/PaymentMethodTypes]/` response property for the response status `201`
- **2026-09-24** `7fcefabddb0a` — 1 warning
  - added the new `tabby` enum value to the `payment_method_type/oneOf[#/components/schemas/PaymentMethodTypes]/` response property for the response status `201`
- **2026-09-23** `140d015b9966` — 1 breaking, 4 info
  - the response property `payment_instrument/oneOf[#/components/schemas/PaymentInstrument]/card/oneOf[#/components/schemas/PaymentInstrumentCard]/brand` became nullable for the status `201`
  - added the required property `holds` to the response with the `201` status
  - added the required property `payment_instrument/oneOf[#/components/schemas/PaymentInstrument]/card/oneOf[#/components/schemas/PaymentInstrumentCard]/exp_month` to the response with the `201` status
  - added the required property `payment_instrument/oneOf[#/components/schemas/PaymentInstrument]/card/oneOf[#/components/schemas/PaymentInstrumentCard]/exp_year` to the response with the `201` status
  - added the required property `verification_checks/oneOf[#/components/schemas/PaymentVerificationChecks]/authorization_code` to the response with the `201` status
- **2026-09-21** `ac2b9b1c6a00` — 1 info
  - added the new optional request property `shipping_address`
- **2026-09-17** `076176906e3f` — 2 info
  - added the new optional request property `line_items`
  - added the required property `line_items` to the response with the `201` status
- **2026-09-17** `ef86d14ef691` — 1 warning, 1 info
  - added the new `review` enum value to the `payment_rule_matches/items/action` response property for the response status `201`
  - added the new optional request property `auto_capture_after_minutes`
- **2026-09-16** `ff3a76573563` — 2 info
  - response property `risk_signals` deprecated
  - added the required property `payment_rule_matches` to the response with the `201` status
- **2026-09-15** `c19acf2e2548` — 2 warning, 1 info
  - added the new `blocked` enum value to the `substatus` response property for the response status `201`
  - added the new `touch_n_go` enum value to the `payment_method_type/oneOf[#/components/schemas/PaymentMethodTypes]/` response property for the response status `201`
  - removed the `bizum` enum value from the `payment_method_type/oneOf[#/components/schemas/PaymentMethodTypes]/` response property for the response status `201`
- **2026-09-09** `18cde81b6763` — 2 info
  - added the new optional request property `statement_descriptor`
  - added the required property `payment_instrument/oneOf[#/components/schemas/PaymentInstrument]/card/oneOf[#/components/schemas/PaymentInstrumentCard]/issuer_identification_number` to the response with the `201` status
- **2026-09-09** `5fa504e78695` — 1 info
  - added the required property `recovery_url` to the response with the `201` status
- **2026-09-05** `2fa9dfe9535a` — 5 warning
  - added the new `mercado_pago_ar` enum value to the `payment_method_type/oneOf[#/components/schemas/PaymentMethodTypes]/` response property for the response status `201`
  - added the new `mercado_pago_mx` enum value to the `payment_method_type/oneOf[#/components/schemas/PaymentMethodTypes]/` response property for the response status `201`
  - added the new `nupay` enum value to the `payment_method_type/oneOf[#/components/schemas/PaymentMethodTypes]/` response property for the response status `201`
  - added the new `opay` enum value to the `payment_method_type/oneOf[#/components/schemas/PaymentMethodTypes]/` response property for the response status `201`
  - added the new `verve` enum value to the `payment_method_type/oneOf[#/components/schemas/PaymentMethodTypes]/` response property for the response status `201`
- **2026-09-04** `8473fa1d1f47` — 3 warning
  - added the new `oney` enum value to the `payment_method_type/oneOf[#/components/schemas/PaymentMethodTypes]/` response property for the response status `201`
  - added the new `oney_3x` enum value to the `payment_method_type/oneOf[#/components/schemas/PaymentMethodTypes]/` response property for the response status `201`
  - added the new `oney_4x` enum value to the `payment_method_type/oneOf[#/components/schemas/PaymentMethodTypes]/` response property for the response status `201`
- **2026-09-03** `697924df40d1` — 4 breaking, 4 warning, 27 info
  - added the new required request property `account_id`
  - added the new required request property `plan_id`
  - removed `subschema #1: CreatePaymentInputWithPlanAndConfirmationToken, subschema #2: CreatePaymentInputWithPlanAndMemberId, subschema #3: CreatePaymentInputWithPlanIdAndConfirmationToken, subschema #4: CreatePaymentInputWithPlanIdAndMemberId` from the request body `oneOf` list
  - removed the success response with the status `200`
  - removed the optional property `error/param` from the response with the `400` status
  - removed the optional property `error/param` from the response with the `401` status
  - removed the optional property `error/param` from the response with the `403` status
  - removed the optional property `error/param` from the response with the `404` status
  - the security scope `access_pass:basic:read` was removed from the endpoint's security scheme `bearerAuth`
  - the security scope `access_pass:create` was removed from the endpoint's security scheme `bearerAuth`
  - the security scope `access_pass:update` was removed from the endpoint's security scheme `bearerAuth`
  - the security scope `member:basic:read` was removed from the endpoint's security scheme `bearerAuth`
  - the security scope `member:email:read` was removed from the endpoint's security scheme `bearerAuth`
  - the security scope `member:phone:read` was removed from the endpoint's security scheme `bearerAuth`
  - the security scope `payment:dispute:read` was removed from the endpoint's security scheme `bearerAuth`
  - the security scope `payment:resolution_center_case:read` was removed from the endpoint's security scheme `bearerAuth`
  - the security scope `plan:basic:read` was removed from the endpoint's security scheme `bearerAuth`
  - the security scope `plan:create` was removed from the endpoint's security scheme `bearerAuth`
  - the security scope `promo_code:basic:read` was removed from the endpoint's security scheme `bearerAuth`
  - the security scope `shipment:basic:read` was removed from the endpoint's security scheme `bearerAuth`
  - added the new optional `header` request parameter `Api-Version-Date` to all path's operations
  - added the new optional `header` request parameter `Idempotency-Key`
  - added the new optional request property `capture`
  - added the new optional request property `confirmation_token`
  - added the new optional request property `email`
  - added the new optional request property `member_id`
  - added the new optional request property `metadata`
  - added the new optional request property `payment_method_id`
  - added the new optional request property `promo_code_id`
  - added the new optional request property `return_url`
  - added the non-success response with the status `409`
  - removed the non-success response with the status `422`
  - removed the non-success response with the status `429`
  - removed the non-success response with the status `500`
  - added the success response with the status `201`
- **2026-08-29** `1b5d50d09479` — 1 info
  - added the required property `allOf[#/components/schemas/Payment]/fees` to the response with the `200` status
- **2026-08-28** `4da7133b2de7` — 4 warning
  - added the new `flex_pay` enum value to the `allOf[#/components/schemas/Payment]/payment_method/payment_method_type` response property for the response status `200`
  - added the new `flex_pay` enum value to the `allOf[#/components/schemas/Payment]/payment_method_type/oneOf[#/components/schemas/PaymentMethodTypes]/` response property for the response status `200`
  - added the new `gcash` enum value to the `allOf[#/components/schemas/Payment]/payment_method/payment_method_type` response property for the response status `200`
  - added the new `gcash` enum value to the `allOf[#/components/schemas/Payment]/payment_method_type/oneOf[#/components/schemas/PaymentMethodTypes]/` response property for the response status `200`
- **2026-08-27** `16c82685be35` — 2 warning, 4 info
  - added the new `authorized` enum value to the `allOf[#/components/schemas/Payment]/status/oneOf[#/components/schemas/ReceiptStatus]/` response property for the response status `200`
  - added the new `requires_capture` enum value to the `allOf[#/components/schemas/Payment]/substatus` response property for the response status `200`
  - added the new optional request property `oneOf[subschema #1: CreatePaymentInputWithPlanAndConfirmationToken]/capture`
  - added the new optional request property `oneOf[subschema #2: CreatePaymentInputWithPlanAndMemberId]/capture`
  - added the new optional request property `oneOf[subschema #3: CreatePaymentInputWithPlanIdAndConfirmationToken]/capture`
  - added the new optional request property `oneOf[subschema #4: CreatePaymentInputWithPlanIdAndMemberId]/capture`
- **2026-08-26** `86d0a97abfe5` — 10 warning
  - added the new `accel` enum value to the `allOf[#/components/schemas/Payment]/card_brand/oneOf[#/components/schemas/CardBrands]/` response property for the response status `200`
  - added the new `accel` enum value to the `allOf[#/components/schemas/Payment]/payment_method/card/brand/oneOf[#/components/schemas/CardBrands]/` response property for the response status `200`
  - added the new `culiance` enum value to the `allOf[#/components/schemas/Payment]/card_brand/oneOf[#/components/schemas/CardBrands]/` response property for the response status `200`
  - added the new `culiance` enum value to the `allOf[#/components/schemas/Payment]/payment_method/card/brand/oneOf[#/components/schemas/CardBrands]/` response property for the response status `200`
  - added the new `nyce` enum value to the `allOf[#/components/schemas/Payment]/card_brand/oneOf[#/components/schemas/CardBrands]/` response property for the response status `200`
  - added the new `nyce` enum value to the `allOf[#/components/schemas/Payment]/payment_method/card/brand/oneOf[#/components/schemas/CardBrands]/` response property for the response status `200`
  - added the new `pulse` enum value to the `allOf[#/components/schemas/Payment]/card_brand/oneOf[#/components/schemas/CardBrands]/` response property for the response status `200`
  - added the new `pulse` enum value to the `allOf[#/components/schemas/Payment]/payment_method/card/brand/oneOf[#/components/schemas/CardBrands]/` response property for the response status `200`
  - added the new `star` enum value to the `allOf[#/components/schemas/Payment]/card_brand/oneOf[#/components/schemas/CardBrands]/` response property for the response status `200`
  - added the new `star` enum value to the `allOf[#/components/schemas/Payment]/payment_method/card/brand/oneOf[#/components/schemas/CardBrands]/` response property for the response status `200`
- **2026-08-21** `715c4defcbbf` — 63 breaking, 1 info
  - the response's body type changed from `object` to no type for status `200`
  - removed the required property `amount_after_fees` from the response with the `200` status
  - removed the required property `application_fee` from the response with the `200` status
  - removed the required property `auto_refunded` from the response with the `200` status
  - removed the required property `billing_address` from the response with the `200` status
  - removed the required property `billing_reason` from the response with the `200` status
  - removed the required property `card_brand` from the response with the `200` status
  - removed the required property `card_exp_month` from the response with the `200` status
  - removed the required property `card_exp_year` from the response with the `200` status
  - removed the required property `card_last4` from the response with the `200` status
  - removed the required property `checkout_configuration_id` from the response with the `200` status
  - removed the required property `company` from the response with the `200` status
  - removed the required property `created_at` from the response with the `200` status
  - removed the required property `currency` from the response with the `200` status
  - removed the required property `customer_phone` from the response with the `200` status
  - removed the required property `decline_code` from the response with the `200` status
  - removed the required property `dispute_alerted_at` from the response with the `200` status
  - removed the required property `disputes` from the response with the `200` status
  - removed the required property `failure_message` from the response with the `200` status
  - removed the required property `financing_installments_count` from the response with the `200` status
  - removed the required property `financing_transactions` from the response with the `200` status
  - removed the required property `id` from the response with the `200` status
  - removed the required property `last_payment_attempt` from the response with the `200` status
  - removed the required property `member` from the response with the `200` status
  - removed the required property `membership` from the response with the `200` status
  - removed the required property `metadata` from the response with the `200` status
  - removed the required property `needs_tracking` from the response with the `200` status
  - removed the required property `next_payment_attempt` from the response with the `200` status
  - removed the required property `paid_at` from the response with the `200` status
  - removed the required property `payment_instrument` from the response with the `200` status
  - removed the required property `payment_method` from the response with the `200` status
  - removed the required property `payment_method_type` from the response with the `200` status
  - removed the required property `payments_failed` from the response with the `200` status
  - removed the required property `plan` from the response with the `200` status
  - removed the required property `product` from the response with the `200` status
  - removed the required property `promo_code` from the response with the `200` status
  - removed the required property `refundable` from the response with the `200` status
  - removed the required property `refunded_amount` from the response with the `200` status
  - removed the required property `refunded_at` from the response with the `200` status
  - removed the required property `refunds` from the response with the `200` status
  - …24 more
- **2026-08-20** `6a23760847c8` — 1 info
  - added the required property `payment_method/card/fingerprint` to the response with the `200` status
- **2026-08-19** `23dfbe1a0d1f` — 4 warning
  - added the new `modo` enum value to the `payment_method/payment_method_type` response property for the response status `200`
  - added the new `modo` enum value to the `payment_method_type/oneOf[#/components/schemas/PaymentMethodTypes]/` response property for the response status `200`
  - added the new `rapipago` enum value to the `payment_method/payment_method_type` response property for the response status `200`
  - added the new `rapipago` enum value to the `payment_method_type/oneOf[#/components/schemas/PaymentMethodTypes]/` response property for the response status `200`
- **2026-08-18** `f67a043e3190` — 1 info
  - added the required property `payment_instrument` to the response with the `200` status
- **2026-08-11** `a01100378e59` — 1 info
  - added the required property `verification_checks` to the response with the `200` status
- **2026-08-05** `6c970f803b46` — 3 info
  - added the required property `card_exp_month` to the response with the `200` status
  - added the required property `card_exp_year` to the response with the `200` status
  - added the required property `decline_code` to the response with the `200` status
- **2026-08-04** `ca841fbd6786` — 3 info
  - the security scope `shipment:basic:read` was added to the endpoint's security scheme `bearerAuth`
  - added the required property `needs_tracking` to the response with the `200` status
  - added the required property `shipment` to the response with the `200` status
- **2026-08-04** `bdd0e2c70d58` — 1 breaking, 1 info
  - removed `subschema #1: CreatePaymentInputWithPlan, subschema #2: CreatePaymentInputWithPlanId` from the request body `oneOf` list
  - added `subschema #1: CreatePaymentInputWithPlanAndConfirmationToken, subschema #2: CreatePaymentInputWithPlanAndMemberId, subschema #3: CreatePaymentInputWithPlanIdAndConfirmationToken, subschema #4: CreatePaymentInputWithPlanIdAndMemberId` to the request body `oneOf` list
- **2026-07-31** `099fdc3be422` — 1 info
  - added the required property `settlement_time_at` to the response with the `200` status
- **2026-07-26** `60bbb4a6ffbc` — 2 warning, 1 info
  - added the new `bank_wire` enum value to the `payment_method/payment_method_type` response property for the response status `200`
  - added the new `bank_wire` enum value to the `payment_method_type/oneOf[#/components/schemas/PaymentMethodTypes]/` response property for the response status `200`
  - added the required property `customer_phone` to the response with the `200` status
- **2026-07-14** `3a06a605784b` — 1 info
  - added the required property `refunds` to the response with the `200` status

---

[Operation](https://skmtc.dev/whop/apis/whop-api/docs/payments/post.md) · [API](https://skmtc.dev/whop/apis/whop-api.md) · [Page](https://skmtc.dev/whop/apis/whop-api/changes/payments/post)
